本頁提供下列文件的修訂版本記錄:
2026 年 10 月 16 日
- 更新營利規定,說明違反規定可能導致營利功能停用,並新增真實世界金錢獎勵 (第 1 節)、獎勵廣告 (第 2.1 節)、插頁式廣告 (第 2.2 節) 和廣告友善內容 (第 4 節) 的規定。
2026 年 8 月 25 日
- 更新信任與安全規定,新增重複內容政策 (第 2.2 節),要求內容必須為原創、經授權或取得授權,並禁止重複的遊戲版本。
2026 年 8 月 24 日
- 新增遊戲無障礙標記 (第 2 節和第 2.1 節),涵蓋無障礙遊戲計畫 (AGI) 玩家探索和開發人員中繼資料準確度。
2024 年 7 月 11 日
- 將技術相關規定重構為多個頁面。
- 需求條件清理和簡化。
2024 年 6 月 24 日
將套件總大小上限從 100 MiB 提高至 250 MiB,並新增延遲載入指南。
2024 年 6 月 17 日
測試套件更新:
- 遊戲不再需要透過 HTTPS 提供,可從 localhost 提供進行測試。
- 網址欄位旁新增「重新整理」按鈕,可重新整理 iframe 內容,不必重新載入整個測試套件。
2024 年 5 月 16 日
將設計最佳做法移至獨立文件,以便更清楚區分設計需求和最佳做法。
2024 年 5 月 8 日
重構 Playables 開發人員網站,擴大存取權並改善導覽功能。
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 日
可下載的測試套件套裝組合已替換為託管的測試套件。
TypeScript 類型定義檔案先前位於測試套件套件中,現已移至遊戲角落 SDK 主文章。
2023 年 9 月 7 日
更新「開始使用」一節,將 Playables SDK 網址從 v0 變更為 v1。
2023 年 8 月 30 日
「檔案名稱」和「縮圖」部分已更新,移除明確列出允許特殊字元 (_、-、.) 的參考資料。
此外,「雲端儲存」部分也已更新,要求雲端儲存功能必須在新遊戲版本中運作。
2023 年 8 月 25 日
saveData 部分已更新,明確指出儲存資料必須是有效且格式正確的 UTF-16 字串。
2023 年 8 月 18 日
「暫停和繼續」一節已更新,說明遊戲必須在呼叫 onPause 後暫停所有執行作業,並在呼叫 onResume 後才繼續執行。
2023 年 8 月 11 日
新增「檔案名稱」一節,說明遊戲套裝組合中檔案名稱的字元限制。
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 (experimental)」(Flutter 網頁 (實驗功能)) 專區,可與使用 Flutter Web 編寫的遊戲整合。
2023 年 7 月 1 日
「靜音切換」部分要求遊戲必須遵循 YouTube 和系統的音訊設定,且遊戲音效不得意外播放。
此外,「內容處理完成」一節也說明,遊戲必須向使用者表明已無更多內容可互動,例如在最後一關或遊戲完成時。
2023 年 6 月 30 日
「開始使用」部分現在包含附註,說明在本機提供遊戲時,SDK 不會執行任何操作。如要確認 SDK 整合是否正確,請參閱「SDK 測試套件」。
2023 年 6 月 2 日
YouTube 遊戲角落網站現已提供 Playables SDK 說明文件,其中包含一組強大的 API,可支援 YouTube 遊戲。
2023 年 5 月 26 日
技術相關規定文件更新如下:
| 區段 | 變更 |
|---|---|
| 載入時間 | 包括全球平均網路速度 6.8Mbps 和美國平均網路速度 20Mbps。 |
| 互動方式 | 新增規定:使用者與遊戲互動時,遊戲不得無意中延遲或忽略輸入內容。 |
| 縮圖 | 更新 1:1、5:7 和 16:9 比例的必要圖片解析度。 |
| 發布商或開發人員資訊 | 新增這個部分,要求遊戲必須包含發布商或開發人員的名稱,且日後可能也須提供內容分級。 |
| 載入 Playables SDK | 新增這個部分,要求遊戲在載入其他遊戲程式碼前,先載入 Playables SDK。 |
| 遊戲就緒通知 | 更新後,只有在遊戲的第一個影格準備好在螢幕上算繪時,才會呼叫 firstFrameReady API,且只有在遊戲準備好進行任何使用者互動時,才會呼叫 gameReady API。 |
| 靜音切換鈕 | 新增 YouTube 靜音設定後,不得輸出音訊,且遊戲的靜音或取消靜音控制項不得影響音訊輸出。 |
2023 年 3 月 24 日
YouTube 遊戲角落網站現已加入技術相關規定文件,旨在為 YouTube 遊戲玩家提供流暢的遊戲體驗。
技術相關規定一節著重於下列領域:
- 遊戲穩定性
- YouTube 體驗
- YouTube 整合
- 本地化
- 營利