接入云游戏

最近更新时间:2023-02-21 17:11:53

我的收藏
云游戏是前后端一体的 PaaS 产品,提供各平台客户端 SDK 以及后端 API,您需要搭建自己后台服务(有客户模式还需要有客户端),才能为您的用户提供云游戏服务。目前云游戏服务支持有客户端和无客户端两种模式。

有客户端模式

有客户端模式下,您需要在自己的客户端集成云游戏 SDK,并通过云游戏 SDK 体验云游戏。

1. 前期准备

1. 创建云游戏业务后台,详情请参见 创建云游戏业务后台
2. 业务客户端集成云游戏 SDK,详情请参见 创建业务客户端并集成云游戏 SDK

2. 运行云游戏服务






步骤1:客户端初始化云游戏 SDK

无论您使用的哪种客户端,在初始化 SDK 成功后都可以获取到 ClientSession。ClientSession 将用于后续业务后台获取 ServerSession,各个 SDK 具体初始化及获取 ClientSession 的方式如下:
JS SDK:调用 TCGSDK.init 接口完成初始化构建。初始化完成后,客户端调用 TCGSDK.getClientSession 函数,获取 Client 端的 ClientSession。
Android SDK:通过 TcrSdk.getInstance().init 接口完成 SDK 初始化。初始化完成后,客户端在初始化 TcrSession 的回调 TcrSession.init 里,获取 Client 端的 ClientSession。

步骤2:业务后台锁定云游戏实例

业务后台调用云游戏 API TrylockWorker 锁定云游戏实例,收到成功回调后执行下一步。

步骤3:业务后台初始化云端实例

业务后台调用云游戏 API CreateSession 初始化云端实例,并把获取成功回调中的 ServerSession 返回给客户端。
注意:RunMode 参数传空字符。

步骤4:启动云游戏

客户端收到业务后台返回的 ServerSession 后,调用云游戏 SDK 接口启动云游戏。各个 SDK 启动云游戏的接口如下:
JS SDK:客户端调用 TCGSDK.start 函数启动云游戏。
Android SDK:客户端调用 TcrSession.start 函数启动云游戏。

步骤5:回收云游戏实例

云游戏实例使用完毕后,由业务后台调用云游戏 API StopGame 回收云游戏实例。另外云游戏 SDK -云游戏后台的心跳中断时,云游戏实例也会被自动回收。

无客户端模式

无客户端模式下,不需要集成云游戏 SDK,适用于一些不需要客户端的纯云端场景。

1. 前期准备

创建云游戏业务后台,详情请参见 创建云游戏业务后台

2. 运行云游戏服务






步骤1:业务后台锁定云游戏实例

业务后台调用云游戏 API TrylockWorker 锁定云游戏实例,收到成功回调后执行下一步。

步骤2:业务后台初始化云端实例

业务后台调用云游戏 API CreateSession 初始化云端实例。
注意:RunMode 参数传 "RunWithoutClient",ClientSession 参数传空字符。

步骤4:开始云端推流

云游戏实例初始化完成后,业务后台调用云游戏 API StartPublishStream 将云端 APP 的完整运行画面推流至 腾讯云直播

步骤5:停止云端推流

推流完成后,业务后台调用云游戏 API StopPublishStream 停止推流。

步骤6:回收云游戏实例

云游戏实例使用完毕后,由业务后台调用云游戏 API StopGame 回收云游戏实例。

操作指引

创建云游戏业务后台

您的业务后台需要调用云游戏提供的 云 API 来请求您的云游戏并发等资源,我们提供了 后台 Demo 供参考。
说明
云游戏 API 的调用依赖腾讯云账号 API 密钥中的 SecretId 和 SecretKey,请在 API 密钥管理 页面中获取。

创建业务客户端并集成云游戏 SDK

在您的客户端集成云游戏 SDK(支持 Android 端、iOS 端、H5 以及小程序平台),可参考 创建 JS 客户端程序创建 Android 客户端程序 集成客户端。
注意:如果使用无客户端模式,可忽略这一步骤。
说明
iOS SDK 目前正在灰度测试中,如有接入需要请参见 iOS SDK 接入示例