Video Recording API を使用すると、ゲームに簡単に録画を追加し、ユーザーが簡単な手順で YouTube 上で友だちと動画を共有できます。 たとえば、バトル リプレイ画面にボタンをタップすると、Play ゲームの動画の録画ボタンが表示されます。
このガイドでは、Google Play ゲームサービスを使用してゲームに録画を実装する方法について説明します。API は com.google.android.gms.games.video パッケージと com.google.android.gms.games パッケージに含まれています。
始める前に
録画 API の使用を開始する前に、以下の操作を行います。
動画クライアントの取得
動画録画 API の使用を開始するには、まず VideosClient オブジェクトを取得する必要があります。そのためには、Games.getVideosClient() メソッドを呼び出して、現在のプレーヤーのアクティビティと GoogleSignInAccount を渡します。プレーヤー アカウント情報を取得する方法については、Android ゲームのログインをご覧ください。
Video recording API の基本
動画録画 API を使用して、ゲーム内から動画の記録機能を直接統合できます。
ユーザー向けの録画機能には次のようなものがあります。
動画撮影オーバーレイには、次の 3 つのボタンがあります。
- 録画を開始 / 停止
- マイクのオンとオフを切り替える
- 前面カメラのオンとオフを切り替える
録音を開始するデベロッパーが提供するボタン、または録音の代替トリガー
録画の最後にクリック可能なトーストが表示され、プレーヤーが YouTube に動画をアップロードしたり、フォト アプリで動画を見たりできます（注: 録画された動画は、フォトのカテゴリ
ScreenCastsに保存されます）。
録画オーバーレイを起動しています
現在ログインしているプレーヤーの録画を開始する手順は次のとおりです。
VideosClient.getCaptureOverlayIntent()メソッドを呼び出します。- 呼び出しが成功すると、Google Play ゲームサービスは、録画オーバーレイを起動するためのインテントを非同期に読み込む
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);
}
});
}
録画データ使用のヒント
Video Recording API を使用すると、録画機能をゲームに直接統合できます。
| ヒント | 説明 |
|---|---|
| 録画トリガーを見つけやすくする |
|
| ストアの掲載情報とゲーム内での機能の使用を促進する |
|
| リプレイ コンテストでプレーヤー コミュニティを惹きつける |
|