音视频通话 Android/iOS/鸿蒙/Linux/Windows/macOS 端参数配置说明

本文提供网易云信私有化部署过程中音视频通话（RTC）产品 Android/iOS/鸿蒙/Linux/macOS/Windows 端的关键参数配置说明，帮助技术工程师正确配置客户端与服务端连接参数，确保系统正常运行。

配置参数概述

网易云信音视频通话（RTC）私有化部署需要特定的配置参数才能正确连接到私有化环境。本文详细列出了 Android/iOS/鸿蒙/Linux/macOS/Windows 端所需的全部配置参数，包括参数名称、配置说明及示例。

配置流程说明

配置过程中请确保参数名称、格式完全匹配，任何错误都可能导致连接失败。

服务器部署：技术人员首先需要完成服务器端部署。
获取服务器配置参数：从部署完成的服务器获取配置 JSON 数据。
客户端配置：根据本文将服务器参数正确映射到客户端 SDK 中。
验证连接：测试客户端是否能正确连接到私有化环境。

关键参数解释

以下是一些关键 RTC 参数的概念解释：

lbsServer：负责参数下发和首次访问的服务器地址，是 RTC 系统的入口点。
channelServer：处理房间（Channel）创建、加入、离开等操作的服务器。
roomServer：提供互动直播相关功能的服务器，包括旁路直播、合流录制等。
QUIC 协议：一种基于 UDP 的可靠传输协议，提供比 TCP 更低的延迟。
WebSocket：一种在单个 TCP 连接上进行全双工通信的协议。

Android/iOS/鸿蒙/Linux/macOS/Windows 都在 NERtcServerAddresses 结构里，变量名同参数名。

参数配置建议

以下表格给出了 Android/iOS/鸿蒙/Linux/macOS/Windows 端参数配置建议，其余参数一般不需要单独配置：

参数名	配置说明	Android/iOS/鸿蒙/Linux/macOS/Windows	备注
lbsServer	参数下发和第一跳访问地址。从 5.5.x 开始私有化需要配置	serverAddress.lbsServer (桌面端变量名形式为 lbs_server，下同) `https://www.yunxin.asia:8176/api/v1/domains`	5.5.x 以后的客户端配相应服务器版本，需要这个配置不配就没有参数下发能力不配第一次加会会很慢
channelServer	加房间用的信令服务器地址	serverAddress.channelServer `https://www.yunxin.asia:8176/nrtc/getChannelInfos.action`	必配，不然加不了房间
statisticsServer	统计上报服务相关地址	serverAddress.statisticsServer `https://www.yunxin.asia:8176/report/statics/report/common/form`	不配，QS 和指南针相关功能不可用
statisticsDispatchServer	统计上报服务相关地址	serverAddress.statisticsDispatchServer `https://www.yunxin.asia:8176/lps-websocket/websocket/dispatch`	-
statisticsWebSocketServer	统计上报服务相关地址（Web 端需要）	不会用到	-
statisticsBackupServer	统计上报服务相关地址	serverAddress.statisticsBackupServer `https://www.yunxin.asia:81763/report/statics/report/nrtc2/sdkstats`	-
roomServer	互动直播服务地址	serverAddress.roomServer `https://www.yunxin.asia:8176/v2/sdk/rooms`	旁路直播需要
compatServer	老版本的参数下发服务地址	serverAddress.compatServer `https://www.yunxin.asia:8176/lbs/cc/nrtc/v2`	参数下发版本兼容需要，建议必须配
nosLbsServer	内置对象存储服务地址	serverAddress.nosLbsServer `https://www.yunxin.asia:8176/lbs/noslbs.jsp`	所有涉及文档传输和存储的都需要。例如日志上传和拉取例如语音消息发送例如图片发送
nosUploadSever	内置对象存储服务地址	serverAddress.nosUploadServer `https://www.yunxin.asia:8176`	-
nosTokenServer	内置对象存储服务地址	serverAddress.nosTokenServer `https://www.yunxin.asia:8176/report/sdklog/getToken`	-
quicProxyServer	quic 信令代理	-	通常私有化不需要。在用户的终端无法直接连上相应服务器的时候配置，典型的：内外网互通+云代理。
websocketProxyServer	WebSocket 信令代理	-	-
statisticsProxyServer	打点上报代理	-	-
mediaProxyServer	媒体流转发代理	-	-
useIPv6	是否使用 IPv6	false	如强制使用 IPv6

配置示例


// 初始化时设置
NERtcEngineContext context = new NERtcEngineContext();
context.setAppKey("XXXXXXXXXXXXXXX");
context.logDir = ""; // 你期望的日志路径 path
context.logLevel = logLevel.Info; // 建议用 info
if (needPrivateSetting) { // 走私有化环境
    NERtcServerAddress serverAddress = new NERtcServerAddress();
    //
    serverAddress.channelServer = "";
    serverAddress.lbsServer = "";
    serverAddress.compatServer = "";
    // 对象存储 -- 比如上传日志
    serverAddress.nosLbsServer = "";
    serverAddress.nosUploadServer = "";
    serverAddress.nosTokenServer = "";

    // 统计上报要用
    serverAddress.statisticsServer = "";
    serverAddress.statisticsDispatchServer = "";
    serverAddress.statisticsBackupServer = "";
    // 如果有互动直播转推服务的，需要设置
    serverAddress.roomServer = ";
    
    context.serverAddress = serverAddress;
}

// 设置完 context 相关参数后，再调用 engine 的初始化
engine.init(context, xxxxx);