Google ログイン API の非推奨に伴い、2026 年に Google Play Games サービス v1 の SDK を削除します。2025 年 2 月以降、Google Play Games サービス v1 の SDK と新たに統合されたタイトルを Google Play で公開することはできなくなります。代わりに Google Play Games サービス v2 の SDK を使用することをおすすめします。
以前のゲーム v1 統合を使用している既存のタイトルは、今後数年間は引き続き機能しますが、2025 年 6 月から v2 への移行を開始することをおすすめします。
このガイドは、Play Games サービス v1 SDK の使用を対象としています。Play ゲームサービス v2 SDK では動画の録画はサポートされていません。
動画録画 API を使用すると、ゲームに動画録画を簡単に追加し、ユーザーが簡単な手順で YouTube で友だちと動画を共有できるようになります。たとえば、バトル リプレイ画面にボタンを追加し、そのボタンを押すと Play Games の動画録画機能が起動するようにできます。
このガイドでは、Google Play Games サービスを使用してゲームに動画録画を実装する方法について説明します。API は com.google.android.gms.games.video
パッケージと com.google.android.gms.games
パッケージに含まれています。
始める前に
動画録画 API の使用を開始する前に:
動画クライアントを取得する
動画録画 API の使用を開始するには、まず VideosClient
オブジェクトを取得する必要があります。そのためには、Games.getVideosClient()
メソッドを呼び出して、アクティビティと現在のプレーヤーの GoogleSignInAccount
を渡します。プレーヤーのアカウント情報を取得する方法については、Android ゲームにログインする方法についての説明をご覧ください。
動画撮影 API の基本
動画録画 API を使用すると、ゲーム内から直接動画録画機能を統合できます。
ユーザーの動画録画エクスペリエンスには、次のものが含まれます。
動画録画のオーバーレイ(3 つのボタンがあります)。
- 録画を開始 / 停止する
- マイクのオン / オフを切り替える
- 前方カメラのオン / オフを切り替える
録画を開始するためのデベロッパー提供のボタン、または録画の代替トリガー
録画の終了時にポップアップ表示されるクリック可能なトースト。プレーヤーは、このトーストから YouTube に動画をアップロードしたり、フォトアプリで動画を視聴したりできます(注: 録画された動画はフォトの
ScreenCasts
カテゴリに保存されます)。
録画オーバーレイを起動する
現在ログインしているプレーヤーの動画録画を開始する手順は次のとおりです。
VideosClient.getCaptureOverlayIntent()
メソッドを呼び出します。- 呼び出しに成功すると、Google Play Games サービスは、動画録画オーバーレイを起動するインテントを非同期に読み込む
Task
オブジェクトを返します。 - 前のステップのインテントを使用してアクティビティを開始します。
動画録画オーバーレイを表示する方法の例を次に示します。
private static final int RC_VIDEO_OVERLAY = 9011; public void showVideoOverlay(View myview) { Games.getVideosClient(this, GoogleSignIn.getLastSignedInAccount(this)) .getCaptureOverlayIntent() .addOnSuccessListener(new OnSuccessListener<Intent>() { @Override public void onSuccess(Intent intent) { startActivityForResult(intent, RC_VIDEO_OVERLAY); } }); }
動画録画データを使用する際のヒント
動画録画 API を使用すると、ゲームに動画録画機能を直接統合できます。
ヒント | 説明 |
---|---|
動画録画のトリガーを簡単に見つけられるようにする |
|
ストアの掲載情報とゲーム内でこの機能の使用を宣伝する |
|
リプレイ コンテストでプレーヤー コミュニティを盛り上げる |
|