Android 遊戲的錄影功能

Google 登入 API 淘汰後，我們將於 2026 年移除遊戲服務第 1 版 SDK。2025 年 2 月後，新整合遊戲服務第 1 版 SDK 的遊戲將無法在 Google Play 發布，建議改用遊戲服務第 2 版 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 可讓您直接在遊戲中整合影片錄製功能。

提示 說明
讓使用者輕鬆找到影片錄製觸發條件
  • 在主選單外顯眼的位置放置錄製按鈕
  • 透過標示清楚的專屬錄製模式選單選項，自動觸發疊加畫面
在商店資訊和遊戲內宣傳這項功能
  • 在商店資訊中使用顯示影片錄製疊加層的螢幕截圖
  • 透過遊戲內宣傳活動宣傳影片錄製功能
  • 考慮提供遊戲內獎勵，鼓勵玩家分享重播
透過重播競賽與玩家社群互動
  • 舉辦每週 / 每月 / 每年重播競賽，鼓勵玩家錄製並分享遊戲重播
  • 在遊戲中或透過社群媒體認識頂尖影片和創作者