修訂版本記錄

這個頁面提供了下列文件的修訂版本記錄:

2024 年 7 月 11 日

  • 將技術相關規定重構為多個網頁。
  • 要求清除和簡化需求。

2024 年 6 月 24 日

軟體包總大小限制從 100 MiB 增加到 250 MiB,並新增延遲載入 指引。

2024 年 6 月 17 日

Test Suite 更新:

  • 遊戲不再需要透過 HTTPS 提供,而且可以透過 用於測試的 localhost。
  • 在網址欄位旁邊新增重新整理按鈕,以便重新整理 iframe 內容,但不含 重新載入整個測試套件。

2024 年 5 月 16 日

將設計最佳做法移至其他文件,更具體地說明 與最佳做法相輔相成

2024 年 5 月 8 日

重構遊戲角落開發人員網站,拓展觸及範圍並提升效能 導覽。

2024 年 5 月 7 日

更新「遊戲完備性通知」技術相關規定 firstFrameReady 呼叫的其他詳細資料。

2024 年 5 月 3 日

  • 已建立舊版需求條件的封存檔。

2024 年 3 月 5 日

個別檔案大小的上限已從 10 MiB 增加至 30 MiB。

2024 年 2 月 23 日

在頂層命名空間中加入 IN_PLAYABLES_ENV 布林值,告知開發人員 因為遊戲是在遊戲角落的環境中運作

2023 年 12 月 4 日

測試套件更新

  • 新增檢查檔案名稱中不支援的字元。
  • 新增模擬載入畫面的功能,包括設定初始 將 iframe 高度設為 0。
  • 透過切換鈕更新暫停恢復按鈕,更貼近實際工作環境的需求 播放音訊。
  • 已從事件記錄中移除無法操作的訊息。

2023 年 11 月 10 日

下載的 Test Suite 套件已替換為託管的測試 套件

TypeScript 類型定義檔案 (先前可透過 Test Suite 提供) 已移至主要的 Playables SDK 文章。

2023 年 9 月 7 日

我們已更新「開始使用」部分,為遊戲角落進行變更 從 v0v1 的 SDK 網址。

2023 年 8 月 30 日

檔案名稱縮圖部分新增了 已更新,不再參照明確列出允許的特殊字元 (_-.)。

此外,「Cloud 儲存」部分已更新為 可以使用雲端儲存功能,以便在新的遊戲版本中使用。

2023 年 8 月 25 日

saveData 部分已更新,清楚指出可儲存資料 必須是有效且格式正確的 UTF-16 字串。

2023 年 8 月 18 日

暫停和繼續」專區已更新,清楚說明 遊戲必須在呼叫 onPause 後暫停所有執行作業,並只繼續執行一次 系統已呼叫 onResume

2023 年 8 月 11 日

新增「File Name」部分,其中包含字元 遊戲套件中檔案名稱所使用的限制。

2023 年 8 月 10 日

互動方法一節已更新,為必填 遊戲的 UI 元件可正常運作,且不會出現錯誤。 非預期行為

2023 年 8 月 9 日

新增「縮圖」部分,列出遊戲的 縮圖規定,可讓使用者不費吹灰之力發現 可在 YouTube 上播放。

2023 年 8 月 8 日

更新「手勢和輸入」部分,禁止使用 遊戲,在 Esc 事件中呼叫 preventDefault()

此外,我們新增了檔案參考資料部分,在 遊戲只有在參照套件中的其他檔案時才會使用相對路徑, 使用絕對路徑會導致錯誤發生。

2023 年 8 月 2 日

技術相關規定遊戲角落遊戲設計中的「靜音」部分 我們更新了相關指南,將靜音和取消靜音功能稱為音訊 控制項,以及表示精細音訊控制項可能包含 音量滑桿和/或靜音切換鈕

2023 年 7 月 28 日

遊戲角落遊戲設計指南說明文件已更新 標準化敘述用語,並更新最佳做法和螢幕截圖。

2023 年 7 月 20 日

新增「暫停和繼續」部分 可以跨平台暫停和恢復功能

2023 年 7 月 19 日

YouTube 遊戲角落網站現在包含遊戲角落遊戲設計指南 這份指南旨在為 在不同裝置和平台上玩 YouTube 遊戲的使用者人數。

遊戲設計指南著重於以下方面:

  • 縮圖圖片
  • 裝置調整
  • 使用者介面 (UI)
  • 手勢和輸入
  • 暫停
  • 靜音
  • 觸動回饋
  • 使用者入門
  • 遊戲結束 (播映畫面)
  • 無障礙設定

此外,onAudioEnabledChange 部分已更新,修正了 程式碼出現小型字體排版錯誤,導致 Flutter 的 提議的 JavaScript 互通性 (JS-Interop) 層。

2023 年 7 月 14 日

「Size」區段已更新,如下所示:

  • 移除遊戲必須能以全螢幕模式暢玩遊戲的條件, 以及橫向或直向的橫向模式
  • 新增遊戲必須支援直向遊玩。
  • 新增遊戲應可在橫向模式中玩。否則遊戲 必須置中,或必須包含左右黑邊。
  • 新增遊戲不得鎖定裝置螢幕方向。

2023 年 7 月 11 日

新增 Flutter Web (實驗功能) 一節以啟用 與使用 Flutter Web 編寫的遊戲整合

2023 年 7 月 1 日

「靜音切換」部分規定遊戲必須尊重音訊 以及遊戲音效不得播放 不如預期外

此外,請參閱「完成內容處理」一節 清楚說明遊戲必須向使用者告知 互動,例如在最終關卡或遊戲完成時互動。

2023 年 6 月 30 日

「開始使用」部分現在加入了附註,說明 SDK 會 也不用人工管理如要驗證 SDK 整合的正確性, 請參閱「SDK 測試套件」。

2023 年 6 月 2 日

YouTube 遊戲角落網站現在提供 Playables SDK 說明文件, 提供了支援 YouTube 遊戲的一組強大 API。

2023 年 5 月 26 日

技術相關規定說明文件的更新內容如下:

章節 異動
載入時間 加入全球平均網際網路速度為 6.8 Mbps, 美國。
互動方法 加入,當使用者與遊戲互動時,遊戲不得 意外延遲或忽略輸入內容
縮圖 更新 1:1、5:7 和 16:9 所需的圖片解析度 比例。
發布商或開發人員資訊 加入這個新部分,要求遊戲必須包含 發布商或開發人員,可能需要提供內容分級
載入遊戲角落 SDK 新增這個新章節,要求遊戲載入遊戲角落 SDK 而不是其他遊戲程式碼
遊戲就緒通知 已更新為只有在firstFrameReady 您遊戲的第一個影格現在可以顯示在螢幕上,而且只會 在遊戲可供任何使用者時呼叫 gameReady API 互動。
靜音切換鈕 新增 YouTube 靜音模式時,不得輸出音訊 ,遊戲的靜音或取消靜音控制項不得影響音訊輸出。

2023 年 3 月 24 日

YouTube 遊戲角落網站現在包含技術相關規定 說明文件,透過說明文件向使用者提供流暢的遊戲體驗 以及透過 YouTube 玩遊戲

技術相關規定一節著重於以下幾個領域:

  • 遊戲穩定性
  • YouTube 體驗
  • YouTube 整合
  • 本地化
  • 營利