开放平台 Q&A

Q1:第一次接入开放平台需要准备哪些信息?

需要准备开放平台分配的 appid/openid、服务端内部密钥、设备 ID 或 IMEI。服务端内部密钥 必须保存在服务端或安全配置中心,不要放在前端页面、App、小程序中,也不要作为外部请求参数传入。

Q2:device_id 和 IMEI 必须都传吗?

不是。文档中说明 device_id、IMEI 均能表示设备唯一编号,传值时至少传一个。实际使用时建议按接口文档要求保持字段稳定。

Q3:sign 应该在哪里生成?

sign 必须在服务端生成。前端只调用自己的服务端接口获取 timestamp、nonce、sign,服务端按 openid / device_id 读取密钥后生成签名,避免外部传入 服务端内部密钥 带来的绕过风险。

Q4:WebRTC 地址有效期多长?

WebRTC 流地址用于实时预览,通常有有效期限制。建议按需实时获取,不要长期缓存播放地址。

Q5:获取 WebRTC 地址失败怎么排查?

先确认设备已经添加到开放平台,再检查设备 ID、设备密码、timestamp、nonce、sign 是否正确。若设备离线,也会影响实时流获取。

Q6:设备在线离线消息为什么有延迟?

在线离线状态依赖设备连接和平台检测,设备通电、断电后可能存在短暂延迟。业务侧建议结合回调消息和主动查询一起判断。

Q7:告警、心跳、GS/GE 上报应该如何接收?

开发者需要提供 HTTPS 回调地址,平台会以 POST JSON 方式推送事件。服务端收到后应及时返回成功结果,并保存原始数据便于追溯。

Q8:回调接口需要校验 sign 吗?

需要。回调数据中的 timestamp、nonce、data 等字段应按文档规则参与签名校验,校验通过后再进入业务处理。

Q9:RTSP 拉流地址和 WebRTC 有什么区别?

WebRTC 更适合网页低延迟预览;RTSP 更适合传统流媒体、NVR 或服务端拉流场景。RTSP 通常依赖设备网络和明文密码等参数。

Q10:接口调试建议按什么顺序?

建议按“生成 sign 示例 -> 设备管理 -> 获取 WebRTC 地址 -> 事件回调”的顺序联调。GS3/GE1 设备再补充阅读 GS/GE 类设备对接文档。