整合需求

本節說明遊戲角落與 YouTube 的整合 遊戲角落 SDK

1 個載入遊戲角落 SDK

2 可供遊戲使用的通知

  • 遊戲顯示時,必須呼叫firstFrameReady 明確傳達給使用者的載入畫面或啟動畫面 說明載入程序正在進行中
  • 遊戲必須呼叫 gameReady,而且在出現以下情況時,必須只呼叫 gameReady 遊戲已可供使用者互動 (例如:主選單或遊戲已準備就緒 播放)。
  • 遊戲在仍未互動時,「不得」呼叫 gameReady 向使用者顯示的元素 (例如啟動畫面或載入中) 螢幕)。

YouTube 不會移除「載入中旋轉圖示」直到呼叫此 API 為止

3 個使用者分數

  • 遊戲可以使用 sendScore 傳送使用者的分數。
  • 如果遊戲使用 sendScore 傳送分數,該遊戲必須遵循 sendScore 規格,並必須確保 與遊戲存檔中的最高得分相符。

4 次雲端儲存

  • 遊戲「必須」呼叫 saveData,才能在使用者已執行要求的情況下儲存進度 Material 遊戲進度 (例如改變關卡) 機制會讓使用者相信自己的進度可以儲存。
  • 遊戲「不得」使用任何其他機制儲存使用者進度。這個 功能,讓玩家可以稍後繼續遊戲。
  • 遊戲必須等待loadData,才能呼叫 saveData。如果 系統會在 loadData 成功完成前呼叫 saveData, 則拒絕。這可避免遊戲覆寫任何 先前儲存的資料
  • 這些應用程式版本「必須」可以使用雲端儲存功能, 不會發生錯誤或當機
  • 遊戲「應」使用雲端儲存資料,維持所有使用者的進度 使用者預期會使用其資料的遊戲版本。
  • 遊戲「必須」在重要遊戲中自動儲存使用者進度 避免資料遺失系統會在使用者 會退出遊戲,但最好是在內容中最多節省 64 KiB 長度

5 靜音切換鈕

  • 遊戲「必須」遵循系統音訊設定和靜音按鈕。
  • 遊戲「必須」遵循 YouTube 的音訊設定和靜音按鈕,方法是使用 isAudioEnabledonAudioEnabledChange
  • 遊戲「必須」遵循裝置上的音量控制項。
  • 遊戲音效「不得」意外播放。
  • 設定 YouTube 靜音後,系統「不得」輸出音訊和遊戲音訊 控制項「不得」影響音訊輸出。
  • 在未設定 YouTube 靜音的情況下,遊戲音訊控制選項可能會影響音訊 輸出內容
  • 遊戲「不得」在遊戲中顯示整體靜音按鈕。 但可讓使用者透過 YouTube 層級功能來達成目的
  • 遊戲「可能」在遊戲中設有獨立的精細音訊控制選項,例如: 音樂和音效,但必須遵循所有其他音訊控制選項 Google Cloud 就是最佳選擇

背景、fx、
對話方塊

6 暫停和繼續

Playables SDK 提供的回呼可以跨平台暫停和 重新啟用功能。

  • 在呼叫 onPause 後,遊戲必須暫停所有執行程序,且必須 只有在呼叫 onResume 時才會繼續執行。執行包含全部 遊戲功能,例如遊戲迴圈、音樂、互動、網路 呼叫和轉譯
  • 遊戲「不得」使用 Page Visibility API 或其他類似的網路 API,以及 必須只使用遊戲角落 SDK onPauseonResume
  • 遊戲「必須」onPause 發生時儲存使用者進度。