tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
应用云渲染
    文档
    Download PDF

    接入相关

    最后更新时间：2024-09-27 18:42:25
    下载PDF

      在接入之前需要做哪些准备?

      具体请参见 快速入门 和 接入 Demo。

      应用云渲染云 API 的 Region 参数指的是并发资源地区吗？

      不是。Region 是云 API 的公共参数，在应用云渲染的云 API 中是不需要填的。应用云渲染服务会根据 UserIP 选择最优接入区域，不需要业务指定。

      业务可以获取到云渲染资源的公网 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?env=intl&password=0IY5OF8C&livepush=1
      该链接末尾添加了三个参数：env、password、livepush。您可根据需求自定义增加其他参数。详细参数描述如下：
      URL 参数
      说明
      env
      用于指定体验环境。请不要修改或删除该参数，避免影响正常使用。
      password
      密码，通过控制台 效果测试 / 快速上线 生成。填入后自动填入密码框，不需要用户手动填写，但不会直接进入应用体验画面
      不传：不预填密码，不跳过密码输入界面。
      传值：例如 https://ex.cloud-gaming.myqcloud.com/cloud_gaming_web/demo/index.html?env=intl&password=123456，将会自动输入密码123456，但不直接进入应用体验画面，需要用户手动点击启动。
      自动填入密码，但不会跳过该界面，需要用户手动点击启动
      自动填入密码，但不会跳过该界面，需要用户手动点击启动
      
      code
      密码，通过控制台 效果测试 / 快速上线 生成。填入后自动填入密码框，并直接进入应用画面
      不传：不预填密码，不跳过密码输入界面。
      传值：例如https:.../demo/index.html?env=intl&code=123456，将会自动输入密码123456，并直接进入应用体验画面。
      跳过输入密码页面，直接开始加载并进入应用画面
      跳过输入密码页面，直接开始加载并进入应用画面
      
      livepush
      推流功能，可将云渲染画面推流至指定地址。使用该功能前需要在控制台开启 云端推流服务-推流至指定地址，且会产生一定费用，参见 计费说明。
      1：在工具箱中显示推流功能，示例https:.../demo/index.html?para1=xxx&para2=xxx&livepush=1
      不传：在工具箱中不显示推流功能
      推流功能
      推流功能
      
      mic
      麦克风上行功能
      true：开麦，获取用户麦克风声音并传至云端，示例https:.../demo/index.html?para1=xxx&para2=xxx&mic=true
      false（默认）：不开启麦克风
      用户需要主动授权才能正常使用麦克风
      用户需要主动授权才能正常使用麦克风
      
      camera
      是否开启本地摄像头
      true：开摄像头，获取用户摄像头数据并传至云端，示例https:.../demo/index.html?para1=xxx&para2=xxx&camera=true
      false（默认）：不开启摄像头
      用户需要主动授权才能正常使用摄像头
      用户需要主动授权才能正常使用摄像头
      
      interact
      设置云端应用交互模式
      touch：将移动端用户触摸操作以 touch 事件传入云端应用（应用本身需支持通过触摸事件操作）,示例https:.../demo/index.html?para1=xxx&para2=xxx&interact=touch
      cursor（默认）：将移动端用户触摸操作以键鼠事件传入云端应用
      说明：
      该参数建议仅在移动端使用，PC 端设置该参数会导致鼠标锁定。
      joystick
      是否显示虚拟摇杆（将触摸事件转换为键盘wasd事件传至云端应用）
      show：显示摇杆，示例https:.../demo/index.html?para1=xxx&para2=xxx&joystick=show
      不传：不显示摇杆
      红框处为虚拟摇杆
      红框处为虚拟摇杆
      
      说明：
      该参数建议仅在移动端使用。
      dpad
      是否显示跳跃按钮（将触摸事件转换为键盘空格按键事件传至云端应用）
      show ：显示跳跃按钮，示例https:.../demo/index.html?para1=xxx&para2=xxx&dpad=show
      不传：不显示跳跃按钮
      红框处为跳跃按钮
      红框处为跳跃按钮
      
      说明：
      该参数建议仅在移动端使用。
      settingbar
      是否显示工具箱
      hide：隐藏工具箱，示例https:.../demo/index.html?para1=xxx&para2=xxx&settingbar=hide
      close：显示工具箱且默认为收起状态
      open（默认）：显示工具箱且默认为展开状态
      工具箱，点击可展开更多功能
      工具箱，点击可展开更多功能
      
      latency
      是否显示RTT（延迟） FPS（帧率）信息栏
      hide：隐藏信息栏，示例https:.../demo/index.html?para1=xxx&para2=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示例
      自定义Logo示例
      
      fullscreen
      是否自动全屏
      true：开启自动全屏，示例https:.../demo/index.html?para1=xxx&para2=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&para2=xxx&idle=100
      提前10s弹窗提示，超过后自动释放并发实例
      提前10s弹窗提示，超过后自动释放并发实例
      
      paste
      是否允许粘贴本地文本至云端
      true（默认）：开启粘贴功能
      false：关闭粘贴功能；示例 https:.../demo/index.html?paste=false
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款