Android 游戏中的视频录制功能

在 Google 登录 API 弃用后，我们将于 2026 年移除 Play 游戏服务 v1 SDK。自 2025 年 2 月起，您将无法在 Google Play 上发布新集成了 Games v1 SDK 的游戏。我们建议您改用游戏 v2 SDK。
虽然集成旧版游戏 v1 的现有游戏在未来几年内仍可正常运行，但我们建议您从 2025 年 6 月开始迁移到 v2。
本指南适用于 Play 游戏服务 v1 SDK。Play 游戏服务 v2 SDK 不支持视频录制功能。

借助 Video Recording API，您可以轻松地向游戏中添加视频录制功能，并让用户通过几个简单的步骤在 YouTube 上与好友分享视频。例如，您可以在对战重放界面上添加一个按钮，当用户按下该按钮时，系统会启动 Play Games 视频录制体验。

本指南介绍了如何使用 Google Play 游戏服务在游戏中实现视频录制功能。这些 API 可在 com.google.android.gms.games.video 和 com.google.android.gms.games 软件包中找到。

准备工作

开始使用视频录制 API 之前，请执行以下操作：

• 下载并查看代码示例。

• 熟悉质量核对清单中所述的建议。

获取视频客户端

如需开始使用视频录制 API，您的游戏必须先获取一个 VideosClient 对象。为此，您可以调用 Games.getVideosClient() 方法并传入 activity 和当前播放器的 GoogleSignInAccount。如需了解如何检索玩家的账号信息，请参阅在 Android 游戏中登录。

注意： VideosClient 类使用 Google Play 服务 Task 类以异步返回结果。如需详细了解如何使用任务来管理线程工作，请参阅 Tasks API 开发者指南。

视频录制 API 基础知识

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

用户在录制视频时可获得以下体验：

• 视频录制叠加层，其中包含三个按钮：

  1. 开始 / 停止录制
  2. 开启 / 关闭麦克风
  3. 开启 / 关闭前置摄像头
  注意： 点击叠加层的前置摄像头显示画面会显示上述三个按钮。

• 开发者提供的用于启动录制的按钮，或替代录制触发器

• 在录制结束时弹出的可点击的 Toast，让玩家能够将视频上传到 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，您可以直接在游戏中集成视频录制体验。

提示	说明
让视频录制触发器易于发现	在主菜单之外醒目地放置录制按钮 通过专用且明确标记的录制模式菜单选项自动触发叠加层
在商品详情和游戏内宣传此功能的使用	在商品详情中使用显示视频录制叠加层的屏幕截图 通过游戏内宣传推广视频录制功能 考虑为分享重放提供游戏内奖励
通过重播比赛吸引玩家社区	通过每周 / 每月 / 每年的重放比赛，鼓励玩家录制和分享游戏重放 在游戏中或通过社交媒体表彰热门视频和创作者