借助视频录制 API，您可以轻松地将视频录制功能添加到游戏中，让用户只需简单几步即可与 YouTube 上的好友分享视频。例如，您可以在战斗重放屏幕上添加一个按钮，当用户按下该按钮时，系统将打开 Play 游戏视频录制体验。
本指南介绍了如何使用 Google Play 游戏服务在游戏中录制视频。这些 API 可在 com.google.android.gms.games.video 和 com.google.android.gms.games 软件包中找到。
准备工作
开始使用视频录制 API 之前，请执行以下操作：
获取视频客户端
如需开始使用视频录制 API，您的游戏必须先获取一个 VideosClient 对象。为此，您可以调用 Games.getVideosClient() 方法并传入当前播放器的 activity 和 GoogleSignInAccount。如需了解如何检索玩家帐号信息，请参阅在 Android 游戏中登录。
Video Recording API 基础知识
您可以使用 Video Recording API 直接在您的游戏中集成视频录制体验。
用户的视频录制体验包括：
视频录制叠加层，包含三个按钮：
- 开始 / 停止录制
- 开启 / 关闭麦克风
- 开启 / 关闭前置摄像头
开发者提供的用于启动录制的按钮，或备用录制触发器
录制结束时弹出的可点击消息框，可让玩家将视频上传到 YouTube 或通过 Google 相册应用观看视频（注意：录制的视频存储在 Google 相册的
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);
}
});
}
视频录制数据使用提示
借助 Video Recording API，您可以直接在游戏中集成视频录制体验。
| 提示 | 说明 |
|---|---|
| 使视频触发器更容易被发现 |
|
| 在您的商品详情中以及游戏内推广该功能 |
|
| 通过重放比赛与玩家社区互动 |
|