# 前提条件 * 操作系统为图形化界面 * 终端 * 安装最新版本的 Chrome 浏览器，并设置为默认浏览器 * 已获取 RTS [快速开始 Demo 工程文件](https://docs.volcengine.com/docs/6348/1163814) # 操作步骤 ## 步骤 1：获取 AppId 和临时 Token 申请临时 Token 后，你应记录下申请时的房间 ID，用户 ID 和对应生成的临时 Token，以供后续配置环境和加入房间时使用。 > 注意： > * 参看[开通服务](https://docs.volcengine.com/docs/6348/69865)和[使用临时 Token](https://docs.volcengine.com/docs/6348/70121#%E7%94%9F%E6%88%90%E4%B8%B4%E6%97%B6-token) 获取 APP_ID 和临时 TOKEN。 > * 生成临时 TOKEN 时，房间 ID 可传任意值。 > * 临时 TOKEN 仅用于测试或跑通 Demo，你可以通过阅读[密钥说明](https://www.volcengine.com/docs/6348/70121)了解更多 Token 相关说明。 > * 建议至少申请两个不同 token 对应不同的 User ID ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_40ca5f6fd69216f9264ed90f9c0a32ce.png) ## 步骤 2：配置 Demo 工程文件 1. 全局安装 Node.js； 2. 使用 npm 全局安装 yarn ：`npm install -g yarn`； 3. 修改配置文件，在 Demo 工程根目录中找到`./js/config.js`（Basic）或`./src/Config.ts`（React）配置文件，并在以下字段中填入对应信息： * `appId`：填写你的 AppID； * `userId`：填写你的用户 ID； * `token`：填写用户 ID 和对应 Token。 ```typescript export const Config = { appId: 'yourAppId', tokens: [ { userId: 'yourUserId1', token: 'yourToken1', }, { userId: 'yourUserId2', token: 'yourToken2', }, // ... ], }; ``` ## 步骤 3：编译运行 1. 打开终端，进入 Demo 工程文件根目录； 2. 运行`yarn`命令安装所需的依赖项，请耐心等待安装完成； 3. 运行`yarn dev` 命令启动 Demo。 * Basic Demo 将在 1234 端口运行。请在浏览器中打开 http://localhost:1234/?userId=XXX，将 “XXX” 替换成步骤 2 配置文件中填写的 userId 即可。你可以打开两个网页进行相互通信: * http://localhost:1234/?userId=user_1 * http://localhost:1234/?userId=user_2 * React Demo 将在 3000 端口运行。请在浏览器中打开 http://localhost:3000/?userId=XXX，将 “XXX” 替换成步骤 2 配置文件中填写的 userId 即可。你可以打开两个网页进行相互通信: * http://localhost:3000/?userId=user_1 * http://localhost:3000/?userId=user_2 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_22e60a0bdb00f13c42da2c40872e2201.png) ## 步骤 4：体验 Demo 功能 ### 发送点对点自定义消息点对点自定义消息不需要用户进房。在左侧输入框输入接收端用户 ID，在右侧输入框输入消息内容，点击“发送”按钮： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b3b8a0d53d50b749f5398474bcbf2d3a.png) ### 发送点对点邀请消息点对点邀请消息不需要用户进房。输入目标用户 ID 后点击“发送邀请消息”按钮： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6f561b6cd9e5d39f97de95fbeeb21550.png) ### 进房/离房用户进房后，可以向房间内所有用户发送广播消息。 * 进房：输入房间 ID 后点击“加入房间”按钮 * 离房：点击“离开房间”按钮 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_232f4754684621c18d8b3076884724fa.png) ### 在房间内发送自定义广播消息可以将自定义消息广播至特定房间，房间内所有用户均可以收到消息： 1. 输入房间 ID； 2. 点击“加入房间”按钮进房； 3. 成功进房后，输入房间自定义消息； 4. 点击“发送”按钮, 同一个房间内的所有其他用户将收到该消息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_18ef474681339ca10f4c0471d74edadc.png) ### 在房间内发送全员禁言消息全员禁言消息是一种具有特定 JSON 结构的自定义广播消息，在`JSON.stringify()`之后将内容传输给房间内所有用户： 1. 输入房间 ID； 2. 点击“加入房间”按钮进房； 3. 成功进房后，点击“发送全员禁言消息”按钮，同一房间内的其他所有用户将收到该消息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0b803dadce89ac062c352ab3cb17c688.png)

实时音视频