Android 遊戲的錄影功能

隨著 Google Sign-In API 淘汰，我們將在 2026 年移除遊戲第 1 版 SDK。2025 年 2 月後，您將無法在 Google Play 上發布新整合 games v1 SDK 的遊戲。建議您改用 games v2 SDK。
雖然採用舊版遊戲第 1 版整合功能的現有遊戲仍可繼續運作幾年，但建議您從 2025 年 6 月開始遷移至第 2 版。
本指南適用於使用 Play 遊戲服務第 1 版 SDK。Play 遊戲服務第 2 版 SDK 不支援錄影功能。

透過影片錄製 API，您可以輕鬆在遊戲中加入影片錄製功能，並透過幾個簡單步驟，讓使用者在 YouTube 上與好友分享影片。舉例來說，您可以在戰鬥重播畫面中加入按鈕，按下該按鈕時會顯示 Play 遊戲錄影功能。

本指南說明如何使用 Google Play 遊戲服務在遊戲中實作錄影功能。您可以在 com.google.android.gms.games.video 和 com.google.android.gms.games 套件中取得此 API。

事前準備

開始使用錄影 API 前：

• 請下載並查看程式碼範例。

• 請熟悉「品質檢查清單」中所列的建議。

取得影片用戶端

如要開始使用錄影 API，遊戲必須先取得 VideosClient 物件。方法是呼叫 Games.getVideosClient() 方法，然後傳入活動和目前播放器的 GoogleSignInAccount。如要瞭解如何擷取玩家帳戶資訊，請參閱「Android 遊戲登入」。

錄影 API 基本概念

您可以使用錄影 API，直接在遊戲中整合錄影體驗。

使用者可透過下列方式錄製影片：

• 影片錄影重疊畫面，其中有三個按鈕：

  1. 開始 / 停止錄製
  2. 開啟 / 關閉麥克風
  3. 開啟 / 關閉前置鏡頭

• 開發人員提供的按鈕，用於啟動錄影功能，或其他錄影觸發事件

• 在錄製結束時彈出的可點選浮動視窗，可讓玩家將影片上傳至 YouTube，或透過相片應用程式查看影片 (注意：錄製的影片會儲存在相片的 ScreenCasts 類別下)

啟動錄影重疊畫面

如要為目前登入的玩家啟動錄影功能，請按照下列步驟操作：

1. 呼叫 VideosClient.getCaptureOverlayIntent() 方法。
2. 如果呼叫成功，Google Play 遊戲服務會傳回 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，直接在遊戲中整合錄影體驗。