# 新卡冊
[Adobe XD](https://xd.adobe.com/view/450346df-11b1-42b2-707f-7e3ffb8ccdfd-3332/grid)
[新卡冊分工列表](https://hackmd.io/fyJBDVEQSf2geugjwZNVpA)
## 事項
- 主畫面 6D
- 各跳框 4D
- Wild畫面 3D
- 整合 3D
## 20200623
- 新卡冊主畫面
- 新卡冊主題過場畫面
- 新卡冊主題畫面(原有)
- 新卡包
- 加lucky卡和wild卡(卡片框)
- 送卡包給玩家到道具包(除了wild卡)
- 新wild卡畫面
- 隨機spin
- 普通卡&金卡
- lucky卡
- 每日簽到(1星)
- 獲得xx點皇冠點數(2星)
- 獲得VIP聽pass(4星)
- 完成中等難度以上的地圖(4星)
- 完成皇冠通行證(5星)
- 完成困難難度的地圖(5星)
- 得到wild卡開wild卡選擇畫面
- 開卡冊,如果有wild卡, wild卡選擇畫面會卡流程, 如果被關掉, 卡冊也會一起被關掉
- wild卡選擇畫面要可以過濾沒有拿過的卡的選擇
- 卡冊畫面伸縮式menu欄
- ~~卡冊title欄右下時間顯示只在小於12天才做顯示, 最小單位為天~~
- 伸縮menu上面如果還沒完成收集, 顯示"<已收集卡種類數>/<總卡種類數>" ; 如已收集完畢,顯示"完成"
- 金卡以上不能交換(原有機制)

## 20200623
- 新卡冊只用新卡冊api, 舊api放著不用
- 卡片來源用新來源編號

    // 外部統一資料來源 由 2001 開始編碼
    // 營運活動給獎
    const int RecordSourceTypeDto_External_OPReward = 2001;
    // 每日任務
    const int RecordSourceTypeDto_External_DailyMission = 2002;
    // 特殊任務
    const int RecordSourceTypeDto_External_SpecialMission = 2003;
    // 一般給獎
    const int RecordSourceTypeDto_External_AwardSetting = 2004;
    // 每日簽到
    const int RecordSourceTypeDto_External_DailyBonus = 2005;
    // 領取免費幣
    const int RecordSourceTypeDto_External_FreeCoin = 2006;
    // VIP大廳-溢點獎勵
    const int RecordSourceTypeDto_External_LoungePointOverReward = 2007;
    // 道具系統-背包使用道具
    const int RecordSourceTypeDto_External_BackpackItemUse = 2008;
    // 新商城系統-一般儲值
    const int RecordSourceTypeDto_External_GenericStore = 2009;

- 小主題內容畫面"x"隱藏, 只允許返回到主題選擇畫面
- 卡冊開寶箱畫面的寶箱圖會更新(動畫?)
- 卡包會存入道具系統
- 俱樂部要卡送卡流程照舊

## 20200629
- 先設計可換季功能和圖片集
- lucky卡只能在特定的管道取得:
- 每日簽到(1星)
- 獲得xx點皇冠點數(2星)
- 獲得VIP聽pass(4星)
- 完成中等難度以上的地圖(4星)
- 完成皇冠通行證(5星)
- 完成困難難度的地圖(5星)
- wild卡會在商城裡當其中一個品相來賣給玩家
- 卡冊title欄下時間顯示只在小於12天才做顯示, 小於1天換成==時:分:秒==顯示

## 20200630
- 過場動畫如果美術有做就加下去, 沒有就放棄
- 得到wild卡會主動開選擇卡片畫面, 時間顯示為wild卡剩餘時間, 如果遊戲正在進行中, 要卡遊戲流程
- 沒有選擇wild卡的情況下關閉wild卡畫面會彈出確認框, 時間顯示為wild卡剩餘時間
- 營運的美術圖最晚預計==8/6==前回來
- 美術欠圖:
1. wild卡包道具icon - 2/7/2020
2. 卡冊說明頁更新 - 3/7/2020
3. 得到wild卡動畫 - 6/7/2020
4. 得到卡包動畫 - 9/7/2020
5. 得到lucky卡動畫 - 9/7/2020
6. 新卡框 - 9/7/2020
7. 新卡片樣式名字框太短, 沒有考慮到英文名字長度問題 - 9/7/2020
8. wild卡ui + 被選擇的卡黃框 - 13/7/2020
- 主題資源是否放在大廳資源, 還是走下載?
- 要討論之後把主題資源都放到大廳時的資料格式, 規則等事項
- 歷史記錄cell過長, 需要調

## 20200701
- 客端自己處理IsNew的卡(local sqlite處理)
- server會推播4個s2c給客端
1. 登入通知客端玩家目前卡量和相關資訊
2. 通知客端玩家獲得卡片
3. 通知客端強制刷新卡冊資料
4. 通知客端玩家得到wild卡
- 獲得卡包會通過itemSystem的api給玩家
- 玩家在道具包使用卡包成功後server會用新卡冊s2c通知獲得卡片
- 主題資源確定都直接放在大廳, 不走下載, 客端和server會用卡冊id, 主題id和卡id來溝通
- spin到組合包流程
1. spin到組合包
~~1. s2c(itemSystem)通知領組合包~~
~~2. 檢查組合QueryItems(itemSystem)包開獎方式~~
~~3. 是spin獎勵就直接自動使用組合包~~
5. 組合包結算畫面
6. 組合包結算內容有卡包時再播得到卡包動畫
7. 卡包結算畫面
- 得到wild卡流程
1. 購買獲得wild卡
2. s2c(itemSystem)獲得wild卡, 播wild卡進場動畫
3. wild卡選擇畫面, 確定使用選擇的卡片後用道具useItem(itemSystem)的api通知server加入卡片(useItem的api會微調)
4. wild卡結算畫面(用卡的來源來決定結算方式 - 新)
- 會針對兩種得到卡片的流程新增兩種開組合包的type
- 商城購買獲得wild卡, 開wild卡ui時需要卡遊戲流程
- wild卡動畫只會在獲得的時候播一次, 之後從卡冊畫面進去的wild卡ui都不會再出現(新得到的除外)
- 孟孝要求從大廳進卡冊時要有過場動畫, 美術和RD目前都沒有編排這個動畫的時間, 暫時不做, 直接開卡冊ui

## 20200702
- 卡冊說明跳框高機會需要新增頁面, 確定更新資料和圖片
- 在主題卡片也左右切換主題時下面書本動畫會跟著翻頁
- 開寶箱裡的獎勵node客端自己排和自己調演出時間
- 開卡包的卡片位址由客端來算, 加播動畫
- 新得到的卡片會有新效果, 或是動畫

## 20200703
~~- 不同遊戲會有分別不同的押註群組和押註獎勵組合包~~
- 所有遊戲都吃同一組spin押註群, 附加各押註群會得到的獎勵
- spin押註群會比原本的4筆資料在多出兩筆, ui不必變動, 那兩筆會被包裝成隱藏獎勵
- spin押註群會被拆分成新一個獨立的api組, 會有自己的結束時間, 時間到時客端需要再跟server索取新的spin押註群資料和獎勵
- 新得到的卡片做掃光處理

## 20200706
- spin獎勵會丟組合包(已知)
- 主題完成獎勵目前先給金幣獎勵, 但是之後會用組合包獎勵給獎
~~- 卡冊ID命名格式為 `<4碼年>_<1碼季>_<2碼主題數>_<1碼主題張數, 目前規定只可以9張>`
例子:2020_1_18_9~~
- 卡片IsNew目前規劃先讓客端處理, 但是如果來不及的話需要提早告訴server把IsNew在server處理掉

## 20200707
- wild卡畫面的時間倒數顯示格式為`hh:mm:ss`, 而大於1天需顯示為`n天`
- 新卡冊獲得組合包s2c會從itemSystem抽出來放到新卡冊的api去, 還是會需要發送使用組合包的資料給server, 可是是通過新卡冊那裡新開的使用組合包api來做使用
- 在玩家離線前沒有開獎的組合包會在玩家下一次登入時用小秘書的方式送給玩家, 玩家需要點`領取`來獲得獎勵, 獎勵內容會直接在小秘書內容獲得, 領取成功後用通行證獎勵畫面來顯示玩家獲得獎勵, 泡泡框顯示內容只會有紅色的泡泡框名字, 到期時間和對應的寶箱icon(第5和6級獎勵使用鑽石寶箱來代替), 黑色內容會直接隱藏不顯示

## 20200709
- 在wild卡畫面選擇卡片後又左右換主題會把已選擇的卡片取消選擇
- 在wild卡畫面選擇已經擁有的卡片後又把"只顯示我沒有的卡片"開啟會把已選擇的卡片取消, 至於被選擇的卡片是沒有得到過的卡片, "只顯示我沒有的卡片"被開啟也會保留選擇
- 卡冊ID命名格式為 `<4碼年><2碼季,0頭><2碼主題數,0頭><1碼主題張數, 目前規定只可以9張,0頭>`
例子:2020011809

## 20200713
- server不會主動s2c給我們資料, 客端登入後需要先跟server要一次資料, 資料會包括每一張卡片的名字
- [新卡冊圖片規格](https://hackmd.io/S2rLlJ53RXWkt_f68E6BOA)
- 舊機制沿用, 新卡冊需要實作起來:
- 新季度第一次開卡冊會需要跳說明
- 新季度第一次開卡冊需要送玩家第一次開卡
- 俱樂部要卡流程
- 俱樂部送卡流程
- 主題完成獎勵畫面
- 卡冊空擋時期不行開寶箱(小秘書領獎)

## 20200714
- 卡冊卡片不會用通用格式來傳資料給客端, 除非是wild卡換卡或是之後再商場直接賣卡才會用通用格式來傳資料
- 卡冊發送管道
1. SPIN隨機獲得
1. Api 直接給獎
2. 【後台D01 一般給獎】
2. 【後台D28 新商城優惠】
2. 【後台C17 道具設定】
2. 【後台D29 組合包設定】
3. 【後台D27 地圖任務設定】
4. 【後台D26 通行證設定】
5. 【後台D15 每日簽到】
6. 【後台D21 客製化付費】
- 開wild動畫目前會有跟其他跳框撞到的疑慮, 所以目前取消自動開wild卡動畫這段

## 20200717
- 開wild卡畫面要卡遊戲流程
- 遊戲正在轉時道具包無法使用wild卡道具

## 20200727
- GetCardAlbumById可以獲取任何一個卡冊的資料

  export type GetCardAlbumById_Input = {
    AlbumIdOrEmpty: string | "";
  }

- GetCurrentCardAlbum取目前正在進行中的卡冊資料
- 考慮server效能問題, 新api沒有查詢各主題的api, 資料在去卡冊資料是就已經給了, 客端自己處理各主題資料, 但是會有資料量太大的疑慮
- wild卡的所接收的資料,會包含可選擇的卡片資料,客端在對其做篩選即可

## 20200728
- 開寶箱獎勵icon需要放大
- 開卡包動畫重弄, 卡片需要放大重排
- 卡包獎勵icon的星等換成最高星等
- 刪除寶箱和卡包的內容數量
- wild卡界面打掉重新換ui重弄, 換成上下滑動選主題方式