一、在接入之前需要做哪些准备?
具体请参见 快速入门 和 接入 Demo。
二、业务可以获取到云渲染资源的公网 IP 来实现访问白名单或者其他功能吗?
不可以,因为云渲染服务提供的外网 IP 是不固定的。需要业务放开对所有来源 IP 使用 UDP 8000 端口限制,如无特殊安全问题,建议放开所有 UDP 端口限制。
三、应用云渲染是否支持用户排队?
应用云渲染的排队页面是需要业务方来开发的,相关功能请参见 排队功能。
四、UserId 和 RequestId 分别指的什么?
UserId 是业务方自定义并传给云渲染服务的用户唯一标识字符串,例如 user123456。云渲染服务接到请求的云 API 之后,会返回给业务方一个 RequestId,例如 01fdc815-c4e7-4642-819e-a011856dfd5a1。
五、如何查看 RequestId?
·如使用效果测试/快速上线链接,可以打开主页面工具栏中的“调试”(快捷键Ctrl+~),最下方有 RequestId 信息。
·在 Chrome 浏览器开发者工具中 NetWork 获取 CreateSession 的 RequestId。
·如 接入了云渲染 SDK,云 API 返回值中包含 RequestId,建议业务后台记录下来。
六、如何查看网络、CPU\\GPU 使用率等信息?如何选择合适的并发规格?
你可以打开 效果测试/快速上线 页面的工具栏中的“调试”(快捷键Ctrl+~),并关注以下数据,以选择最合适的并发规格:
·FPS(帧率):正常情况下帧率应保持在30以上。如你发现进入某些特定场景,或进行特定操作时,帧率突然下降,可能是因为此时对 GPU 算力的消耗突然增加,而目前规格的并发带不动,从而导致掉帧,建议你尝试更高规格的并发。
·RTT(往返时延):当RTT高于100ms,可能具有明显的延迟感。建议你先检查本地网络是否有抖动问题,可以尝试使用4G/5G网络访问。如果并发区域距离你的物理位置过远,也会造成RTT过高。
·Region(并发区域):即并发所在的区域。“云渲染会根据终端用户的 IP 地址,自动调度距离最近的空闲并发”。如你发现并发区域距离过远,可能是距离更近的空闲并发数量不足导致的,请联系我们帮助你解决。
·InstanceType(并发规格):云渲染并发规格分为 S、M、L、XL,分别适用于小型、中型、大型和超大型应用,详细配置请参考计费说明文档。如你的应用对算力要求很高,却使用了较低规格的并发,可能导致 CPU/GPU 使用率过高,从而导致卡顿、闪退等问题。
·CpuUsage(CPU 使用率):如果你发现 FPS 数据下降,检查是否出现了90 – 100%的 CPU 使用率,若是,说明该并发规格不足以处理负载,请尝试更高规格的并发。
·GpuUsage(GPU 使用率):关注L(load)的数值即可。如果你发现 FPS 数据下降,可以看下L是否出现了90 – 100%的数值,若是,说明该并发规格不足以处理负载,请尝试更高规格的并发。
·RequestId:如遇到问题/疑问,请尽量保持连接,同时联系我们并提供 RequestId。
七、效果测试/快速上线生成的链接都有哪些 URL 参数
为方便业务快速测试、上线使用,应用云渲染提供 Web 体验页。你可以针对不同应用和项目生成不同访问密码。此外,该体验 URL 支持一系列可选参数,举例说明:
https://ex-cloud-gaming.crtrcloud.com/cloud_gaming_web/demo/index.html?password=0IY5OF8C&livepush=1
该链接末尾添加了两个参数:password、livepush。你可根据需求取消这两个参数,或自定义增加其他参数。详细参数描述如下:
| URL 参数 | 说明 |
| password | 密码,通过控制台 效果测试 / 快速上线 生成。填入后自动填入密码框,不需要用户手动填写,但不会直接进入应用体验画面不传:不预填密码,不跳过密码输入界面。传值:例如 https://ex.cloud-gaming.myqcloud.com/cloud_gaming_web/demo/index.html?password=123456,将会自动输入密码123456,但不直接进入应用体验画面,需要用户手动点击启动。自动填入密码,但不会跳过该界面,需要用户手动点击启动 |
| code | 密码,通过控制台 效果测试 / 快速上线 生成。填入后自动填入密码框,并直接进入应用画面不传:不预填密码,不跳过密码输入界面。传值:例如https:…/demo/index.html?code=123456,将会自动输入密码123456,并直接进入应用体验画面。跳过输入密码页面,直接开始加载并进入应用画面 |
| livepush | 推流功能,可将云渲染画面推流至指定地址。使用该功能前需要在控制台开启 云端推流服务-推流至指定地址,且会产生一定费用,参见 计费说明。1:在工具箱中显示推流功能,示例https:…/demo/index.html?para1=xxx¶2=xxx&livepush=1不传:在工具箱中不显示推流功能推流功能 |
| mic | 麦克风上行功能true:开麦,获取用户麦克风声音并传至云端,示例https:…/demo/index.html?para1=xxx¶2=xxx&mic=truefalse(默认):不开启麦克风用户需要主动授权才能正常使用麦克风 |
| camera | 是否开启本地摄像头true:开摄像头,获取用户摄像头数据并传至云端,示例https:…/demo/index.html?para1=xxx¶2=xxx&camera=truefalse(默认):不开启摄像头用户需要主动授权才能正常使用摄像头 |
| interact | 设置云端应用交互模式touch:将移动端用户触摸操作以 touch 事件传入云端应用(应用本身需支持通过触摸事件操作),示例https:…/demo/index.html?para1=xxx¶2=xxx&interact=touchcursor(默认):将移动端用户触摸操作以键鼠事件传入云端应用说明:该参数建议仅在移动端使用,PC 端设置该参数会导致鼠标锁定。 |
| joystick | 是否显示虚拟摇杆(将触摸事件转换为键盘wasd事件传至云端应用)show:显示摇杆,示例https:…/demo/index.html?para1=xxx¶2=xxx&joystick=show不传:不显示摇杆红框处为虚拟摇杆说明:该参数建议仅在移动端使用。 |
| dpad | 是否显示跳跃按钮(将触摸事件转换为键盘空格按键事件传至云端应用)show :显示跳跃按钮,示例https:…/demo/index.html?para1=xxx¶2=xxx&dpad=show不传:不显示跳跃按钮红框处为跳跃按钮说明:该参数建议仅在移动端使用。 |
| settingbar | 是否显示工具箱hide:隐藏工具箱,示例https:…/demo/index.html?para1=xxx¶2=xxx&settingbar=hideclose:显示工具箱且默认为收起状态open(默认):显示工具箱且默认为展开状态工具箱,点击可展开更多功能 |
| latency | 是否显示RTT(延迟) FPS(帧率)信息栏hide:隐藏信息栏,示例https:…/demo/index.html?para1=xxx¶2=xxx&latency=hide不传:显示信息栏 |
| logo | 自定义 logo 图片地址http/https不传:使用默认腾讯云渲染 Logo传图片地址:支持png/jpg格式,建议不超过3MB,尺寸建议高90px,宽360px。示例 https://ex.cloud-gaming.myqcloud.com/cloud_gaming_web/demo/index.html?logo=https://qcloudimg.tencent-cloud.cn/raw/5e1434b0dd32f26d9f064853aef02a33.png自定义Logo示例 |
| fullscreen | 是否自动全屏true:开启自动全屏,示例https:…/demo/index.html?para1=xxx¶2=xxx&fullscreen=true不传:不自动全屏说明:传 true 时前端会尝试自动全屏,但由于受浏览器限制,不一定能保证自动全屏。一般在 Android 端可以生效,在 PC 或 iOS 上往往因浏览器限制无法生效,仍需要用户主动点击全屏按钮。 |
| userid | 用户终端用户的唯一标识,由业务方自定义不传:默认使用随机数说明:若你需要测试不同用户连接使用的情况,例如测试 存档功能 是否成功保证了用户 A 和 B 有不同存档,可以通过传不同 userid 模拟。例如让 A 和 B 分别使用下面两个链接:用户 A:https:…/demo/index.html?userid=user001用户 B:https:…/demo/index.html?userid=user002则 COS 中应该分别保存有 user001 和 user002 的存档文件,用户 A 和 B 的存档进度应当不同,单击查看详细存档功能相关介绍。注意:同一 UserId 同一时间只能使用一个并发举例说明:用户A 正在访问https:…/demo/index.html?userid=user001,此时用户B使用相同链接访问,由于 Userid 均为 user001,将被云渲染平台识别为同一个用户,云渲染平台将自动把用户A目前已连接使用的并发给到用户B使用,用户A会出现黑屏断连。若不传 userid,将默认使用随机数。但由于浏览器缓存机制,相同浏览器中的不同页签会使用相同 userid,因此多个页签也只能占用一个并发实例。此外,如果不传 userid,由于浏览器缓存可能被清除,可能导致隔天再使用时 userid 变化了,导致用户存档文件丢失。 |
| idle | 空闲断连时长,若用户长时间没有操作,超过该时长将自动退出并发,避免资源浪费不传:默认300s传值:支持正整数值,示例https:…/demo/index.html?para1=xxx¶2=xxx&idle=100提前10s弹窗提示,超过后自动释放并发实例 |
| paste | 是否允许粘贴本地文本至云端true(默认):开启粘贴功能false:关闭粘贴功能;示例 https:…/demo/index.html?paste=false |