本節將說明如何整合遊戲角落與 YouTube 遊戲角落 SDK。
1 載入 Playables SDK
- 遊戲必須在任何遊戲程式碼之前載入 YouTube 遊戲角落 SDK。
2 遊戲準備就緒通知
- 遊戲必須在顯示載入畫面或啟動畫面時呼叫
firstFrameReady，明確告知使用者載入程序正在進行中。 - 遊戲「必須」呼叫
gameReady，且「必須」只在遊戲準備好讓使用者互動時呼叫gameReady(例如：主選單或遊戲準備好開始玩)。 - 遊戲不得在向使用者顯示無法互動的元素時 (例如啟動畫面或載入畫面)，呼叫
gameReady。
YouTube 不會移除「載入微調器」，直到呼叫這個 API 為止。
3 個使用者分數
4 個雲端儲存檔
- 使用者有重大遊戲進展 (例如等級變更) 時，遊戲必須呼叫
saveData儲存進度，讓使用者相信遊戲機制會儲存進度。 - 遊戲不得使用任何其他機制儲存使用者進度。這項功能可讓玩家稍後繼續遊戲。
- 遊戲必須等待
loadData，才能呼叫saveData。如果在loadData成功完成前呼叫saveData，系統會拒絕要求。這樣遊戲就不會覆寫先前儲存的任何資料。 - 遊戲必須能使用舊版遊戲的雲端儲存資料，且不會發生錯誤或當機。
- 遊戲應使用雲端儲存資料，在所有遊戲版本中維持使用者進度，讓使用者在這些版本中都能使用自己的資料。
- 遊戲應在重要遊戲里程碑自動儲存使用者進度，防止資料遺失。使用者結束遊戲時，系統會執行最終的排清儲存作業，但這項作業盡力而為，且最多只能儲存64 KiB 的內容長度。
5 靜音切換鈕
- 遊戲必須遵守系統音訊設定和靜音按鈕。
- 遊戲必須使用
isAudioEnabled和onAudioEnabledChange尊重 YouTube 音訊設定和靜音按鈕。 - 遊戲必須尊重裝置上的音量控制設定。
- 遊戲音效不得意外播放。
- 設定 YouTube 靜音時，不得輸出音訊，且遊戲音訊控制項不得影響音訊輸出。
- 如果未設定 YouTube 靜音，遊戲音訊控制項可能會影響音訊輸出。
- 遊戲不應在遊戲中顯示整體靜音按鈕，應讓使用者透過 YouTube 層級的功能進行這項操作。
- 遊戲可以在遊戲中提供精細音訊控制選項，例如音樂和音效，但必須遵守所有其他音訊控制規定。
6 暫停及繼續
Playables SDK 提供跨平台暫停和繼續功能的回呼。