このページでは、次のドキュメントの変更履歴を示します。
2026 年 8 月 25 日
- 信頼性と安全性の要件を更新し、オリジナル、承認済み、ライセンス取得済みのコンテンツを必要とし、重複するゲームビルドを禁止する重複コンテンツ ポリシー（セクション 2.2）を追加しました。
2026 年 8 月 24 日
- Accessible Gaming Initiative（AGI）のプレーヤーの検索とデベロッパーのメタデータの正確性を対象とするゲームのアクセシビリティ タグ（セクション 2 と 2.1）を追加しました。
2024 年 7 月 11 日
- 技術要件を複数のページにリファクタリングしました。
- 要件のクリーンアップと重複排除。
2024 年 6 月 24 日
バンドルの合計サイズの上限を 100 MiB から 250 MiB に引き上げ、遅延読み込みのガイダンスを追加しました。
2024 年 6 月 17 日
テストスイートの更新:
- ゲームは HTTPS 経由で提供する必要がなくなり、テスト用に localhost から提供できるようになりました。
- URL フィールドの横に更新ボタンが追加され、テストスイート全体を再読み込みすることなく iframe のコンテンツを更新できるようになりました。
2024 年 5 月 16 日
設計要件とベスト プラクティスをより明確に区別するため、設計のベスト プラクティスを別のドキュメントに移動しました。
2024 年 5 月 8 日
ゲームルーム デベロッパー サイトをリファクタリングし、アクセスを拡大してナビゲーションを改善しました。
2024 年 5 月 7 日
Game Ready Notification の技術要件を更新し、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 型定義ファイルが、メインの Playables SDK の記事に移動しました。
2023 年 9 月 7 日
スタートガイドのセクションが更新され、Playables SDK の URL が 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 で作成されたゲームとの統合を可能にするため、[Flutter ウェブ（試験運用版）] セクションが追加されました。
2023 年 7 月 1 日
[ミュートの切り替え] セクションでは、YouTube とシステムの両方の音声設定をゲームが尊重し、ゲームの音声が予期せず再生されないことが求められます。
また、コンテンツ処理の完了セクションでは、最終レベルやゲームの完了など、操作できるコンテンツがなくなったことをユーザーに伝える必要があることを明確にしています。
2023 年 6 月 30 日
[スタートガイド] セクションに、ゲームがローカルで配信される場合、SDK は no-op になるという注記が追加されました。SDK の統合が正しいことを確認するには、SDK テストスイートをご覧ください。
2023 年 6 月 2 日
YouTube Playables サイトに、YouTube ゲームをサポートする強力な API セットを備えた Playables SDK のドキュメントが追加されました。
2023 年 5 月 26 日
技術要件のドキュメントの更新は次のとおりです。
| セクション | 変更点 |
|---|---|
| 読み込み時間 | 世界の平均インターネット速度は 6.8 Mbps、米国の平均インターネット速度は 20 Mbps であることを追記しました。 |
| インタラクション メソッド | ユーザーがゲームを操作する際に、ゲームが意図せずに入力を遅延させたり無視したりしてはならないことを追加しました。 |
| サムネイル | 1:1、5:7、16:9 の比率に必要な画像解像度を更新しました。 |
| パブリッシャーまたはデベロッパーの情報 | ゲームにパブリッシャーまたはデベロッパーの名前を含めることを義務付ける新しいセクションを追加しました。また、今後コンテンツのレーティングの提供も義務付けられる可能性があります。 |
| Playables SDK を読み込む | ゲームコードの前に Playables SDK を読み込むことをゲームに要求する新しいセクションを追加しました。 |
| Game Ready 通知 | ゲームの最初のフレームを画面上にレンダリングする準備ができたときにのみ firstFrameReady API を呼び出し、ゲームがユーザー操作の受け入れ準備ができたときにのみ gameReady API を呼び出すように更新しました。 |
| ミュートの切り替え | YouTube のミュートが設定されている場合、オーディオを出力してはならず、ゲームのミュートまたはミュート解除のコントロールがオーディオ出力に影響してはならないことを追加しました。 |
2023 年 3 月 24 日
YouTube ゲームルーム サイトに、YouTube でゲームをプレイするユーザーにスムーズなゲーム体験を提供することを目的とした技術要件のドキュメントが追加されました。
技術要件のセクションでは、次の分野に焦点を当てています。
- ゲームの安定性
- YouTube の利用
- YouTube の統合
- ローカライズ
- 収益化