在 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 游戏中登录。
视频录制 API 基础知识
您可以使用视频录制 API 直接在游戏中集成视频录制体验。
用户在录制视频时可获得以下体验:
视频录制叠加层,其中包含三个按钮:
- 开始 / 停止录制
- 开启 / 关闭麦克风
- 开启 / 关闭前置摄像头
开发者提供的用于启动录制的按钮,或替代录制触发器
在录制结束时弹出的可点击的 Toast,让玩家能够将视频上传到 YouTube,或通过“照片”应用查看视频(注意:录制的视频存储在“照片”中的
ScreenCasts
类别下)
启动视频录制叠加层
如需为当前已登录的玩家启动视频录制,请按以下步骤操作:
- 调用
VideosClient.getCaptureOverlayIntent()
方法。 - 如果调用成功,Google Play 游戏服务会返回一个
Task
对象,该对象会异步加载用于启动视频录制叠加层的 intent。 - 使用上一步中的 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,您可以直接在游戏中集成视频录制体验。
提示 | 说明 |
---|---|
让视频录制触发器易于发现 |
|
在商品详情和游戏内宣传此功能的使用 |
|
通过重播比赛吸引玩家社区 |
|