CMSV6 API 与视频集成:第三方平台可以使用什么
集成指南
第三方平台可以通过四种方式使用 CMSV6:用 HTTP API 取数据和报警,用视频流地址取实时视频,用网页视频插件在浏览器里播放,用 iOS 和 Android SDK 集成到手机应用。有一个限制需要尽早知道:RTSP、HTTP-FLV、HLS 和 RTMP 实时视频流目前只支持 H.264,H.265 视频需要使用网页视频插件。

设备如何接入 CMSV6
车载设备通过 JT/T 808 和 JT/T 1078 接入 CMSV6。JT/T 808 传输位置和报警数据,JT/T 1078 传输视频。您的平台不直接与设备通信,而是与 CMSV6 通信,由 CMSV6 提供数据。《哪些车载设备可以接入 CMSV6 平台》说明了如何确认某个设备型号能否接入。各型号的接口见对应的产品页和报价单。
HTTP API 能做什么
先用 CMSV6 账号登录,获得一个会话号,其他所有调用都使用这个会话号。会话号有效期为 4 小时,只要持续有调用就会保持有效。同一账号再次登录不会使第一次登录的会话号失效。会话号带有该账号的角色权限和车辆权限,因此 API 使用者只能看到该账号有权限的设备。
| 范围 | 可以做什么 | 文档中的接口示例 |
|---|---|---|
| 设备和车辆 | 查询设备信息、在线状态和实时状态;新增、修改、删除设备 | Get device information、Get device online status、Get device real-time status、Add device |
| 报警 | 查询实时报警、检索安全报警、查询和下载报警附件、处理报警、管理联动报警规则 | Get device real-time alarms、Safety alarm query、Alarm attachment query、Alarm attachment download、Alarm handling |
| 轨迹和位置 | 查询历史轨迹和围栏信息 | Get device history track、Get device geofence information |
| 控制和维护 | 下发设备控制指令、管理升级任务 | Device control、Get current upgrade task、Set current upgrade task |
| 权限 | 查询、增加和删除用户的设备授权 | Get user device authorization、Add user device authorization |
报警查询可以按请求参数返回 WGS84(默认)、谷歌(GCJ-02)或百度(BD09)格式的坐标。报警检索需要开始和结束时间,每次请求最多覆盖 90 天。完整的接口说明见帮助中心的HTTP API 接口章节。
实时视频:视频流地址
CMSV6 会返回一个实时视频地址,其他播放器或平台可以直接打开。地址由会话号、设备号、通道号(从 0 开始)和码流类型(0 为主码流,1 为子码流)组成。
| 方式 | 格式 | 编码支持 | 说明 |
|---|---|---|---|
| RTSP | rtsp:// 地址 | 支持 H.264,不支持 H.265 | 用会话号、设备号、通道和码流请求实时视频 |
| HTTP-FLV | http:// 或 https:// 地址 | 支持 H.264,不支持 H.265 | 请求类型 1 为实时视频,2 为音频监听 |
| HLS | http 或 https 上的 .m3u8 地址 | 支持 H.264,不支持 H.265 | 可在支持 HLS 的视频元素中播放 |
| RTMP | rtmp:// 地址 | 支持 H.264,不支持 H.265 | 请求类型 1 为实时视频,2 为音频监听 |
如果您的摄像头输出 H.265,请在浏览器里使用下面的网页视频插件播放实时视频。上面这些视频流地址只支持 H.264。详情见视频协议集成章节。
把视频和地图集成到您自己的网页或手机应用
- 网页视频插件。一个 JavaScript 文件加一个 WebAssembly 解码文件,即可在电脑和手机浏览器里实现实时视频、回放、双向对讲和广播,支持 H.264 和 H.265。解码文件必须放在网页根目录,否则视频可能一直黑屏。文档还附有 Vue 集成说明。见WEB视频集成。
- 现成的网页。服务器提供单个车辆的实时视频页和远程回放页,通过页面地址传参即可使用,只需要在页面里显示一辆车时这是最快的方式。
- 网页集成。免密登录、实时定位页和轨迹回放页都可以从您自己的系统中打开。见WEB网页集成。
- 手机 SDK。iOS 和 Android 原生 SDK 覆盖实时音视频、双向对讲、远程回放和本地设备搜索。见手机SDK接口。
选哪种方式
| 如果您需要 | 常用方式 |
|---|---|
| 把报警和事件取到自己的平台 | HTTP API 的报警查询和报警附件 |
| 在浏览器里显示实时视频,包括 H.265 摄像头 | 网页视频插件 |
| 在其他播放器或视频平台里打开实时流 | RTSP、HTTP-FLV、HLS 或 RTMP 地址(H.264 视频) |
| 在现有页面里快速显示一辆车 | 带参数的现成实时视频页或回放页 |
| 给 iOS 或 Android 应用加视频 | 手机 SDK |
| 接入您自己做的设备或 ECU | JT/T 808 和 JT/T 1078,或 CMSV6 私有协议(见下一节) |
数据到达之后平台在屏幕上能做什么,可以看实时视频监控、轨迹和视频回放和报警规则与报警处理。
如果您自己做设备或 ECU
CMSV6 文档讲的是设备如何向平台上报,没有讲如何把 AlwayCare 的驾驶员监控软件运行在客户自己的芯片上。这一点在本节末尾说明。
两种接入方式。设备可以通过标准协议 JT/T 808 和 JT/T 1078 接入,也可以通过 CMSV6 私有协议接入,后者有自己的设备端网络库和文档。
| 方式 | 协议 | 文档涵盖的内容 |
|---|---|---|
| 标准协议 | JT/T 808-2011、JT/T 808-2019 和 JT/T 1078-2016 | 符合这些协议的设备都可以接入。平台向设备提供服务器地址和端口,设备向平台提供设备号。 |
| CMSV6 私有协议(TTX) | 通过设备端网络库使用的 CMSV6 私有协议 | 带图片和视频的报警上报、H.264 与 H.265 视频格式、音频格式、远程升级、参数配置、设备日志下载、客流统计和时间同步。 |
设备接入需要什么
- 设备上的三项设置:服务器的公网 IP 或域名、上报端口和设备号。地址和端口由平台运营方提供。文档中描述的私有协议设备菜单里,默认端口是 6608,请使用您自己部署的端口。
- 设备号必须与平台一致。JT/T 设备的设备号通常是 12 位。不足 12 位时,平台会在前面补 0 凑成 12 位。平台只靠设备号来识别设备。
- 在平台上添加车辆。使用“快速加车”,填写设备号、车牌号、终端类型和所属公司。也可以打开“未注册设备”:出现在那里的设备说明已经连上了平台,可以从该列表把它添加到车辆。
- 检查网络。处于受限或定向网络中的设备只能上报到某一台固定的服务器。请确认网络允许设备访问您的平台。
通过 JT/T 808 和 JT/T 1078 上报驾驶员监控和 ADAS 报警
设备触发主动安全报警(例如驾驶员疲劳或前向碰撞报警)时,可以附带图片或视频。平台会请求附件,设备把附件上传到附件服务器。顺序如下:
- 设备发送位置数据(消息 0200),其中包含主动安全报警和附件数量。
- 平台网关回复通用应答,并发送消息 9208,其中带有附件服务器的地址和端口。设备回复通用应答。附件服务器的端口必须能从设备访问。
- 设备连接附件服务器并发送消息 1210,服务器回复通用应答。
- 设备发送消息 1211 和附件数据流,服务器对该消息不应答。
- 文件发送完成后,设备发送消息 1212,服务器回复 9212。
- 之后设备继续上传下一个附件,从连接这一步重新开始。
如果报警到达了平台但没有图片或视频,文档建议在网关日志中检查这条序列:设备发出 0200、平台回 8001、平台下发 9208、设备回 0001,然后确认文件已经到达存储服务器。平台还提供了 808 和 1078 报文的日志解析工具。
报警类型和协议变体。平台在设备信息表单里列出所支持的主动安全协议类型,位置在“运营管理 → 设备信息 → 添加 → 协议类型”。文档还收录了多个中国省级和地方主动安全标准的报警 ID 对照(江苏、四川、广西、吉林、江西、陕西、上海、营口、重庆和浙江)。为车辆选择了主动安全协议类型后,平台可以通过“主动安全设置”菜单向设备下发 ADAS 和 DSM 报警参数。平台显示哪些报警类型是可配置的,没有勾选的类型不会被解析。
JT/T 808 的扩展报警。平台以四川团体标准为基础,支持用户自定义扩展,上报碰撞、侧翻、启动、停止、SOS 和 I/O 报警:
| 报警码 | 含义 |
|---|---|
| 0x16 | 碰撞报警 |
| 0x17 | 侧翻报警 |
| 0x18 | 启动 |
| 0x19 | 停止 |
| 0x1A | SOS 报警 |
| 0x1C 至 0x27 | I/O 报警 1 至 12(0x1C 为 I/O 1,0x27 为 I/O 12) |
录像文件上传(仅 JT/T 1078)。用户可以让平台通过 FTP 从设备取回录像。平台发送消息 9206,设备回复通用应答并开始上传,上传完成后上报消息 1206。这只适用于 JT/T 1078 设备,并且 FTP 服务器必须能从外网访问。
私有协议:设备端要实现什么
对于使用私有协议的设备,文档给出了下列事项的设备端代码示例:
- 带图片或视频的报警。设备先上报报警并保存报警编号,然后用该报警编号上传每个文件。文件类型有 JPEG 图片、录像和音频。视频或音频文件需要给出时长,图片的时长为 0。
- 视频格式。设备在启动时声明视频编码。不同通道可以使用不同格式,例如一个通道用 H.264,另一个通道用 H.265。使用 H.265 时,每个 I 帧前面必须加上 VPS、SPS 和 PPS。
- 远程升级。客户端把升级文件上传到服务器,服务器再发送给设备。只有在线设备才能升级。设备检查版本,接收并校验文件,重启后完成升级。文档建议设备在没有存储卡时也能远程升级。
- 参数设置。文档建议使用平台提供的网页设置页面,电脑客户端和网页客户端都会加载它。
- 其他已有文档的主题。音频格式对接、设备日志下载、客流统计数据、设备时间同步,以及设备主动上传媒体文件。
文档里没有的内容。公开文档里没有关于在客户自己的 ECU 或 SoC 上运行 AlwayCare 驾驶员监控软件的说明,也没有列出支持的芯片和操作系统、内存、闪存和处理器要求、摄像头组合或评估流程。如果您打算把检测功能做进自己的硬件,请通过询盘表单发送您的工程师的问题,并附上 SoC、操作系统、摄像头传感器、内存和闪存以及所需功能。我们的工程师会评估您的需求。
集成之前要确认什么
- 确认您的设备型号和固件通过 JT/T 808 和 JT/T 1078 接入(见上文提到的核对清单)。
- 弄清每个摄像头输出的是 H.264 还是 H.265,选择支持它的方式。
- 列出您需要的通道,以及需要主码流还是子码流。
- 决定 CMSV6 运行在哪里。平台授权列在标准组件里,但平台软件费用不包含在报价中。独立的车队服务器部署、定制 API 集成和自建平台许可,需要与我们的工程师技术沟通后提供。
- 如果您自己做设备,请在标准协议和私有协议中选择一种,设置服务器地址、端口和设备号,并用网关日志测试报警和附件流程。
- 请使用您自己部署的地址和账号。文档中的示例使用的是演示服务器地址和示例账号。
如果您在“把摄像头直接接到自己的平台”和“使用 CMSV6”之间犹豫,《将 AI 行车记录仪接入现有车联网平台》比较了各种集成路径。更广泛的数据对接风险,请看《车队数据孤岛》。
完整文档在哪里看
CMSV6 帮助中心位于 docs.alwaycare.com,提供中文和英文两种语言。建议从HTTP API 接口、视频协议集成和WEB视频集成这几个章节开始。平台本身的介绍见CMSV6 平台页。
关于 CMSV6 集成的常见问题
CMSV6 有 API 吗?
有。CMSV6 提供 HTTP API,覆盖设备、报警、报警附件、轨迹、设备控制和用户授权。用账号登录后获得会话号,有效期 4 小时。
其他平台能从 CMSV6 获取实时视频吗?
可以。CMSV6 会返回 RTSP、HTTP-FLV、HLS 和 RTMP 格式的实时视频地址,这些地址支持 H.264。
CMSV6 支持 H.265 吗?
网页视频插件支持 H.264 和 H.265。RTSP、HTTP-FLV、HLS 和 RTMP 实时视频流只支持 H.264,不支持 H.265。
有手机应用用的 SDK 吗?
有。有 iOS 和 Android 原生 SDK,用于实时音视频、双向对讲、远程回放和本地设备搜索。
哪些设备可以接入 CMSV6?
通过 JT/T 808 和 JT/T 1078 接入的设备。具体型号和固件请在产品页上核对,或咨询我们的工程师。
我能接入自己做的设备吗?
可以,只要设备符合 JT/T 808-2011、JT/T 808-2019 或 JT/T 1078-2016,或者实现了 CMSV6 私有协议。设备需要服务器地址、上报端口和与平台一致的设备号。
AlwayCare 的驾驶员监控软件能运行在我自己的 ECU 或 SoC 上吗?
公开文档里没有这方面的说明。请通过询盘表单发送您的 SoC、操作系统、摄像头传感器、内存和闪存以及所需功能,我们的工程师会进行评估。
定制 API 集成包含在报价里吗?
定制 API 集成需要与我们的工程师技术沟通后提供。平台软件费用不包含在硬件报价中。
请通过询盘表单发送您的平台名称、计划接入的设备和偏好的集成方式,我们的工程师会确认适用的方案。


