本文介绍如何快速入门实时云渲染产品。

1.接入前的准备

1.1 推荐调试环境

1.2 接入前须知

应用要求

为了您发布的应用有最好的渲染体验，需要在上传平台前将应用设置无边框全屏显示，并设置播放实例显示模式自适，便于后续通过sdk设置应用分辨率。

1.2.2获取服务请求认证

调用云渲染ecloud-rcr sdk需要提供云渲染天翼云账号的Access Key Id 和Secret Access Key，具体参见获取账号认证密钥，为了您的账号和财产安全，您在接入sdk时可以在前端设置模糊密钥，以防止重要信息被截获。

1.2.3 云渲染通信原理说明

云渲染已集成了一套实时通信流程，您只需要引入云渲染 SDK即可实现H5和应用端的实时网络通信，更多信息参见了解云渲染通信基础。

2. 实时云渲染平台接入

2.1 开通云渲染服务

1. 接入平台前需要您注册天翼云账号，并通过天翼云账号开通云渲染服务。

1. 开通云渲染服务后，进入控制台，开始使用云渲染平台功能。

2.2 控制台云化应用

仅需三步即可实现通过云渲染平台实现应用云化，您需要上传资产、发布应用、测试应用，通过这些操作将应用运行至云渲染高配置实例中。

1. 上传资产

云渲染提供两种方式上传资产，若您的资产体积较大，可通过大文件上传工具上传资产，加快上传速度。

2. 发布应用

1. 资产上传成功后，即可发布应用让应用运行至云端节点。

2. 3D应用支持发布至多个区域，云渲染服务开通多个区域后算力调度将识别终端所在位置，自动接入最近节点。

3. 点击应用上架，生成应用测试链接。

3. 测试应用

应用发布成功后可通过渲染链接查看应用实时渲染效果，若应用启动不成功、启动效果不满意可通过以下步骤调试、修改：

1. 应用无法启动成功

• 应用一直处于加载中：检查应用启动是否需要配置启动参数。

• 应用结束运行：检查应用是否本地可运行，若持续出现问题请联系客服解决。

• 提示并发数已达最大：需要增加应用配置中的最大并发数。

• 提示超过允许带宽 BANDWIDTH_EXCEEDS：需要增加已购买的固定带宽数。

• 部分浏览器不支持webRTC，导致应用在此环境无法运行，建议在云渲染推荐的浏览器版本中做应用调试。

1. 应用启动过慢

• 对于渲染规格包周期用户，我们提供了应用预热的功能，您可以开启预热让节点秒速加载。

• 您可按照所属地域开通对应区域的云渲染服务，减少网络延迟带来的加载过慢问题。

1. 应用卡顿、延迟

• 您可打开应用右上角工具栏中的网络信息，查看是否是网络问题导致的丢包率过高，或更换网络访问。

• 配置应用码率，更换为流畅优先。

1. 应用无法与终端进行交互

• 是否应用配置开启了多点触控，开启多点触控后，需要应用安装云渲染插件才可进行交互。

3. 前端项目接入应用

3.1 部署客户端 Demo

3.2 ecloud-rcr SDK实战说明

以下将说明云渲染ECloud-RCR SDK的基本用法：

启动应用

在页面中引入初始化脚本。

<script src="/path/to/ecloud-rcr.umd.min.js"></script>复制

或代码中 import。

import { RCRLaunch, Keyboard, Launcher } from 'ecloud-rcr';复制

初始化构造器，创建实例连接会话，播放会话。

const bootstrap = async () => {
  try {
    const launch: Launcher = await RCRLaunch({
      appId,
      sa,
      sas,
      baseOptions: {
        startType: 1,
      },
      extendOptions: {
        onPlay: () => {},
      },
    });复制