このページに記載されていない質問がある場合は、サポートの連絡先ページに記載されている連絡先情報を使用してお問い合わせください。
このページは、よくある質問が寄せられるたびに更新される可能性があります。
全般
このセクションでは、特定のカテゴリに該当しない質問について説明します。
YouTube 環境でゲームをテストできますか?
はい - デベロッパー ポータルを使用して、テスト手順に沿って操作します。
ゲームが Android または SDK テストスイートでレンダリングされない場合は、どうすればよいですか?
ゲームが Android または SDK テストスイートでのみレンダリングされない場合は、WebView でのゲームの読み込み方法が原因であることがよくあります。パフォーマンス上の理由から、ゲームは最初に WebView に読み込まれますが、この WebView はユーザーに表示されないため、WebView のビューポート サイズはゼロになります。この問題を解決するには、次の解決策をおすすめします。
(1)ビューポートのサイズに関係なくゲームコードが実行されることを確認します。
(2)ゲームコードがビューポートのサイズ変更を処理し、ビューポートのサイズがゼロの場合にゲームコードが待機したり失敗したりしないことを確認します。
ウィンドウ イベント resize をリッスンし、window.innerHeight がゼロ以外の場合にのみゲームの高さを設定することをおすすめします。
技術要件
このセクションでは、YouTube ゲームルームの技術要件に関する質問について説明します。
個々のファイルサイズの上限について、免除を受けることはできますか?
いいえ。個々のファイルサイズは厳格な上限です。
初期バンドルサイズはどのように測定されますか?
初期バンドルサイズは、gameReady イベントが呼び出されるまでに、プレイアブルによってダウンロードされた合計バイト数として測定されます。
プレイアブルでは、可能な場合は HTTP 圧縮が使用されます。つまり、初期バンドルサイズはアセットの合計未加工サイズよりも小さくなる可能性があります。SDK Test Suite で初期バンドルサイズをテストする際、ローカルホストがアセットを圧縮していないと、プレイアブルが公開されたときよりもサイズが大きくなる可能性があります。プレイアブルに提供される実際の初期バンドルサイズを確認するには、アップロードされたビルドの index.html ファイルを指す SDK Test Suite を使用するか、ローカル サーバーの設定を変更して gzip 圧縮を有効にします。
個々のファイルまたはバンドル全体のサイズ上限に達した、または上限を超過した場合は、どうすればよいですか?
ゲームを最適化してパフォーマンスを向上させるには、次の記事をご覧ください。
バンドルの合計サイズの上限に収まらない場合はどうすればよいですか?
ユーザーは、ゲームをプレイするたびにゲームのアセットをダウンロードしなければならない場合があります。読み込み時間が長くなったり、データ使用量が大きくなったりするのを防ぐため、ゲームの合計バンドルサイズはできるだけ小さくすることをおすすめします。
ゲームでは、ユーザーの進行状況に応じて、各プレイ セッション中に遅延読み込みやその他のタイプの増分アセット読み込みを利用することをおすすめします。または、アセットをレベルごとに分割して、長いセッション全体に分散して少量のアセットをダウンロードできるようにすることをおすすめします。このような状況では、合計バンドルサイズが大きくてもユーザー エクスペリエンスが低下することはなく、むしろユーザーあたりのフットプリントを抑えながらゲーム内のコンテンツを増やすことができるため、ユーザー エクスペリエンスが向上する可能性があります。ゲームがこの方法で動作し、合計バンドルサイズを大きくすることが正当化されると思われる場合は、サポートのお問い合わせページからユースケースについてご相談ください。
内部分析を外部呼び出しの要件から除外できますか?
いいえ。現時点では、ゲームルームで外部呼び出しを行うことはできません。関心のある分析の種類をパートナー マネージャーに伝えて、この分野の今後の機能の優先順位を決定できるようにします。
ゲームがリモート データベースからデータとレベルを取得しますが、これは許可されますか?
現時点ではできませんが、一部のタイトルでリモートデータ アクセスの試験運用を行っています。 現在、すべてのゲームデータはゲームバンドルの一部として含める必要があります。ゲームアセットやコンテンツを更新または更新する場合は、サポート連絡先ページの連絡先情報を使用して、更新されたゲームバンドルを送信するか、パイロット プログラムへの参加をご希望の場合は、お問い合わせください。
インライン スクリプトの実行に関する「コンテンツ セキュリティ ポリシー」違反のエラーが表示される
これは、JavaScript を使用して <script> タグを作成し、ページに追加した場合に発生します。セキュリティ上の理由から、YouTube ではコンテンツ セキュリティ ポリシー(CSP)を使用しており、スクリプトには「ノンス」と呼ばれる特別なセキュリティ コードが必要です。YouTube は、このコードを HTML ファイル内のスクリプトに自動的に追加しますが、コードで作成したスクリプトには手動で追加する必要があります。
JavaScript を使用してプログラムでスクリプトタグを生成する場合は、ページからノンスを見つけて、新しいスクリプト要素に適用する必要があります。
例:
const script = document.createElement('script');
script.src = '...';
// Find the nonce from the main page and apply it
script.nonce = document.querySelector('script[nonce]')?.nonce;
document.head.appendChild(script);
テストスイートの手順に記載されているガイドラインに沿って、オフライン構成をテストできます。
SDK の統合
このセクションには、Playables SDK API のいずれかに関連する質問が含まれています。
音声統合の問題が原因で認定に不合格となりました。何を修正する必要がありますか?
最も一般的な音声の問題は、再生を開始する前にユーザー操作を想定しているゲームに関連しています。ただし、YouTube ゲームルームに自動的にフォーカスが移る場合があるため、ゲームはこのケースを処理する必要があります。
オーディオ設定の例については、サンプルをご覧ください。
Unity
このセクションでは、既存の Unity ゲームを YouTube ゲームルーム SDK と統合することに関する質問を取り上げます。SDK と Unity ラッパーの使用例については、YouTube ゲームルーム Unity ラッパーのドキュメントをご覧ください。
Unity の事前圧縮を使用できますか?
アセットを事前に圧縮することはおすすめしません。初期バンドルサイズの要件では、圧縮後のサイズが使用されます。アップロードされたファイルは、取り込み後に圧縮が適用されます。それでもファイルを事前圧縮する必要がある場合は、このセクションの残りの部分を参照するか、サポートのお問い合わせページからサポートチームに連絡して、ゲームに最適なオプションについてご相談ください。
一部のゲームでは、Unity の .wasm ファイルまたは .data ファイルに事前圧縮を使用する必要があります。事前圧縮は、読み込み時間が大幅に長くなる可能性があるため、次の条件でのみ使用してください。
- 個々のファイルサイズまたはバンドルの合計サイズの要件を満たすために Unity の事前圧縮を使用する必要がある場合は、「個々のファイルサイズまたはバンドルの合計サイズの上限に達しているか、上限を超えています。どうすればよいですか?」をご覧ください。
- ゲームが認定に合格するために Unity の事前圧縮を使用する必要がある場合は、次の要件を満たす必要があります。
- zip 圧縮を事前に使用する必要があります。
- ローダ スクリプト内でファイルを手動で解凍する必要があります。Compression Streams API を使用することをおすすめします。
これらの追加要件は、サービス提供アーキテクチャの制限に起因しています。現時点では、追加の HTTP ヘッダーや Brotli 圧縮はサポートされていません。
ゲームがバックグラウンドで実行されているときにフレームの更新を管理するにはどうすればよいですか?
setTimeout を使用すると、ゲームがバックグラウンドに移動したときにフレームの更新を管理できます。これにより、音声の一時停止などの動作を制御できます。バックグラウンド フレーム管理を確認するには、プレーヤー設定で [Run in Background] オプションを有効にします。
Unity ゲームのメモリ制限
Unity の一部のゲームでは、大量のメモリが使用されるため、プレイアブルのメモリ使用量の制限を超える可能性があります。Unity WebGL のメモリに関するデベロッパー向けドキュメントに沿って対応することをおすすめします。