Android 游戏中的视频录制

随着 Google 登录 API 的弃用,我们将在 2026 年移除 Games v1 SDK。2025 年 2 月之后,您将无法在 Google Play 上发布新集成 Games v1 SDK 的游戏。我们建议您改用 Games v2 SDK。
虽然现有集成旧版 Games v1 的游戏仍可继续运行几年,但我们建议您从 2025 年 6 月开始迁移到 v2
本指南适用于使用 Play Games Services v1 SDK。Play Games Services v2 SDK 不支持视频录制。

视频录制 API 使您能够轻松地为游戏添加视频录制功能,并让用户通过几个简单的步骤将他们的视频分享给 YouTube 上的好友。例如,您可以在战斗回放屏幕旁添加一个按钮,按下该按钮即可调出 Play Games 视频录制体验。

本指南向您展示如何使用 Google Play Games Services 在游戏中实现视频录制。API 位于 com.google.android.gms.games.videocom.google.android.gms.games 包中。

准备工作

在使用视频录制 API 之前

获取视频客户端

要开始使用视频录制 API,您的游戏必须首先获取 VideosClient 对象。您可以通过调用 Games.getVideosClient() 方法并传入 Activity 和当前玩家的 GoogleSignInAccount 来执行此操作。要了解如何检索玩家账号信息,请参阅Android 游戏中的登录

视频录制 API 基础知识

您可以使用视频录制 API 直接在游戏内集成视频录制体验。

用户的视频录制体验包括以下内容

  • 视频录制叠加层,其中有三个按钮

    1. 开始 / 停止录制
    2. 开启 / 关闭麦克风
    3. 开启 / 关闭前置摄像头
  • 开发者提供的用于启动录制的按钮,或替代录制触发器

  • 录制结束时弹出的可点击提示,使玩家能够将视频上传到 YouTube,或通过照片应用查看视频(注意:录制的视频存储在照片应用的 ScreenCasts 类别下)

启动视频录制叠加层

要启动当前已登录玩家的视频录制,请按照以下步骤操作

  1. 调用 VideosClient.getCaptureOverlayIntent() 方法。
  2. 如果调用成功,Google Play 游戏服务会返回一个 Task 对象,该对象异步加载一个用于启动视频录制叠加层的 Intent。
  3. 使用上一步中的 Intent 启动 Activity。

以下是如何调出视频录制叠加层的示例

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 使您能够直接在游戏内集成视频录制体验。

技巧 描述
使视频录制触发器易于发现
  • 在主菜单上显眼地放置录制按钮
  • 从专用且明确标记的录制模式菜单选项自动触发叠加层
在您的商店商品详情和游戏内宣传该功能的使用
  • 在您的商店商品详情中使用显示视频录制叠加层的屏幕截图
  • 通过游戏内促销宣传视频录制功能
  • 考虑提供游戏内奖励以鼓励分享回放
通过回放比赛吸引您的玩家社区
  • 通过每周/每月/每年回放比赛鼓励玩家录制和分享游戏回放
  • 在游戏内或通过社交媒体表彰顶级视频和创作者