网易会议 Android/iOS/Windows/macOS 端参数配置说明
本文提供网易云信私有化部署过程中网易会议产品 Android/iOS/Windows/macOS 端的关键参数配置说明,帮助技术工程师正确配置客户端与服务端连接参数,确保系统正常运行。
配置参数概述
网易会议系统是一个综合性的视频会议产品,包含 IM、RTC、白板等多个子系统,需要配置的参数较为复杂。本文详细列出了 AOS/iOS/Windows/macOS 端所需的全部配置参数,包括参数名称、配置说明及示例。
配置流程说明
配置过程中请确保参数名称、格式完全匹配,任何错误都可能导致连接失败。
- 服务器部署:技术人员首先需要完成服务器端部署。
- 获取服务器配置参数:从部署完成的服务器获取配置 JSON 数据。
- 客户端配置:根据本文将服务器参数正确映射到客户端 SDK 中。
- 验证连接:测试客户端是否能正确连接到私有化环境。
关键参数解释
会议系统包含多个子系统,每个子系统都需要特定的配置:
- 白板系统:提供实时协作白板功能,包括绘图、文档共享等
- roomkit:会议房间管理模块,处理房间创建、加入等基础操作
- meeting 服务:提供会议预约、管理、控制等业务逻辑功能
参数配置建议
IM 模块
参数名 | 配置说明 | Android/iOS/Windows/macOS |
---|---|---|
weblbsUrl | Web 端获取客户端连接 link 的地址(客户端会请求 LBS 地址,LBS 会返回一连串能连接的 link 数组给客户端登录) | 无 |
link_web | Web 默认 link 地址(在 LBS 获取不到 link 的情况下,请求默认 link 连接) | 无 |
link_ssl_web | Web 端使用使用 HTTPS 连接 | 无 |
nos_Support_Https | nos 是否开启 HTTPS | https_enabled |
nos_uploader_web | 分片/非分片共用文件上传地址,浏览器默认分片,小程序默认不分片(不分片是用表单来做的上传) | 无 |
lbs | IM LBS 服务器地址,通过它获取 IM link 地址信息 | lbs |
link | IM 默认的 link 服务器地址,当 IM LBS 不可用时先连接该地址 | link |
nos_lbs | NOS 上传 LBS 服务器地址 | nos_lbs |
nos_uploader | NOS 上传默认的 link 服务器地址,当 NOS LBS 不可用时先连接该地址 | nos_uploader |
nos_uploader_host | NOS 上传服务器主机地址(仅 nos_Support_Https=true 时有效,用作 HTTPS 上传时的域名校验及 http header host 参数填充) | nos_uploader_host |
module | 连接网易云信服务器加密数据通道的公钥参数 | module |
nos_downloader | NOS 下载地址拼接模板,用于拼接最终得到的下载地址 | nos_downloader |
nos_accelerate | NOS 下载加速域名/地址,用于替换 NOS 下载 url 中的 nosDownload。[4.6.0 版本新增] | nos_accelerate |
nos_accelerate_host | NOS 下载地址的 host,用于拼接最终获得的文件 URL 地址,也支持该 host 替换成下载加速域名/地址。[4.4.0+开始支持] | nos_accelerate_host |
version | 连接网易云信服务器加密数据通道的公钥的版本号(默认 0) | version |
bd_server | 网易云信 Wi-Fi 统计地址。如果有私有化配置,而这一项没设置,则不做统计 | bd_server |
nt_server | 网易云信运行时异常统计服务器地址。如果有私有化配置,而这一项没设置,则不做统计 | nt_server |
kibana_server | 音视频通话上报/statistic/realtime/sdkinfo | kibana_server |
statistic_server | 音视频通话上报/statistic/realtime/sdkFunctioninfo | statistic_server |
report_global_server | 音视频通话上报/statics/report/realtime/global | report_global_server |
RTC 模块
参数名 | 配置说明 | Android/iOS/Windows/macOS |
---|---|---|
channelServer | 加房间用的信令服务器地址 | channelServer |
statisticsServer | 统计上报服务相关地址 | statisticsServer |
roomServer | 互动直播服务地址 | roomServer |
compatServer | 老版本的参数下发服务地址 | compatServer |
nosLbsServer | 内置对象存储服务地址 | nosLbsServer |
nosUploadSever | 内置对象存储服务地址 | nosUploadSever |
nosTokenServer | 内置对象存储服务地址 | nosTokenServer |
useIPv6 | 是否使用 IPv6 | useIPv6 |
cloudProxyServer | 云代理功能配置的服务器地址 | cloudProxyServer |
statisticsWebSocketServer | 数据上报(e2e 数据)和日志上报的地址 | statisticsWebSocketServer |
mediaProxyServer | 媒体代理地址 | mediaProxyServer |
webSocketProxyServer | edge 信令服务器的配置(Web 端是 webstatisticsServersocket 协议,AOS/iOS/Windows/macOS 端是 quick 协议) | webSocketProxyServer |
statisticsDispatchServer | 统计调度服务器 | statisticsDispatchServer |
statisticsBackupServer | 统计备份服务器 | statisticsBackupServer |
互动白板模块
参数名 | 配置说明 | Android/iOS/Windows/macOS |
---|---|---|
baseUrl | 白板 url | baseUrl |
recordPlayUrl | 白板回放 url | recordPlayUrl |
roomServerAddr | getChannelInfo 接口的地址。用于创建加入白板房间 | roomServerAddr |
sdkLogNosAddr | 白板日志上传接口地址。默认为 https://statistic.live.126.net/sdklog/getToken | sdkLogNosAddr |
dataReportAddr | 白板日志上报地址。默认为 https://statistic.live.126.net/statics/report/common/form | dataReportAddr |
directNosAddr | nos 直传地址。默认为 https://wanproxy-web.127.net | directNosAddr |
mediaUploadAddr | 音视频,图片上传地址。默认为 https://vcloud.163.com | mediaUploadAddr |
docTransAddr | 文档转码地址 | docTransAddr |
fontDownloadUrl | fontDownloadUrl | fontDownloadUrl |
房间组件模块
参数名 | 配置说明 | Android/iOS/Windows/macOS |
---|---|---|
roomServer | 房间组件服务器地址配置 | 必填,roomServer |
lbsServer | 会议域名高可用的服务地址 | 选填,lbsServer |
meeting | 会议服务器地址配置 | 必填,serverUrl |
feedbackUploadUrl | 问题反馈上报的地址。组件层配置 | 选填,feedbackUploadUrl |
cloudRecordUrl | 录制详情页地址。网易会议应用层配置 | 选填,cloudRecordUrl |
recordPageUrl | 录制列表页地址。网易会议应用层配置 | 选填,recordPageUrl |
配置示例
{
"im": {
"appkey": "b660dffe303b7c0a2fff************",
"module": "00e3afe7487e6ac9ba69************dc05d5b6d45850859f11004d30c63e3691afd55722bdd2c75232b2a3561776201f84def8e38c508870ca7692b4228b0478e104460d7800dee3b6c3d8f89746ed48ee94f268f42b9c911437083d3815624e50de3fec3c0ec8ab3e71d5bdce3f4291d20538893cacdc00da9d1390ee39440d",
"version": 0,
"lbs": "http://59.111.229.254/lbs/conf.jsp?version=1.0",
"link": "59.111.230.167:8000",
"nos_lbs": "https://wannos.127.net/lbs",
"nos_uploader": "https://nosup-hz1.127.net",
"nos_uploader_host": "nosup-hz1.127.net",
"https_enabled": true,
"nos_downloader": "{bucket}-nosdn.netease.im/{object}",
"nos_accelerate": "{bucket}-nosdn.netease.im/{object}",
"nos_accelerate_host": "nos.netease.com",
"chatroomDemoListUrl": "https://apptest.netease.im/api/chatroom/homeList"
},
"meeting": {
"serverUrl": "https://yunxinent-demo.netease.im/meeting"
},
"roomkit": {
"roomServer": "http://59.111.229.254/roomkit/"
},
"rtc": {
"channelServer": "https://nertc-gateway-hz-perf.netease.im/nrtcproxy/nrtc/getChannelInfos.action",
"statisticsServer": "http://statistic.live.126.net/statics/report/common/form",
"statisticsDispatchServer": "",
"statisticsBackupServer": "",
"roomServer": "http://call-perf-hz.netease.im/v2/sdk/rooms",
"compatServer": "http://webtest.netease.im/lbs/cc/nrtc/v2",
"nosLbsServer": "https://wannos.127.net/lbs",
"nosUploadSever": "https://nosup-hz1.127.net",
"nosTokenServer": "https://statistic.live.126.net/sdklog/getToken",
"sdkConfigServer": "",
"cloudProxyServer": "",
"webSocketProxyServer": "",
"quicProxyServer": "",
"mediaProxyServer": "",
"useIPv6": false
},
"whiteboard": {
"webServer": "",
"roomServer": "https://roomserver.netease.im/v1/g2/whiteboard/getChannelInfo",
"sdkLogNosServer": "https://statistic.live.126.net/sdklog/getToken",
"dataReportServer": "https://statistic.live.126.net/statics/report/common/form",
"directNosServer": "https://wanproxy-web.127.net",
"mediaUploadServer": "https://vcloud.163.com",
"docTransServer": "https://vcloud.163.com",
"fontDownloadServer": "https://wb.vod.126.net/courseware/pptview/fonts/"
}
}
最后更新于