什么是应用云渲染
应用云渲染是一套整合了应用管理、并发资源管理与调度、音视频串流等能力的 PaaS 产品。它可以在云端并发实例上运行您开发好的应用 (EXE/APK 应用），终端用户无需下载应用包即可通过小程序、网页等体验应用。我们提供的终端 SDK 可将并发实例中渲染出来的音视频结果传输到终端，并将终端用户的操作实时发送给并发实例，您仅需确保应用可在 Windows Server 或 Android 环境正常运行，无需任何特殊插件即可轻松实现应用云化。
注册腾讯云账号并申请应用云渲染
1. 若您未注册腾讯云账号，请前往 注册腾讯云账号。
2. 申请应用云渲染服务 后即可进入控制台。
说明：
应用云渲染接入
接入前，希望您先理解应用、项目和并发三个基础概念的关系。
应用：您开发好的应用程序，需要确保可在 Windows Server 或 Android 环境下稳定运行。您需在控制台上传应用，让它在云端运行。
项目：您可以通过项目将并发分组，并通过关联应用来指定可以使用这些并发的应用。您可针对一个应用新建不同项目，满足不同的测试、上线场景而无需重复上传应用。
并发：即应用云渲染唯一计费项，一个并发即一台虚拟化的云端实例（包括 CPU、带宽、磁盘、GPU 等虚拟计算资源），用于在云端运行您的应用。如需了解并发配置、规格等详细信息，请查看 计费说明。
在控制台中，建议您按照上传应用、新建项目、购买并发的顺序操作，得到一个关联某款应用，并且分配有可用并发的项目。然后您可以针对该项目和应用进行效果测试，体验应用云化的基础效果，并选出最合适的并发规格。完成效果测试后，您可以对项目进行上线发布，我们支持：
0开发，在控制台上通过简单配置快速生成一个标准化的前端页面。
通过我们提供的接入 Demo，搭建自己的后台服务和客户端程序，从而满足您独特的业务需求。
步骤1：新建应用
1. 上传应用：
1.1 在上传至云渲染平台前，
建议您先将应用设置为无边框全屏模式并开启自适应桌面分辨率
，便于后续使用 自适应分辨率 功能，实现画面全屏、自适应终端设备分辨率且无黑边的效果。这步操作需要在应用层面完成。
有些应用可以在设置中调整显示模式，将调整后生成的配置文件一同打包上传至控制台即可。下图为某应用的全屏设置示例：
您也可以在应用开发时调整相关显示配置。UE 应用可以参考下面一段蓝图加到 Map 的 BeginPlay 里面开启自适应桌面分辨率。其中 In Fullscreen Mode 应该配置为 Windowed Fullscreen（窗口化全屏）。
Unity 应用可以参考下图配置为全屏模式。
注意：
应用独占全屏不属于无边框全屏模式
如何区分无边框全屏和独占全屏
无边框全屏应用按 Alt+Tab 切换窗口不会导致显示器闪烁，独占全屏应用切换会有闪烁的现象。
1.2 将应用压缩打包为 ZIP / RAR / 7z 文件，在我的应用处单击新建应用上传压缩包，等待应用创建完成。
请使用 UTF-8 编码进行压缩（建议使用 7-Zip），否则可能导致解压后的文件或文件夹名称出现乱码等问题；
应用云渲染支持云 3D、云 XR 和云 APK 三种应用类型：
云 3D：非 AR/VR 类桌面应用，键鼠或触摸操控，例如 UE/Unity 虚拟应用、PC 游戏等。在云端运行的应用需为 EXE 格式，可适配网页、小程序、Android/IOS App 等终端。
云 XR：VR/AR/MR 应用，通常用双手柄操控，在云端运行的 XR 应用需为 EXE 格式，可适配 Pico/Oculus、手机/Pad、PC、全息等终端。
云 APK（内测中）：APK 格式应用。
说明：
目前云 APK 内测中，咨询请联系您的商务/架构师。
为保证云 XR 应用的体验，请在上传完应用（步骤1）并新建好项目（步骤2）后，提供项目 ID（cap-xxxx）给我们进行必要后台配置，您可以通过商务/架构师联系到云渲染工作人员 。
2. 进行应用配置
主执行程序路径：为避免填写错误导致应用无法正常启动，建议您等待应用创建完成后直接单击选择获取启动路径。
云端画面捕捉区域：
如果您已根据 前文1.1步骤，已将应用调整为无边框全屏模式并开启自适应桌面分辨率，请将画面捕捉模式设置为捕捉整个桌面。
如您的应用只有非全屏窗口模式，无法调整为无边框全屏模式，可以使用仅捕捉应用窗口模式。您需要 根据文档指引，填写正确的应用窗口名称和类名。当开发过程中未自定义窗口标题时，Demo.exe 启动后的窗口名称一般为 Demo；如您的应用是 UE 应用，类名一般为 UnrealWindow。
详细配置说明请查看 应用配置 和 应用增值功能（日志上传与用户存档功能）。
步骤2：新建项目并在项目下购买并发
默认测试项目（Test Project）说明：
如您期望购买并发并正式上线使用，请新建一个项目。
1. 新建项目，关联上传的应用并指定并发规格。
项目类型：支持单应用独享和多应用共享两种类型的项目。单应用独享类型可以确保项目下的并发包仅被单个应用使用，而多应用共享类型下的并发包则可以作为“资源池”被多个应用共享使用。单击查看 如何通过多应用共享项目实现并发资源共享。
并发规格：一个项目下的并发规格需一致。您可以针对一个应用新建多个项目，指定不同规格的并发，从而测试不同规格并发的运行效果。建议您从 L / XL型开始测试，避免因并发性能不满足应用运行需求导致卡顿等问题。不同规格并发的具体配置请参考 计费说明。
项目高级设置：项目允许自定义帧率、码率范围、默认云端桌面分辨率、应用启动参数、预启动、等待重连时长等参数，您可根据需求调整。
2. 在项目下购买并发包，等待并发包创建完成后，可以进入下一步效果测试。
步骤3：效果测试
在项目的操作处，单击效果测试，生成体验链接和密码。进入体验页面，测试应用云化的基础效果。
您可以打开效果测试页面的工具栏中的“调试”（快捷键
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。您也可以通过以下方式获取 RequestId：
在 Chrome 浏览器开发者工具中 NetWork 获取 CreateSession 的 RequestId。
如在下文步骤4-方式二中接入了云渲染 SDK，云 API 返回值中会包含 RequestId，建议业务后台记录下来。
效果测试常见问题说明：
提示“没有空闲并发”：
控制台查看请求项目下是否有空闲并发，“上一个用户退出后并发需进行自动清理（约1分钟），完成清理后才会恢复空闲可用状态并被下一个用户使用”。
应用无法启动或黑屏：
若一直在启动中/加载中，无法进入：如果正在使用 Wi-Fi 或公司内网，可先用手机4G网络测试，若4G网络可以访问云渲染服务，说明 Wi-Fi 或公司内网可能限制了 UDP。应用云渲染服务网络依赖 UDP 数据收发，用户端需要放开访问 UDP 8000 出口端口的限制，如无特殊安全问题，建议放开所有 UDP 端口限制。
若提示建议“启动失败，请检查应用启动路径配置”：检查是否正确填写了 应用主执行程序路径 。
若进入后，没有加载出应用画面/黑屏：如该应用 使用了捕捉应用窗口模式，需确保窗口名称与类名已正确填写，否则将会是黑屏画面。
应用启动慢：
多应用共享类型的项目不支持预启动（即在并发实例中提前运行应用从而让用户使用时可以直接进入加载后的画面），因此应用启动时间相对会增加。
单应用独享类型的项目可以开启预启动，从而实现应用秒开加载。
上一个用户退出后并发会被回收和清理重置，待恢复空闲可用状态后并发会重新进行应用预启动。如果下一个用户在并发刚恢复空闲时进入，可能预启动尚未完成。
延时高/RTT数据不正常：建议您先检查本地网络是否有抖动问题，可以尝试使用4G/5G网络访问。
卡顿：有可能是因为应用对算力要求较高而使用了过低规格的并发（如 S 型），建议您先尝试更高规格并发的效果。
提示“云渲染连接已断开”：如您使用了公司 Wi-Fi 网络，建议您检查网络是否满足 应用云渲染服务环境，即已开放 UDP 端口限制。同时您也可以检查本地网络是否有抖动问题，可以尝试使用 4G/5G 移动网络访问。
步骤4：上线发布
方式一：0开发快速上线
方式二：接入云渲染 PaaS
为实现您的独特业务需求、保证最佳用户体验，您可以进行后台与客户端开发来搭建自己的后台服务和客户端程序，接入应用云渲染 PaaS 提供 云 API 和各终端 SDK（JavaScript SDK、Android SDK、iOS SDK）。您无需从头开始接入，我们提供接入 Demo 帮助您快速实现业务上线。
1. 部署业务后台 Demo
业务后台必须部署无法省略：
因为访问应用云渲染 云 API 服务需要提供腾讯云账号的 SecretId 和 SecretKey（可在 控制台 API 密钥管理 中获取），为了您的财产和服务安全，该信息需要在后台处理。另外您也需要业务后台来管理用户会话，完成用户排队等功能。更多信息可查看 客户端与后台基础逻辑说明。
2. 部署客户端 Demo（以 JavaScript Demo 为例）
2.1 下载 TCGSDK，保存在本地 PC 的 C 或 D 盘内，或 Mac 的 Downloads 文件夹。保留该文件夹的路径（例如：
c:/cloudgame-js-sdk）。2.2 下载 Demo HTML 文件。
2.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：控制台内创建的项目 IDUserId：指当前连接至云渲染服务的终端用户的唯一标识，由业务方自定义，云渲染平台不予理解。（可根据业务需要决定使用用户的唯一身份标识或是使用时间戳随机生成；在用户重连时应保持 Userld 不变）注意： 同一 UserId同一时间只能使用一个并发。若客户端Demo中的 UserId 被设定为固定值而不是随机数，那么当不同用户请求连接云渲染时，会被识别成同一个用户，导致互相抢占同一个并发实例，云渲染会自动把目前已连接使用的并发给到最近一次请求的用户设备，原来的用户设备会出现黑屏断连。 |
2.4 对于移动端操作，应用云渲染官方有提供摇杆插件（Joystick），可用于映射键盘 WASD/上下左右按键。
2.5 当用户在线数大于资源并发数量时，建议业务引入用户排队系统，提升用户体验。排队逻辑涉及前后台，前端代码可参考 排队示例，签名逻辑可以根据业务需求决定是否添加，后台部分请查看 技术接入-排队功能。
3. 测试调试，业务上线
如正确完成控制台操作，并成功部署业务后台和客户端，您可以通过 Chrome 浏览器（建议）打开 HTML 演示文件，画面加载成功后会显示云渲染画面，您可以通过鼠标拖动 / 键盘输入等方式与应用互动。您可以基于 Demo 进行更多定制化开发。测试 CheckList 参考：
移动端& PC 端的鼠标、键盘、触摸交互操作体验是否正常。
尤其需注意移动端，由于应用运行在云端 Windows 系统上，当云渲染 Web 页面运行在用户的 Android/iOS 的浏览器中时，用户触摸消息被转换为鼠标消息传至云端 Windows 系统。因此，为保证体验，您可能需要对应用做些适配，详细请查看 鼠标、键盘、触摸交互处理。
若应用内有麦克风语音和摄像头功能，需测试是否正常。
- 终端用户需授权使用麦克风/摄像头数据，如获取权限失败，会导致麦克风/摄像头上行功能异常。
- Web 端需要域名开启 HTTPS 协议才能正常获取麦克风/摄像头权限。
提示最终用户检查本地网络是否满足 应用云渲染服务环境。
应用云渲染服务基于 WebRTC 协议，数据传输依赖 UDP。如果出现了必现的连通性问题请检查网络配置是否限制了 UDP，如无特殊安全问题，请放开 UDP 的限制，或者使用其他无网络限制的环境测试。
注意不要仅使用一个并发来测试，应注意测试多用户同时连接的情况。
同一
UserId 同一时间只能使用一个并发。若客户端Demo中的 UserId 被设定为固定值而不是随机数，那么当不同用户请求连接云渲染时，会被识别成同一个用户，导致互相抢占同一个并发实例，云渲染会自动把目前已连接使用的并发给到最近一次请求的用户设备，原来的用户设备会出现黑屏断连。因此，请注意正确设置 UserId，并使用多个并发测试多人同时在线的效果。相关指引：
技术接入文档：包括排队功能、数据通道、心跳连接、自适应分辨率、启动麦克风等详细指引。
最佳实践文档：基于全真互联未来会场小程序案例，剖析如何接入应用云渲染产品，如何使用排队、数据通道、多点触控、自适应分辨率等功能。
JavaScript SDK 接口文档和 Demo：包括 JavaScript Demo 和 TCGSDK 丰富接口的详细说明文档，方便业务基于JavaScript Demo 进行定制化开发。
Android SDK 接口文档和 Demo：包括 Android SDK 的详细说明文档，以及三个示例工程和一个用于体验的 APK。
iOS SDK 接口文档和 Demo：包括 iOS SDK 的详细说明文档，以及集成 SDK 的简单 Demo。
附录
业务后台与客户端基础逻辑说明
1. 客户端初始化云渲染 SDK：
无论您使用的哪种客户端，在初始化 SDK 成功后都可以获取到 ClientSession。ClientSession 将用于后续业务 Server 获取 ServerSession，各端具体初始化及获取方式如下：
JavaScript SDK：调用 TCGSDK.init(params) 接口完成初始化构建。初始化完成后，客户端调用 TCGSDK.getClientSession() 函数，获取 Client 端的 ClientSession。
Android SDK：通过 TcrSdk.getInstance().init(context, null, callback) 接口完成SDK初始化。初始化完成后，客户端在 TcrSession.Observer#onEvent中收到 STATE_INITED 通知后，获取 Client 端的 ClientSession。
2. 后台服务锁定应用云渲染并发：
您的后台服务调用云渲染 API ApplyConcurrent() 锁定云渲染并发，收到成功回调后执行下一步。
3. 后台服务获取 ServerSession：
您的后台服务调用云渲染 API CreateSession(ClientSession) ，获取成功回调中的 ServerSession 返回给客户端。
4. 启动云渲染服务：
各端 SDK 在收到 ServerSession 后启动云渲染服务的调用方式略有不同，请根据您的需求查看对应指引。
JavaScript SDK：客户端调用 TCGSDK.start(ServerSession) 函数启动云渲染。
Android SDK：客户端调用 TcrSession.start(serverSession,callback) 函数启动云渲染。
