开放平台对接流程

本文介绍摄像头、安防摄像头和 4G 摄像头方案接入小鹰云开放平台的基本流程。首次接入时,建议按以下步骤完成服务端和前端集成。

接入流程

1. 获取开放平台接入信息

联系小鹰对接负责人获取 open_id 和 secret key(联系人:林工 电话/微信:13424300928)

安全提示:secret key 为服务端内部密钥,仅用于服务端生成 sign。请将其保存在服务端或安全配置中心,禁止放在前端、App 或小程序中,也不要通过外部请求传入。

2. 确定设备类型 ID、型号 ID

根据待接入设备,确认设备类型 ID 和型号 ID。创建设备时需要使用这两个 ID,可参考类型型号映射。

3. 签名鉴权

服务端按照开放平台签名规则生成 sign,用于接口请求的签名鉴权。具体规则请参考生成 sign 示例。

4. 创建设备

准备设备类型 ID、型号 ID 和设备信息,调用以下接口创建设备:

请求示例
POST https://open.eye4cloud.com/{{open_id}}/open/v1/device/create

详细请求字段请参考设备创建。

5. 获取 WebRTC 播放地址

设备创建成功后,由服务端调用以下接口获取摄像机 WebRTC 播放地址:

请求示例
POST https://open.eye4cloud.com/{{open_id}}/open/v1/device/getWebrtcAddress

详细请求字段请参考获取 WebRTC 地址。

6. 前端播放器播放视频

服务端将 WebRTC 播放地址返回给前端,前端使用播放器或 WebRTC SDK 播放视频。

7. 按业务接入告警、在线离线、RTSP 等能力

根据业务需要,继续接入以下能力:

  • 告警事件:查看告警对接文档
  • 在线离线:查看心跳与在线离线
  • 服务端拉流:查看获取 RTSP 拉流地址