このページでは、次のドキュメントの変更履歴を説明します。
2026 年 10 月 16 日
- 収益化の要件を更新し、要件を遵守しない場合は収益化機能が無効になる可能性があることを明記しました。また、現実世界の金銭的報酬（セクション 1）、リワード広告（セクション 2.1）、インタースティシャル広告（セクション 2.2）、広告掲載に適したコンテンツ（セクション 4）に関する要件を追加しました。
2026 年 8 月 25 日
- 信頼性と安全性に関する要件を更新し、重複コンテンツに関するポリシー（セクション 2.2）を追加しました。このポリシーでは、オリジナル、承認済み、またはライセンス取得済みのコンテンツが求められ、重複するゲームビルドは禁止されています。
2026 年 8 月 24 日
- ゲームのユーザー補助タグ（セクション 2、2.1）を追加しました。これは、Accessible Gaming Initiative（AGI）のプレーヤーの検出とデベロッパーのメタデータの正確性に関するものです。
2024 年 7 月 11 日
- 技術要件を複数のページにリファクタリングしました。
- 要件のクリーンアップと重複排除。
2024 年 6 月 24 日
バンドルの合計サイズの上限を 100 MiB から 250 MiB に引き上げ、遅延読み込みのガイダンスを追加しました。
2024 年 6 月 17 日
テストスイートの更新:
- ゲームを HTTPS 経由で提供する必要がなくなり、テスト用に localhost から提供できるようになりました。
- URL フィールドの横に更新ボタンを追加し、テストスイート全体を再読み込みせずに 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 型定義ファイルが、メインの 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 日
Playables ゲーム設計ガイドラインのドキュメントが更新され、表現が標準化され、ベスト プラクティスとスクリーンショットが更新されました。
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 は何も行わないという注記を追加しました。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 を読み込むことを義務付ける新しいセクションを追加しました。 |
| ゲームの準備完了通知 | ゲームの最初のフレームを画面上にレンダリングする準備ができたときにのみ firstFrameReady API を呼び出し、ゲームがユーザー操作の受け入れ準備ができたときにのみ gameReady API を呼び出すように更新しました。 |
| ミュートの切り替え | YouTube のミュートが設定されている場合、音声を出力してはならず、ゲームのミュートまたはミュート解除のコントロールが音声出力に影響してはならないことを追加しました。 |
2023 年 3 月 24 日
YouTube ゲームルームのサイトに、技術要件のドキュメントが追加されました。これは、YouTube でゲームをプレイするユーザーにスムーズなゲーム体験を提供することを目的としています。
技術要件のセクションでは、次の分野に焦点を当てています。
- ゲームの安定性
- YouTube の利用
- YouTube との統合
- ローカライズ
- 収益化