二次开发
网络摄像机接入方式总览
按「应用侧接入」与「设备侧接入」两个方向选择，总有一种方式适合你的项目
| 分类 | 接入方式 | 功能描述 | 利旧 | 文档 / 下载 |
|---|---|---|---|---|
| 一、应用侧接入 让开发者的系统 / App 连平台 |
① RESTful API （含 Webhook 回调） |
服务端标准 HTTPS 接口，覆盖设备创建 / 查询 / 更新 / 删除、实时音视频（WebRTC）取流、截图、录像、对讲、AI 检测、告警回调、在线离线心跳、RTSP 拉流地址获取、CGI 控制指令。采用 open_id + secret key + sign 鉴权机制。 | — | 查看文档 → |
| ② Flutter SDK （移动应用） |
面向移动应用开发的 Flutter 架构 SDK，封装设备列表、实时预览、录像回放、告警订阅与推送能力，一次开发同时覆盖 Android 与 iOS。 | — | 获取 SDK → | |
| ③ WebRTC （Windows PC 端应用） |
面向 Windows PC 端应用的实时音视频接入方式，通过 WebRTC 获取低延迟实时视频，支持实时预览、音频播放与双向对讲等能力，适合在 PC 端应用中集成视频查看与现场交互功能。 | — | 获取插件包 → | |
| 二、设备侧接入 让第三方设备与终端连平台 |
④ 国标 GB28181 | 支持标准 GB28181 协议接入。第三方平台或国标设备通过 SIP 注册接入小鹰云，完成设备目录同步、实时音视频调阅、历史录像检索与回放。 | ✓ 支持 | 【文档待发布】 |
| ⑤ RTSP / ONVIF 中转 （中转程序 / 中转终端设备） |
不具备国标能力的存量设备与 NVR，通过部署中转程序（或中转终端设备）完成 ONVIF 设备发现与 RTSP 拉流，转换为平台标准流上云。无需更换硬件、无需加装边缘盒子，即可让已有摄像机获得入网能力。 | ✓ 支持 | 【下载待补】 | |
| ⑥ MQTT + RTMP | 设备侧轻量双通道方案：MQTT 通道上报设备状态、事件与结构化感知结果（支持 QoS 等级配置、虚拟设备 ID 轮换鉴权、私有化 SSL 证书）；RTMP 通道负责视频流推流（支持码率 / 分辨率分级）。 | 不支持 | 【文档待发布】 |
* ④⑤ 支持的具体设备品牌与型号，以官方实测清单为准，请与对接负责人确认；⑥ MQTT + RTMP 适用于自研终端与边缘设备，不用于存量设备利旧。
* 小鹰视界摄像机RTSP访问地址: rtsp://account:password@IP:port/udp/av0_0。 account是摄像机的登陆帐号，默认是admin； password是摄像机的登陆密码，默认是888888； IP为摄像机的局域网访问地址； Port为端口号； udp表示当前是UDP协议，如果需要用TCP协议，则改为 tcp； av0_0 为主码流； av0_1 为子码流。 具体型号请联系业务员
六种接入方式详解
每种方式解决一类问题，按需选择、可组合使用
RESTful API（含 Webhook 回调）
把空间感知能力嵌入你已有的软件系统或平台，是最通用的对接方式。
- 设备管理：创建 / 查询 / 更新 / 删除
- 音视频：WebRTC 实时预览、截图、录像、对讲
- 告警与事件：Webhook 实时回调、图片与视频事件
- 在线离线：心跳与设备状态同步
- 取流与控制：RTSP 拉流地址获取、CGI 控制指令
Flutter SDK
为移动应用开发者准备，一套代码同时跑通 Android 与 iOS。
- 设备列表与状态组件
- 实时预览播放器
- 录像回放
- 告警订阅与推送
- 与 RESTful API 共用同一套鉴权体系
WebRTC（Windows PC 端应用）
面向 Windows PC 端应用的低延迟实时音视频接入方式，适合在 PC 端集成视频查看与现场交互。
- 低延迟实时视频预览
- 音频播放与双向对讲
- 适用于 Windows PC 端应用
- 与 RESTful API 配合获取设备与播放地址
国标 GB28181
已建安防平台、主流品牌国标设备的标准协议上云通道。
- SIP 注册接入与设备目录同步
- 实时音视频调阅
- 历史录像检索与回放
- 码流上云后挂载空间感知 AI 能力
- 适配海康、大华、宇视等主流品牌【型号矩阵待补】
RTSP / ONVIF 中转
存量设备利旧的最短路径——不用换硬件，也能上云获得 AI 能力。
- ONVIF 设备发现与鉴权接入
- RTSP 拉流并转换为平台标准流
- 支持中转程序部署与中转终端设备两种形态
- 适用于无国标能力的 NVR 与摄像机
- 中转通道加密与设备凭证管理
MQTT + RTMP
面向自研终端与边缘设备的轻量双通道接入方式：事件走 MQTT，视频走 RTMP；不适用于存量设备利旧。
- MQTT 上报设备状态、事件与结构化感知结果
- QoS 等级可配置、虚拟设备 ID 轮换鉴权
- 支持私有化 SSL 证书
- RTMP 推流，码率 / 分辨率分级
- 适合自研终端、边缘设备与边缘盒子
- 不适用于存量摄像机或 NVR 利旧接入
不确定选哪种？
把你的设备现状和要解决的问题告诉我们，由对接负责人给出接入方案建议。
- 有国标设备 → ④ 国标 GB28181
- 无国标、有存量摄像机 / NVR → ⑤ RTSP / ONVIF 中转
- 自研终端或边缘设备 → ⑥ MQTT + RTMP
- 做 Windows PC 端应用 → ③ WebRTC
- 做移动 App → ② Flutter SDK
- 做业务系统 / 平台集成 → ① RESTful API
存量设备上云 · 不换硬件也能上云
④⑤ 两类接入方式专为第三方设备接入与存量设备利旧场景设计
不换硬件
已有摄像机、NVR 继续留用，通过国标或 RTSP/ONVIF 中转接入即可上云，避免重复投资。
不加边缘盒子
视频流直接上云，获得小鹰云空间感知能力。
不止于录像
从「事后看录像」升级为「实时理解空间」，让沉睡的存量设备产生新的业务价值。
接入后，你的系统能做什么
接入小鹰云开放平台后，你的系统可集成设备、视频、告警、存储、流量与状态管理等基础功能
基础功能介绍
接入后即可将设备管理与视频服务能力集成到你的系统中。
实时视频与设备控制
- 查看网络摄像机实时视频
- 定时抓拍图像
- 开启监听对讲
- 操作云台
实时接收告警推送
实时接收设备告警与事件推送，并将告警信息集成到你的业务系统或处置流程中。
云存储与 TF 卡回放
集成云存储和 TF 卡回放功能，按需查看历史录像，支持业务系统统一管理视频资料。
4G 流量管理
集成 4G 流量管理功能，掌握设备流量使用情况，便于对 4G 摄像机及终端进行统一管理。
设备状态与离线通知
查询设备在线状态、运行状态与基础信息，并在设备离线时及时接收通知。
小鹰云空间感知能力
在基础设备与视频服务能力之上，小鹰云进一步提供五大感知分类，覆盖安全、秩序、运营、设备与行为。
安全感知
秩序感知
运营感知
设备感知
行为感知
平台架构
看见 → 理解 → 联动，三层协同构成完整的空间感知能力
空间感知设备
摄像机、边缘设备 —— 负责「看见」。支持小鹰云自有设备；第三方与存量摄像机可通过 ④⑤ 接入，自研终端与边缘设备可通过 ⑥ 接入。
空间感知 AI 能力
公有 AI 大模型、行业算法 —— 负责「理解」。不是单点检测，而是对空间状态的持续理解。
空间感知开放平台
API / SDK / WebRTC / 回调 / 管理后台 —— 负责「联动」。六种接入方式，把感知结果送进你的业务系统。
