一、有客户端模式
有客户端模式下,你需要在自己的客户端集成云游戏 SDK,并通过云游戏 SDK 体验云游戏。
二、1. 前期准备
1. 创建云游戏业务后台,详情请参见 创建云游戏业务后台。
2. 业务客户端集成云游戏 SDK,详情请参见 创建业务客户端并集成云游戏 SDK。
三、步骤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. 前期准备
创建云游戏业务后台,详情请参见 创建云游戏业务后台。
十、步骤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 接入示例。