這個頁面提供了下列文件的修訂版本記錄:
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 日
測試套件更新
- 新增檢查檔案名稱中不支援的字元。
- 如要進一步瞭解支援的字元,請參閱技術相關規定 - 1.9 檔案名稱。
- 已知限制:這項檢查可能不會驗證所有載入的資源,
- 新增模擬載入畫面的功能,包括設定初始 將 iframe 高度設為 0。
- 透過切換鈕更新暫停恢復按鈕,更貼近實際工作環境的需求 播放音訊。
- 已從事件記錄中移除無法操作的訊息。
2023 年 11 月 10 日
下載的 Test Suite 套件已替換為託管的測試 套件。
TypeScript 類型定義檔案 (先前可透過 Test Suite 提供) 已移至主要的 Playables SDK 文章。
2023 年 9 月 7 日
我們已更新「開始使用」部分,為遊戲角落進行變更
從 v0
到 v1
的 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 日
- 移除遊戲必須能以全螢幕模式暢玩遊戲的條件, 以及橫向或直向的橫向模式
- 新增遊戲必須支援直向遊玩。
- 新增遊戲應可在橫向模式中玩。否則遊戲 必須置中,或必須包含左右黑邊。
- 新增遊戲不得鎖定裝置螢幕方向。
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 整合
- 本地化
- 營利