接入 Demo

最近更新时间:2024-04-19 11:24:11

我的收藏
为实现您的独特业务需求、保证最佳用户体验,您可以进行后台与客户端开发来搭建自己的后台服务和客户端程序,接入应用云渲染 PaaS 提供 云 API 和各终端 SDK(JavaScript SDKAndroid SDKiOS SDK)。您无需从头开始接入,我们提供接入 Demo帮助您快速实现业务上线。


部署业务后台 Demo

根据 指引,在本地或者任意服务器部署业务后台 Demo,Demo 较为轻量对服务器配置没有特殊要求。
后台 Demo 支持实现包括启动应用、退出应用、用户排队等功能,更多具体接入功能请参见 技术接入
业务后台必须部署无法省略:
因为访问应用云渲染 云 API 服务需要提供腾讯云账号的 SecretId 和 SecretKey(可在 控制台 API 密钥管理 中获取),为了您的财产和服务安全,该信息需要在后台处理。另外您也需要业务后台来管理用户会话,完成用户排队等功能。更多信息可查看 客户端与后台基础逻辑说明

部署客户端 Demo

JavaScript Demo

应用云渲染 JavaScript Demo 提供了基础的云渲染能力示例代码,支持包括 PC 浏览器、移动端 H5 页面以及小程序内嵌 WebView 等多种落地场景。
1. 下载TCGSDK,保存在本地 PC 的 C 或 D 盘内,或 Mac 的 Downloads 文件夹。保留该文件夹的路径(例如:c:/cloudgame-js-sdk)。
3. 替换 Demo 中的以下路径/参数,单击可查看 更多 JavaScript Demo 相关指引
需调整路径/参数
说明
src="path/to/tcg-sdk"
TCGSDK 的路径,例如:
src="./cloudgame-js-sdk/dist/tcg-sdk/index.js"
url = 'http://xxxx/StartProject'
xxxx替换为业务后台 Demo 的地址,例如:url = 'http://192.168.0.1:3000/StartProject'
ProjectId: 'project-id'
UserId: 'user-id'
ProjectId:控制台内创建的项目 ID
UserId:指当前连接至云渲染服务的终端用户的唯一标识,由业务方自定义,云渲染平台不予理解。(可根据业务需要决定使用用户的唯一身份标识或是使用时间戳随机生成;在用户重连时应保持 Userld 不变)
4. 对于移动端操作,应用云渲染官方有提供摇杆插件(Joystick),可用于映射键盘 WASD/上下左右按键。
5. 当用户在线数大于资源并发数量时,建议业务引入用户排队系统,提升用户体验。排队逻辑涉及前后台,前端代码可参考 排队示例,签名逻辑可以根据业务需求决定是否添加,后台部分请查看 技术接入-排队功能
6. 测试调试
如正确完成控制台操作,并成功部署业务后台和客户端,您可以通过 Chrome 浏览器(建议)打开 HTML 演示文件,画面加载成功后会显示云渲染画面,您可以通过鼠标拖动 / WASD 等方式与应用互动。如测试过程中遇到问题,请联系我们并提供 RequestId
TCGSDK 提供了丰富接口,您可以基于 Demo 开发更多功能,单击可查看接口文档


Android Demo

应用云渲染 Android 入门 Demo 提供了基础的云试玩能力,包含简单示例、虚拟键盘和一些常见 API 的使用,您可以在入门 Demo 的基础上运行您自己的云应用。下述内容将演示如何快速配置 Demo 运行云应用,步骤如下:
1. 单击 下载 Android 端入门 Demo 工程,将工程导入 AndroidStudio 工具。
2. 参考 云应用接入指南 集成应用。


iOS Demo

应用云渲染 iOS 入门 Demo 提供了基础的云试玩能力,包含简单入门 Demo、集成虚拟按键 Demo 以及在 Demo 中集成了一些常见的 API 使用,您可以在入门 Demo 的基础上运行您自己的云应用。下述内容将演示如何快速配置 Demo 运行云应用,步骤如下:
1. 单击 下载 iOS 端入门 Demo 工程。
2. 参考 iOS 快速入门 集成应用。