統合の要件

このセクションでは、Playable と YouTube Playables SDK の統合について説明します。

1 Playables SDK を読み込む

2 ゲームの準備完了通知

  • ゲームは、読み込みプロセスが進行中であることをユーザーに明示的に伝える読み込み画面またはスプラッシュ画面をレンダリングするときに、呼び出す firstFrameReady 必要があります 。
  • ゲームは、ユーザー インタラクション の準備ができたとき（メインメニューやゲームのプレイ準備ができたときなど）に gameReady を呼び出す必要があり 、gameReady はそのときにのみ呼び出す必要があり ます。
  • スプラッシュ画面や読み込み画面など、ユーザーが操作できない要素が表示されている間は、gameReady を呼び出すことはgameReady許可されていません 。

この API が呼び出されるまで、YouTube は「読み込みスピナー」を削除しません。

3 ユーザー スコア

  • ゲームは、ユーザーのスコアを送信するためにsendScoreを使用する場合があります。
  • ゲームで sendScore を使用してスコアを送信する場合、ゲームはMUST sendScore の仕様に準拠し、MUST 送信されるベストスコアがゲームの保存されたベストスコアと 一致することを確認する必要があります。

4 クラウド保存

  • ゲームは、ユーザーがゲームの進行状況を保存したと考えるような重要なゲームの進行状況（レベルの変更など）があった場合に、saveData を呼び出して進行状況を保存する必要があります。
  • ユーザーの進行状況を保存するために他のメカニズムを使用することは許可されていません 。この機能により、プレーヤーは後でゲームを再開できます。
  • ゲームは、`saveData` を呼び出す前に `loadData` を待機する loadData saveData 必要があります。loadData が正常に完了する前に saveData が呼び出されると、the request will be rejected. これにより、ゲームが以前に保存されたデータを上書きすることを防ぎます。
  • ゲームは、エラーやクラッシュなしに、以前のバージョンのゲームのクラウド保存データを使用できる必要があります 。
  • ゲームは、ユーザーがデータを使用すると予想するすべてのゲーム バージョンで、クラウド保存データを使用してユーザーの進行状況を維持する必要があります 。
  • ゲームは、データ損失を防ぐために、重要なゲームのマイルストーンでユーザーの進行状況を自動的に保存する必要があります 。ユーザーがゲームを終了すると、最終的なフラッシュ保存が実行されますが、ベスト エフォートであり、コンテンツの長さは最大 64 KiB までしか保存できません。

5 ミュートの切り替え

  • ゲームは、システムの音声設定とミュートボタンを優先する必要があります 。
  • ゲームは、YouTube の音声設定とミュートボタンを優先する必要があります 。 isAudioEnabled と onAudioEnabledChange を使用します。
  • ゲームは、デバイスの音量調節を優先する必要があります 。
  • ゲームのサウンドが予期せず再生されることは許可されていません 。
  • YouTube のミュートが設定されている場合、オーディオ出力は許可されていません 。また、ゲームのオーディオコントロールがオーディオ出力に影響を与えることも許可されていません 。
  • YouTube のミュートが設定されていない場合、ゲームの音声コントロールが音声出力に影響を与える可能性があります 。
  • ゲーム自体に全体的なミュートボタンを表示することは推奨されていません 。ユーザーが YouTube レベルの機能を使用できるようにしてください。
  • ゲームには、音楽や効果音など、個別のきめ細かな音声コントロールを設定できます が、他のすべての音声コントロール要件に準拠する必要があります 。

背景、SFX、ダイアログの音声設定を個別に調整

6 一時停止と再開

Playables SDK には、クロスプラットフォームの一時停止と再開の機能のコールバックが用意されています。

  • ゲームは、MUST `onPause` が呼び出された後にすべての実行を一時停止し、MUST `onResume` が呼び出されたときにのみ実行を再開するonPause必要がありますonResume。実行には、ゲームループ、音楽、操作、ネットワークの呼び出し、レンダリングなど、すべての Playable 機能が含まれます。
  • ゲームではウェブの Page Visibility API や類似のウェブ API を使用することは許可されていません 。Playables SDK の onPause および onResume のみを使用する必要があります 。
  • ゲームはonPauseが発生したときにユーザーの進行状況を保存することが推奨されています。