需要准备开放平台分配的 appid/openid、服务端内部密钥、设备 ID 或 IMEI。服务端内部密钥 必须保存在服务端或安全配置中心,不要放在前端页面、App、小程序中,也不要作为外部请求参数传入。
不是。文档中说明 device_id、IMEI 均能表示设备唯一编号,传值时至少传一个。实际使用时建议按接口文档要求保持字段稳定。
sign 必须在服务端生成。前端只调用自己的服务端接口获取 timestamp、nonce、sign,服务端按 openid / device_id 读取密钥后生成签名,避免外部传入 服务端内部密钥 带来的绕过风险。
WebRTC 流地址用于实时预览,通常有有效期限制。建议按需实时获取,不要长期缓存播放地址。
先确认设备已经添加到开放平台,再检查设备 ID、设备密码、timestamp、nonce、sign 是否正确。若设备离线,也会影响实时流获取。
在线离线状态依赖设备连接和平台检测,设备通电、断电后可能存在短暂延迟。业务侧建议结合回调消息和主动查询一起判断。
开发者需要提供 HTTPS 回调地址,平台会以 POST JSON 方式推送事件。服务端收到后应及时返回成功结果,并保存原始数据便于追溯。
需要。回调数据中的 timestamp、nonce、data 等字段应按文档规则参与签名校验,校验通过后再进入业务处理。
WebRTC 更适合网页低延迟预览;RTSP 更适合传统流媒体、NVR 或服务端拉流场景。RTSP 通常依赖设备网络和明文密码等参数。
建议按“生成 sign 示例 -> 设备管理 -> 获取 WebRTC 地址 -> 事件回调”的顺序联调。GS3/GE1 设备再补充阅读 GS/GE 类设备对接文档。