跳至正文

随身摄像头 API

Shelleys 4G 随身摄像头（S7P/S4）API 提供了一个开放的集成接口，使第三方平台、软件系统和应用程序能够与 Shelleyes 4G 随身摄像头进行通信。.

“随身摄像头 API”为 4G 随身摄像头与第三方平台之间提供了一个安全的通信接口。.

通过此 API，开发人员可以将随身摄像头与自己的平台集成，包括：

  • 视频管理系统（VMS）
  • 数字证据管理系统（DEMS）
  • 公共安全指挥平台
  • 定制化监控应用程序

该 API 支持：

  • 设备注册与管理
  • 远程摄像头控制
  • 实时GPS定位
  • 实时视频和音频流媒体

通信架构由三个独立的数据通道组成：

数据通道说明
控制数据设备注册、心跳检测、状态监控和远程命令
GPS数据从设备上传的实时位置信息
视频/音频数据（RTMPS）实时视频和音频流媒体

所有通信渠道均采用 TLS 加密进行安全传输。.

API 通信架构

随身摄像头通过专用通信通道与服务器进行通信。.

数据通道服务器端口规程
控制数据1901TCP 通过 TLS
GPS数据7095TCP 通过 TLS
视频/音频数据（RTMPS）1935RTMPS

该视频/音频流媒体通道采用 RTMPS（基于 TLS 的 RTMP）协议，可在随身摄像头与服务器之间提供加密的实时媒体传输。.

1. 控制数据

概述

控制数据是随身摄像头与服务器之间的主要通信通道。.

其职责包括：

  • 设备注册
  • 心跳通信
  • 远程命令执行
  • 设备状态查询
  • 命令响应反馈

控制通信采用基于 JSON 的轻量级协议，对带宽要求极低。.

端口配置

频道服务器端口随身摄像头接口
控制数据19011902

设备注册

当随身摄像头连接到网络时，它会向服务器发送一个注册请求。.

注册信息包括：

字段说明
IMEI设备识别号
DEVID用户自定义设备 ID
SW_VER固件版本
PROTO_VER通信协议版本
时间戳UTC 时间戳
AGENTID设备用户/操作员 ID

注册成功后，服务器会提供一个用于消息认证的会话密钥。.

心跳

注册完成后，该设备会定期发送心跳消息以保持在线状态。.

心跳信息可能包括：

  • 电池电量
  • 剩余存储空间
  • 网络信号强度
  • 录制状态
  • GPS状态

默认心跳间隔：

  • 每3秒

如果服务器在 60 秒内未收到心跳消息，则可将该设备视为离线。.

遥控器指令

服务器可以发送命令来远程控制随身摄像头。.

支持的命令包括：

命令功能
开始视频流媒体播放开始直播
停止视频流媒体播放停止直播
开始录制视频开始本地录制
停止视频录制停止录制
开始GPS数据上传启用 GPS 上传
停止GPS数据上传禁用 GPS 上传
拍照远程拍摄图像
振动触发设备振动
查询电池获取电池信息
查询设备状态获取当前设备状态

该设备通过CTRLFB字段返回命令执行结果。.

2. GPS数据

概述

GPS 数据将随身摄像头的实时位置信息传输至服务器。.

GPS通信模式为：

随身摄像头 → 服务器

GPS信息通过一个独立的GPS信道进行传输。.

端口配置

频道服务器端口
GPS数据7095

GPS 数据上传频率

当启用 GPS 时：

  • 该设备每2秒上传一次GPS信息。.

GPS消息的用途：

MSGTYPE = 3

并且仅通过GPS信道传输。.

GPS 数据字段

该 GPS 消息包含：

字段说明
LAT纬度
LON经度
速度当前速度
海拔海拔
标题运动方向
HDOPGPS精度指示器
SAT_COUNT卫星数量
GPS_VALIDGPS有效性状态
时间戳UTC 时间戳

3. 视频/音频数据（RTMPS）

概述

视频/音频 API 提供了在随身摄像头与外部平台之间进行实时视频和音频流传输的功能。.

流媒体协议如下：

RTMPS（基于 TLS 的 RTMP）

它支持安全的实时视频传输，可与以下系统集成：

  • VMS平台
  • 指挥中心
  • 监控系统
  • 定制应用程序

端口配置

频道服务器端口
视频/音频数据（RTMPS）1935

直播工作流程

直播流程：

1. 服务器发送“开始视频流”命令

 ↓

2. 随身摄像头接收到 CTRLMSG = 0

 ↓

3. 摄像头开始 RTMPS 流传输

 ↓

4. 服务器接收实时视频/音频流

RTMPS 流格式

直播网址：

rtmps://server_ip:1935/live/DEVID

流连接通过服务器端的访问控制进行保护，仅允许已注册的设备进行连接。.

视频和音频编码

视频

支持的编解码器：

  • H.264
  • H.265

音频

支持的编解码器：

  • 审咨委

推荐的媒体服务器：

SRS（简易实时服务器）

SRS 可以将 RTMPS 流转换为与网络兼容的格式，例如：

  • HLS
  • WebRTC

用于基于浏览器的播放。.

安全

TLS 加密

所有通信通道均支持 TLS 1.2 或更高版本：

频道安全
控制数据TCP 通过 TLS
GPS数据TCP 通过 TLS
视频/音频数据RTMPS

流访问控制

该流媒体服务采用基于IP的访问控制。.

安全机制：

  • 服务器在注册过程中会记录设备的IP地址
  • 只有已注册设备的 IP 地址才能建立流连接
  • 服务器在接受流之前会验证设备身份

无需额外的流令牌。.

消息认证

控制和GPS消息的用途：

HMAC-SHA256

安全功能：

  • 会话密钥认证
  • 每24小时轮换一次钥匙
  • SERIALNO 重放保护

集成工作流

典型的集成流程：

随身摄像头连接至网络

 ↓

设备注册

 ↓

服务器认证

 ↓

心跳通信

 ↓

远程命令控制

 ↓

GPS数据上传 / RTMPS实时流媒体传输

 ↓

第三方平台集成

支持集成的应用程序

“Body Camera API” 可集成到以下系统中：

定制软件解决方案

VMS平台

公共安全平台

安防监控系统