Android ゲームでの動画録画

video recording API を使用すると、ゲームに動画録画を簡単に追加し、ユーザーが簡単な手順で YouTube で動画を友だちと共有できるようになります。たとえば、バトルのリプレイ画面にボタンを追加し、そのボタンを押すと Google Play Games の動画録画機能が表示されるようにします。

このガイドでは、Google Play Games サービスを使用してゲームに動画録画を実装する方法について説明します。API は com.google.android.gms.games.video パッケージと com.google.android.gms.games パッケージに含まれています。

始める前に

Video Recording API の使用を開始する前に、以下を確認してください。

• コードサンプルをダウンロードして内容を確認する。

• 品質チェックリストで説明されている推奨事項を確認します。

動画クライアントを取得する

動画録画 API の使用を開始するには、まずゲームで VideosClient オブジェクトを取得する必要があります。そのためには、Games.getVideosClient() メソッドを呼び出して、アクティビティと現在のプレーヤーの GoogleSignInAccount を渡します。プレーヤーのアカウント情報を取得する方法については、Android ゲームにログインする方法についての説明をご覧ください。

Video recording API の基本

Video Recording API を使用すると、ゲーム内から直接動画録画機能を統合できます。

ユーザーの動画録画機能は次のとおりです。

• 動画録画のオーバーレイには、次の 3 つのボタンがあります。

  1. 録画を開始 / 停止する
  2. マイクのオン / オフを切り替える
  3. 前面カメラをオンまたはオフにする

• 録画を開始するデベロッパー提供のボタン、または代替の録画トリガー

• 録画の終了時にポップアップ表示されるクリック可能なトースト。これにより、プレーヤーは動画を YouTube にアップロードしたり、フォトアプリで動画を表示したりできます（注: 録画した動画は、フォトの [ScreenCasts] カテゴリに保存されます）。

動画録画のオーバーレイを起動する

現在ログインしているプレーヤーの動画録画を開始する手順は次のとおりです。

1. VideosClient.getCaptureOverlayIntent() メソッドを呼び出します。
2. 呼び出しが成功すると、Google Play Games サービスは、動画録画オーバーレイを起動するインテントを非同期に読み込む Task オブジェクトを返します。
3. 前のステップのインテントを使用してアクティビティを開始します。

動画録画オーバーレイを表示する方法の例を次に示します。

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 を使用すると、動画録画機能をゲームに直接統合できます。