uid 带 _agent_ 前缀)。
单个接口的参数与返回结构见设备接入。
三步接入
gw 填错会导致设备无法上线。
六种接入方式
type 是 URL 查询参数(?type=regsip),不在请求体里。新增设备与
修改设备的请求体字段随它变化:
所有方式都必填
display_name(显示名称)和 gw(设备网关),remark 可选。
rtsp 之外的方式还需要注意:注册模式要求设备主动向网关注册,IP 直连则由我们去连设备,
选哪种取决于设备所在网络能不能被我们访问到。
修改设备时 type 必须与设备登记时一致,不能借此把 SIP 设备改成 RTSP;
要换接入方式请删除后重新登记。
国标设备的通道
一台国标设备(NVR、球机)下面可能挂多个摄像头通道,每个通道在会中是一路独立画面。subjects 是「通道编号 → 通道名称」的键值对:
- 登记设备时用
subjects一次性批量传入 - 之后用设置国标设备的一个通道逐个添加或改名
- 编号懒得自己拼 → 先调生成国标设备的通道编号按规范生成,再登记
sip_no 也可以用生成国标设备的 SIP 编号拿到。
两个”生成”接口都只返回编号、不落库,拿到后还得自己去登记。
要让国标摄像头能注册上来,设备端得填”上级平台”信息(SIP 编号、域、IP、端口)——
这些值从设备网关平台信息列表取。
邀请与会中操作
邀请设备入会的agents[].type 与 contact 从
设备列表取;国标设备的每个通道各占一条,contact 就是通道编号。
入会是异步的:接口返回成功只表示邀请已下发,设备真正上线要等 user_join 回调。
如果你订阅了 agent_join 回调,还必须在回调里返回 sid,否则设备进不来——见回调事件接入指南。
设备不能自己开关麦克风和摄像头,只能由服务端下发:
开关设备视频 / 开关设备音频。
uid 用设备在频道里的用户 ID(带 _agent_ 前缀,从成员列表或 user_join 回调拿),
不传 uid 则对该频道内所有设备生效。
订阅了 agent_operate 回调时,这两个操作会先征询你的业务后端,返回非 0 即拒绝。
设备类型编号
list-invite 与 invite 用的是数字类型,与 type 字符串不是一套:
会中成员的
device_type 是第三套编号(80 起的代理号段),见回调事件接入指南。