远端设备配置说明

最近更新时间:2026-07-08 17:11:19

我的收藏

JSON 配置文件样例

以下是基本 JSON 配置举例。可使用 配置生成工具(选择远端设备)生成配置。
配置文件简述
文件名:config.json
文件位置:${workspace}/config.json
文件类型:json
注意:"//"后注释在使用时要删除。最小节点如下
{
"device_id":"dev1", //修改为控制台中创建的远端设备ID
"device_name":"vin99",
"max_streams":8,
"cloud_mode":"public", "certificate":"./device.pem", "projectid" : "xxxxx", //修改为控制台中创建的项目ID "password": "xxxxx" //修改为控制台中创建的密码
}

JSON 配置节点含义

节点名
类型
含义
默认值
备注
参数范围
device_id
字符串型(String)
设备 ID,用于注册到服务器的唯一编码
-
必选
-
device_name
字符串型(String)
设备名称,用于辨识设备信息
-
必选
-
max_streams
数字型(Number)
远端设备连接的最大流数目
-
必选
无,配套 Demo 建议 >=8。
projectid
字符串型(String)
项目 ID
-
公有云必填
-
cloud_mode
字符串型(String)
云模式
-
必填
public:公有云。
private:私有云。
password
字符串型(String)
设备密钥
-
公有云必填
-
certificate
字符串型(String)
服务器公钥证书
-
公有云必填,device.pem 文件路径
-
force_login
数字型(Number)
是否强制登录
0
同名 ID 登录是否剔除之前的设备登录
0 :已有相同 ID 登录时,当前设备登录被剔除。
1: 已有相同 ID 登录时,当前设备会强制登录,将之前设备剔除。
server_ip
字符串型(String)
TRRO 服务端 IP
-
公有云无需填写,
私有化必填
-
server_port
数字型(Number)
TRRO 服务端端口号
-
公有云无需填写,
私有化必填
-
log_enable
布尔型(Boolean)
日志开关
1
可选
0:不使能。
1:info 日志。
2:info+debug 日志。
sdk_mode
字符串型(String)
流传输模式
"server2"
可选
公有云需用 server2。
rtc_server_ip
字符串型(String)
媒体服务端 IP
-
公有云无需指定,私有化必填
-
rtc_server_port
数字型(Number)
媒体服务端端口号
-
公有云无需指定,私有化必填
-
audio_enable
数字型(Number)
音频采集使能
0
可选
0:不使能。
1:使能。
audio_record
字符串型(String)
音频采集设备
-
可选,用于指定采集设备;如果使用外部音频输入,见 audio_external 配置
具体参见 语音对讲
audio_external
数字型(Number)
外部音频输入
0
可选,使用外部音频输入替代 SDK 音频采集时启用
0:不使用外部输入。
1: 使用外部音频输入。
audio_receive
数字型(Number)
音频接收使能
1
可选
0:不使能。
1:使能。
audio_play
数字型(Number)
音频播放设备
-
可选,用于指定播放设备;使用音频回调进行自定义播放时配置 “outside”
参见 语音对讲
auto_permission
数字型(Number)
是否自动请求控制权限
1
可选
0:应用请求控制权限。
1:自动请求控制权限。
play_mode
数字型(Number)
观看模式
0
可选
0:超低时延观看。
1:流畅观看。
decode_hw_acc
数字型(Number)
是否硬件解码优先
0
可选
0:软解。
1:硬解优先。
file_path
字符串型 (String)
录制文件保存路径
-
可选,开启录制时配置,需保证配置路径已存在
-
min_port
数字型(Number)
视频传输本地端口段最小值
50000
可选
-
max_port
数字型(Number)
视频传输本地端口段最大值
50100
可选
-
dc_rate_level
数字型(Number)
消息扩展等级
1
可选
1:基础限制,频率100Hz, 总大小100KB/秒,qos1 10KB/条。
2:2倍扩展,频率200Hz,总大小200KB/秒,qos1 20KB/条,设备在线会话时长计费为2倍时长。
3: 3倍扩展,频率300Hz,总大小300KB/秒,qos1 30KB/条,设备在线会话时长计费为3倍时长。
4: 4倍扩展, 频率400Hz,总大小400KB/秒,qos1 40KB/条,设备在线会话时长计费为4倍时长。
proxy_enable
数字型(Number)
白名单代理
0
可选
0:不使用代理。
1:使用白名单域名代理(turn.cloud-rtc.com)。

output_path
字符串型(String)
文件存储路径
"./"
可选
配置 SDK 运行过程中日志和临时文件的输出路径。
log_zip_enable
数字型(Number)
日志是否压缩开关,默认不开启
0
可选
0:关闭日志压缩。
1: 开启日志压缩。
log_file_cut_size
数字型(Number)
存储文件多大开始切片,默认100MB
100
可选
建议10 - 500之间。
log_file_max_size
数字型(Number)
存储最大占用空间 不开启压缩默认1000MB、开启压缩默认500MB。
1000
可选
必须大于 log_file_cut_size 三倍以上;设置-1为不限制上限。