整合需求

本節將說明如何整合遊戲角落與 YouTube 遊戲角落 SDK。

1 載入 Playables SDK

2 遊戲準備就緒通知

  • 遊戲必須在顯示載入畫面或啟動畫面時呼叫 firstFrameReady，明確告知使用者載入程序正在進行中。
  • 遊戲「必須」呼叫 gameReady，且「必須」只在遊戲準備好讓使用者互動時呼叫 gameReady (例如：主選單或遊戲準備好開始玩)。
  • 遊戲不得在向使用者顯示無法互動的元素時 (例如啟動畫面或載入畫面)，呼叫 gameReady。

YouTube 不會移除「載入微調器」，直到呼叫這個 API 為止。

3 個使用者分數

  • 遊戲「可能」會使用 sendScore 傳送使用者的分數。
  • 如果遊戲使用 sendScore 傳送分數，遊戲必須遵守 sendScore 規格，且必須確保傳送的最高分數與遊戲儲存的最高分數相符。

4 個雲端儲存檔

  • 使用者有重大遊戲進展 (例如等級變更) 時，遊戲必須呼叫 saveData 儲存進度，讓使用者相信遊戲機制會儲存進度。
  • 遊戲不得使用任何其他機制儲存使用者進度。這項功能可讓玩家稍後繼續遊戲。
  • 遊戲必須等待 loadData，才能呼叫 saveData。如果在 loadData 成功完成前呼叫 saveData，系統會拒絕要求。這樣遊戲就不會覆寫先前儲存的任何資料。
  • 遊戲必須能使用舊版遊戲的雲端儲存資料，且不會發生錯誤或當機。
  • 遊戲應使用雲端儲存資料，在所有遊戲版本中維持使用者進度，讓使用者在這些版本中都能使用自己的資料。
  • 遊戲應在重要遊戲里程碑自動儲存使用者進度，防止資料遺失。使用者結束遊戲時，系統會執行最終的排清儲存作業，但這項作業盡力而為，且最多只能儲存64 KiB 的內容長度。

5 靜音切換鈕

  • 遊戲必須遵守系統音訊設定和靜音按鈕。
  • 遊戲必須使用 isAudioEnabled 和 onAudioEnabledChange 尊重 YouTube 音訊設定和靜音按鈕。
  • 遊戲必須尊重裝置上的音量控制設定。
  • 遊戲音效不得意外播放。
  • 設定 YouTube 靜音時，不得輸出音訊，且遊戲音訊控制項不得影響音訊輸出。
  • 如果未設定 YouTube 靜音，遊戲音訊控制項可能會影響音訊輸出。
  • 遊戲不應在遊戲中顯示整體靜音按鈕，應讓使用者透過 YouTube 層級的功能進行這項操作。
  • 遊戲可以在遊戲中提供精細音訊控制選項，例如音樂和音效，但必須遵守所有其他音訊控制規定。

背景、特效、對話的音訊設定各不相同

6 暫停及繼續

Playables SDK 提供跨平台暫停和繼續功能的回呼。

  • 呼叫 onPause 後，遊戲必須暫停所有執行作業，且只有在呼叫 onResume 時，才必須恢復執行作業。執行包括所有可玩功能，例如遊戲迴圈、音樂、互動、網路呼叫和算繪。
  • 遊戲不得使用網頁 Page Visibility API 或類似的網頁 API，且只能使用 Playables SDK onPause 和 onResume。
  • 遊戲應在發生 onPause 時儲存使用者進度。