云游戏接入

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

相关产品
云游戏 产品页,含版本规格、价格与购买入口。

一、有客户端模式

有客户端模式下,你需要在自己的客户端集成云游戏 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 接入示例。

赞 (0)
上一篇 4天前
下一篇 4天前