Android 游戏中的视频录制功能

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

借助 Video Recording API，您可以轻松地为游戏添加视频录制功能，并让用户只需几个简单的步骤即可在 YouTube 上与好友分享视频。例如，您可以在战斗重玩屏幕上添加一个按钮，当用户按下该按钮时，系统会显示 Play 游戏视频录制体验。

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

准备工作

在开始使用 Video Recording API 之前，请执行以下操作：

• 下载并查看代码示例。

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

获取视频客户端

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

Video Recording API 基础知识

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

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

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

  1. 开始 / 停止录制
  2. 开启 / 关闭麦克风
  3. 开启 / 关闭前置摄像头

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

• 录制结束时弹出的可点击消息框，供玩家将视频上传到 YouTube 或通过 Google 相册应用查看视频（注意：录制的视频存储在 Google 相册的 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，您可以直接在游戏中集成视频录制体验。