音视频通话 Web/uni-app 端参数配置说明
本文提供网易云信私有化部署过程中音视频通话（RTC）产品 Web/uni-app 端的关键参数配置说明，帮助技术工程师正确配置客户端与服务端连接参数，确保系统正常运行。
配置参数概述
网易云信音视频通话（RTC）私有化部署需要特定的配置参数才能正确连接到私有化环境。本文详细列出了 Web/uni-app 端所需的全部配置参数，包括参数名称、配置说明及示例。
配置流程说明
配置过程中请确保参数名称、格式完全匹配，任何错误都可能导致连接失败。
- 服务器部署：技术人员首先需要完成服务器端部署。
- 获取服务器配置参数：从部署完成的服务器获取配置 JSON 数据。
- 客户端配置：根据本文将服务器参数正确映射到客户端 SDK 中。
- 验证连接：测试客户端是否能正确连接到私有化环境。
关键参数解释
以下是一些关键 RTC 参数的概念解释：
- lbsServer：负责参数下发和首次访问的服务器地址，是 RTC 系统的入口点。
- channelServer：处理房间（Channel）创建、加入、离开等操作的服务器。
- roomServer：提供互动直播相关功能的服务器，包括旁路直播、合流录制等。
- QUIC 协议：一种基于 UDP 的可靠传输协议，提供比 TCP 更低的延迟。
- WebSocket：一种在单个 TCP 连接上进行全双工通信的协议。
Web 端在 NeRtcServerAddresses 结构里。
Web/uni-app 参数配置建议
以下表格给出了 Web/uni-app 端参数配置建议，其余参数一般不需要单独配置：
| 参数名 | 配置说明 | Web/uni-app | 备注 |
|---|---|---|---|
| lbsServer | 参数下发和第一跳访问地址。从 5.5.x 开始私有化需要配置 | NeRtcServerAddresses.lbsServer 域名 | 5.5.x 以后的客户端配相应服务器版本，需要这个配置 不配就没有参数下发能力 不配第一次加会会很慢 |
| channelServer | 加房间用的信令服务器地址 | NeRtcServerAddresses.channelServer 域名 | 必配，不然加不了房间 |
| statisticsServer | 统计上报服务相关地址 | NeRtcServerAddresses.statisticsServer 域名 | 不配，QS 和 指南针相关功能不可用 |
| statisticsDispatchServer | 统计上报服务相关地址 | NeRtcServerAddresses.statisticsServer 域名 | - |
| statisticsWebSocketServer | 统计上报服务相关地址（Web 端需要） | NeRtcServerAddresses.statisticsServer 域名 | - |
| statisticsBackupServer | 统计上报服务相关地址 | NeRtcServerAddresses.statisticsServer 域名 | - |
| roomServer | 互动直播服务地址 | NeRtcServerAddresses.roomServer 域名 | 旁路直播需要 |
| compatServer | 老版本的参数下发服务地址 | 无 | 参数下发版本兼容需要，建议必须配 |
| nosLbsServer | 内置对象存储服务地址 | 无（NIM SDK 有） | 所有涉及文档传输和存储的都需要。 例如日志上传和拉取 例如语音消息发送 例如图片发送 |
| nosUploadSever | 内置对象存储服务地址 | 无（NIM SDK 有） | - |
| nosTokenServer | 内置对象存储服务地址 | 无（NIM SDK 有） | - |
| quicProxyServer | quic 信令代理 | 不会用到 | 通常私有化不需要。 在用户的终端无法直接连上相应服务器的时候配置，典型的：内外网互通+云代理。 |
| websocketProxyServer | WebSocket 信令代理 | - | |
| statisticsProxyServer | 打点上报代理 | - | |
| mediaProxyServer | 媒体流转发代理 | - | |
| useIPv6 | 是否使用 IPv6 | - | 如强制使用 IPv6 |
配置示例
client
.join({
channelName: 'xxxxx',
uid: 1000,
token: 'xxxxxxxxxx',
neRtcServerProxyAddresses: {
channelServer: '代理服务器 domain', //只需要配置域名就行，后缀 SDK 会替换的
statisticsServer: '代理服务器 domain',
roomServer: '代理服务器 domain', // 如果有互动直播需求
statisticsWebSocketServer: '代理服务器 domain',
lbsServer: '代理服务器 domain',
}
})最后更新于