• • • 1.1 覆盖设备
    • 1.2 命令类型
• 2.命令列表概览
  • • 2.1 三路摄像头支持
    • 2.2 APP某些功能定制化
• 3.具体命令
  • • 3.1 APP访问(APP_ACCESS)
    • 3.2 获取实时GPS数据(VI_GPS_RTDATA)
    • 3.3 UUID
    • 3.4 同步手机时间(DATE_TIME)
    • 3.5 SD卡状态
    • 3.6 录像控制-VIDEO_CTRL
    • 3.7 录像参数-VIDEO_PARAM
    • 3.8 设备支持的分辨率列表-VIDEO_SIZE
    • 3.9 循环录像
    • 3.10 WDR
    • 3.11 停车监控时长
    • 3.12 停车监控模式
    • 3.13 电压门限设置
    • 3.14 间隔录影
    • 3.15 图像水平镜像
    • 3.16 图像上下翻转
    • 3.17 移动侦测
    • 3.18 录像时间水印
    • 3.19 照片时间水印
    • 3.19 设置扬声器音量
    • 3.20 录音开关设置
    • 3.21 设置文件加锁
    • 3.22 设置红外灯开关
    • 3.23. 按键声音
    • 3.24 停车守卫
    • 3.25 防手抖
    • 3.26 电子狗播报开关
    • 3.27 拍照分辨率
    • 3.28 拍照质量
    • 3.28 曝光补偿
    • 3.29 碰撞感应灵敏度
    • 3.30 停车监控中碰撞感应灵敏度
    • 3.31 光源频率
    • 3.32 TV模式
    • 3.32 自动关机
    • 3.33 屏幕保护
    • 3.34 设置设备的ssid或wifi密码
    • 3.35 格式化
    • 3.36 恢复出厂默认设置
    • 3.37 GPS时间同步开关
    • 3.38 驾驶休息提醒
    • 3.39 时区设置
    • 3.40 查询设备固件版本
    • 3.41 电池状态
    • 3.42 TF卡容量
    • 3.43 录像分辨率设置新协议
    • 3.44 语音
    • 3.45 12小时/24小时制式设置
    • 3.46 动态化菜单
    • 3.47 设备能力集获取

1. 概述

​ 杰理当前是记录仪行业的主流SOC之一，原厂提供了基本协议框架和标准，但在落地是各个方案商有一定的扩展，给APP的适配带来了一定的复杂性；

​ 由于记录仪行业的业务本质上是可以标准化的，故本文档会拟定一个‘6帧探’适配的标准文档，如果有方案商想采用本APP作为公版使用的，有统一的标准将会带来双方更大适配便利性，也会给行业带来更大的效率提升；

1.1 覆盖设备

指AC56系列带WIFI行车记录仪或者AC56系列运动DV

1.2 命令类型

命令格式如下所示：

{
  "errno":0,      // 错误返回，若无可省略此字段 0-成功
    "op":"GET",   //操作类型，value0包括“PUT","GET","NOTIFY"
    "param":{
    "key_0":"value1", 
    "key_1":"value2",
    "key_2":"value3",
    "key_3":"value4",
    ......
    }
}

op为操作类型，当手机"PUT"或"GET"命令时，设备统一回复"NOTIFY"。

示例： Topic: "SD_STATUS"

{
    "errno":0,
    "op":"NOTIFY",
    "prarm":{
        "key_0":"1", //在线状态（0：离线, 1:在线）
    }    //操作类型（"GET","PUT"）
}

2.命令列表概览

2.1 三路摄像头支持

待补充

2.2 APP某些功能定制化

参见 下面 3.43 设备能力集获取

3.具体命令

3.1 APP访问(APP_ACCESS)

• 功能描述 APP每次建立连接，必须发送此Topic给设备。设备根据当前情况允许或拒绝连接。当app接入设备后，设备会主动将心跳包间隔、白平衡、sd卡状态、电池状态等信息发送给app，app根据这些信息进行界面初始化。

• 命令描述 Topic:"APP_ACCESS", errno: 参考设备错误列表, op: 操作类型("PUT", "NOTIFY"), type: 手机类型（0：Android, 1：iOS） ver: APP版本号

3.2 获取实时GPS数据(VI_GPS_RTDATA)

• 功能描述 向设备查询当前的实时GPS数据信息

• 命令描述 Topic: "VI_GPS_RTDATA" errno: 参考设备错误列表, op: 操作类型("GET", "NOTIFY") info: 当前GPS数据信息，详情参考文档《6ZHENTAN-GPS接口协议V1.2.0.pdf》

3.3 UUID

• 功能描述 手机获取设备的UUID。

• 命令描述 Topic: "UUID" errno: 参考设备错误列表, op: 操作类型("GET", "NOTIFY") uuid: UUID内容，设备的唯一ID

3.4 同步手机时间(DATE_TIME)

• 功能描述 同步手机日期、时间给设备

• 命令描述 Topic: "DATE_TIME" errno: 参考设备错误列表, op: 操作类型("GET", "NOTIFY") date: 年月日时分秒（yyyyMMddHHmmss）

3.5 SD卡状态

• 功能描述

• 命令描述 Topic: "SD_STATUS" errno: 参考设备错误列表, op: 操作类型，“GET” “NOTIFY", online: 在线状态（0：未插入TF卡；1：TF状态正常；2：TF卡需要格式化；其他值：未知异常）

3.6 录像控制-VIDEO_CTRL

• 功能描述 手机控制设备启动/关闭录像，及获取设备录像状态。

• 命令描述 Topic: "VIDEO_CTRL" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") status: 状态(0：未录像， 1：录像中)

3.7 录像参数-VIDEO_PARAM

• 功能描述 手机设置设备录像分辨率和视频格式，及获取设备当前的不同摄像头的录像信息（分辨率，视频格式）。

• 命令描述 Topic: "VIDEO_PARAM"（前路）、PULL_VIDEO_PARAM（后路）、THIRD_VIDEO_PARAM（第三路） errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") w: 分辨率宽 h: 分辨率高 format: 视频格式(0:JPEG, 1:H264) fps: 帧率(暂未使用)

3.8 设备支持的分辨率列表-VIDEO_SIZE

• 功能描述 获取设备当前支持的分辨率列表，以及设置分辨率，如果想要app显示的设备分辨率的，请使用该接口

• 命令描述 Topic: "VIDEO_SIZE" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") str: 当前支持的分辨率列表，以逗号分割，{"str":"4K;2K;1080P", "val":"1"} val: 当前使用的序号，列表中对应的序号，从0开始；比如：{"str":"4K;2K;1080P", "val":"1"} 表示当前分辨率是'2K'

  注意：当op为PUT时，表示设置分辨率，有VIDEO_SIZE后，VIDEO_PARAM将不再用作设置分辨率的命令；

• 设置分辨率时，指定新分辨率对应的序号；比如：设置分辨率为‘1080P'，对应参数为：{"str":"4K;2K;1080P", "val":"2"}}

• 默认的视频格式是H264,如果视频格式不是H264，则可以通过"VIDEO_PARAM"（前路）、PULL_VIDEO_PARAM（后路）、THIRD_VIDEO_PARAM（第三路）Notify信息反馈不同镜头的视频格式，比如0-JPEG

3.9 循环录像

• 功能描述 设置循环录像时长。

• 命令描述 Topic: "VIDEO_LOOP" errno: 参考设备错误列表, op: 操作类型("GET","PUT",NOTIFY") cyc: 状态(0:关闭,1:3m, 2:5m, 3:10m) (m :分钟)

3.10 WDR

• 功能描述 设置WDR。

• 命令描述 Topic: "VIDEO_WDR" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") wdr: 状态(0：关闭， 1：打开)

3.11 停车监控时长

• 功能描述 设置停车监控时长，达到时长后，设备停止监控，关机；

• 命令描述 Topic: "MONITOR_TIME" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") gaplen: {"0", "6", "12", "24", "48", "96"}

3.12 停车监控模式

• 功能描述 设置停车监控下的工作模式

• 命令描述 Topic: "MONITOR_MODE" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") mode: "0", "1", "2"，分别对应模式："关闭", "缩时录影", "正常录像"

3.13 电压门限设置

• 功能描述 设置电压门限，以保护车子电瓶，低于门限后设备会自动关机

• 命令描述 Topic: "VOLTAGE_PRO" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") vpr: "0", "1", "2", "3"，分别对应电压门限："11.8V", "12V", "12.2V", "12.5V"

3.14 间隔录影

• 功能描述 设置间隔录影帧率，多少毫秒1帧

• 命令描述 Topic: "VIDEO_INV" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") gap: 状态(0:关闭,1:100ms, 2:200ms, 3:500ms)

3.15 图像水平镜像

• 功能描述 设置图像水平镜像

• 命令描述 Topic: "MIRROR_HOR" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") status: 状态(0:关闭,1:镜像)

3.16 图像上下翻转

• 功能描述 设置图像上下翻转

• 命令描述 Topic: "FLIP_VER" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") status: 状态(0:关闭,1:镜像)

3.17 移动侦测

• 功能描述 设置移动侦测。

• 命令描述 Topic: "MOVE_CHECK" errno: 参考设备错误列表, op: 操作类型("GET","NOTIFY") mot: 状态(0：关闭， 1：打开)

3.18 录像时间水印

• 功能描述 设置录像文件的录像时间水印。

• 命令描述 Topic: "VIDEO_DATE" errno: 参考设备错误列表, op: 操作类型("GET","NOTIFY") dat: 状态(0：关闭， 1：打开)

3.19 照片时间水印

• 功能描述 设置拍照文件的时间水印。

• 命令描述 Topic: "PHOTO_DATE" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") dat: dat(0: off 1: on )

3.19 设置扬声器音量

• 功能描述 设置扬声器音量。

• 命令描述 Topic: "SPEAKER_VOLUME" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") volume: (0: off 1: low 2: middle 3: high )

3.20 录音开关设置

• 功能描述 设置录音。

• 命令描述 Topic: "VIDEO_MIC" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") mic: 状态(0：关闭， 1：打开)

3.21 设置文件加锁

• 功能描述 设置文件加锁。

• 命令描述 Topic: "FILE_LOCK" errno: 参考设备错误列表, op: 操作类型("PUT","NOTIFY") status: 状态(0：未加锁， 1：已加锁)

  注意： 目前设置指令只支持加锁，不支持解锁

3.22 设置红外灯开关

• 功能描述 设置红外灯开关

• 命令描述 Topic: "IR_SWITCH" errno: 参考设备错误列表, op: 操作类型("PUT","NOTIFY") ir: 状态(0：关闭， 1：打开)

3.23. 按键声音

• 功能描述 设置按键声音。

• 命令描述 Topic: "KEY_VOICE" errno: 参考设备错误列表, op: 操作类型("GET","NOTIFY") kvo: 状态(0: off,1: on)

3.24 停车守卫

• 功能描述 设置停车守卫开关。

• 命令描述 Topic: "VIDEO_PAR_CAR errno: 参考设备错误列表, op: 操作类型("GET","NOTIFY") par: 状态(0：关闭， 1：打开)

3.25 防手抖

• 功能描述 设置防手抖。

• 命令描述 Topic: "ANTI_TREMOR" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") sok: (0: off 1: on )

3.26 电子狗播报开关

• 功能描述 设置电子狗播报开关

• 命令描述 Topic: "EDOG_VOICE" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") evo: (0: off 1: on )

3.27 拍照分辨率

• 功能描述 设置拍照分辨率

• 命令描述 Topic: "PHOTO_RESO" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") res: "0", "1", "2", "3", "4", "5", "6", "7 对应："VGA", "1.3M", "2M", "3M", "5M", "8M", "10M", "12M"

3.28 拍照质量

• 功能描述 设置拍照质量
• 命令描述 Topic: "PHOTO_QUALITY" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") qua: "0", "1", "2" 对应："low", "middle", "high"

3.28 曝光补偿

• 功能描述 设置曝光补偿。

• 命令描述 Topic: "VIDEO_EXP" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") exp: (0:+2 1:+5/3 2:+4/3 3:+1 4:+2/3 5:+1/3 6:0 7:-1/3 8:-2/3 9:-1 10:-4/3 11:-5/3 12:-2 )

3.29 碰撞感应灵敏度

• 功能描述 设置碰撞感应灵敏度。

• 命令描述 Topic: "GRA_SEN" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") gra: 状态(0:关闭,1:low, 2:middle, 3:high)

3.30 停车监控中碰撞感应灵敏度

• 功能描述 设置停车监控中碰撞感应灵敏度。

• 命令描述 Topic: "VIDEO_PAR_VSIX" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") par: 状态(0:关闭,1:low, 2:middle, 3:high)

3.31 光源频率

• 功能描述 设置光源频率。

• 命令描述 Topic: "LIGHT_FRE" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") fre: 状态(0:50Hz,1:60Hz)

3.32 TV模式

• 功能描述 设置TV模式。

• 命令描述 Topic: "TV_MODE" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") tvm: 状态(0:pal,1:ntsc )

3.32 自动关机

• 功能描述 设置自动关机。

• 命令描述 Topic: "AUTO_SHUTDOWN" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") aff: 状态(0: off,1:3m 2:5m 3:10m)

3.33 屏幕保护

• 功能描述 设置屏幕保护。

• 命令描述 Topic: "SCREEN_PRO" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") pro: 状态(0: off,1:30SEC 2:1MIN 3:2MIN)

3.34 设置设备的ssid或wifi密码

• 功能描述 设置设备的ssid 或 wifi密码。

• 命令描述 Topic: "AP_SSID_INFO" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") ssid: WiFi名：字符串 pwd:密码：字符串 status: 是否立即生效（0：否 1：是），当前固定位1

3.35 格式化

• 功能描述 设置格式化。

• 命令描述 Topic: "FORMAT" errno: 参考设备错误列表, op: 操作类型("PUT ","NOTIFY") frm: 状态(0:失败,1:成功 )

3.36 恢复出厂默认设置

• 功能 恢复出厂默认设置

• 命令描述 Topic: "SYSTEM_DEFAULT" errno: 参考设备错误列表, op: 操作类型("PUT","NOTIFY") def: 状态(0:no,1:yes )

3.37 GPS时间同步开关

• 功能描述 设置GPS时间同步开关

• 命令描述 Topic: "VIDEO_SYNC" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") evo: (0: off 1: on )

3.38 驾驶休息提醒

• 功能描述 设置驾驶休息提醒开关

• 命令描述 Topic: "VIDEO_RDER" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") rder: (0: off 1: on )

3.39 时区设置

• 功能描述 设置时区设置

• 命令描述 Topic: "TIME_ZONE" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") zone:

  • "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10","11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21","22", "23", "24" 对应:
  • "GMT -12", "GMT -11", "GMT -10", "GMT -9", "GMT -8", "GMT -7", "GMT -6", "GMT -5", "GMT -4", "GMT -3", "GMT -2","GMT -1", "GMT 0", "GMT +1", "GMT +2", "GMT +3", "GMT +4", "GMT +5", "GMT +6", "GMT +7", "GMT +8", "GMT +9","GMT +10", "GMT +11", "GMT +12"

3.40 查询设备固件版本

• 功能描述 查询设备固件版本

• 命令描述 Topic: "FW_VERSION" errno: 参考设备错误列表, op: 操作类型("GET",NOTIFY") ver: v1.0.1

3.41 电池状态

• 功能描述

• 命令描述 Topic: "BAT_STATUS" errno: 参考设备错误列表, op: 操作类型，“GET” “NOTIFY", level: 电池电量（0：3.7V 1：3.85V 2：4.0V 3：4.05V, 4: 充电中）

3.42 TF卡容量

• 功能描述 获取TF卡容量。

• 命令描述 Topic: "TF_CAP" errno: 参考设备错误列表, op: 操作类型("GET","NOTIFY") left: 剩余空间大小(单位为Mb) total:总空间大小(单位为Mb)

3.43 录像分辨率设置新协议

新:(VIDEO_SIZE) 旧:(VIDEO_PARAM)

(注：如果"VIDEO_SIZE"该地址有定义，那么按该地址的方式来实现；若"VIDEO_SIZE"未定义，则按原先的(VIDEO_PARAM)方式实现)

• 命令描述 Topic: "VIDEO_SIZE" errno: 参考设备错误列表, op: 操作类型("GET","PUT","NOTIFY") str: 菜单列表(例：如果是"4K;2K;1080P",那么选项分别为4K、2K、1080P;如果是"NA;2K;1080P",那么选项分别为2K、1080P,NA项不显示) val: 当前选项(srt 列表的第几个,从0开始)

3.44 语音

• 功能描述 设置语音开关。

• 命令描述 Topic: "SPEECH" errno: 参考设备错误列表, op: 操作类型("GET","NOTIFY") status: 状态(0: off,1: on)

3.45 12小时/24小时制式设置

• 功能描述 设置12小时/24小时制式设置。

• 命令描述 Topic: "HOUR_TYPE" errno: 参考设备错误列表, op: 操作类型("GET","NOTIFY") type: 状态(0:12,1:24)

3.46 动态化菜单

• 背景说明： 现有杰里的接口暂无法动态扩展设置项的菜单,app很多设置项都是通过型号写死的，为了解决动态化问题,目前可以在返回的数据结构里面新增两个字段,用来新增或者扩展现有的Topic设置项。

• 特别说明： Topic和TopicKey在app端和设备端都是固定写死的，要一一对应

• 举例： Topic: "VIDEO_LOOP"

TopicKey: "cyc"

• 未改之前 操作类型 | 发送参数说明 | 回复说明
  ---|:--|:---
  GET | "op":"GET" | "errno":0, "op":"NOTIFY","param":{ "cyc":"0"} PUT | "op":"PUT", "param":{"cyc":"0"} | "errno":0, "op":"NOTIFY", "param":{ "cyc":"0"}

• 扩展之后 操作类型 | 发送参数说明 | 回复说明
  ---|:--|:---
  GET | "op":"GET" | "errno":0, "op":"NOTIFY","param":{"cyc":"0","str":"OFF;1MIN;3MIN;5MIN","index":"0;1;2;3"} PUT | "op":"PUT", "param":{"cyc":"0"} | "errno":0, "op":"NOTIFY","param":{"cyc":"0"}

• 字段解释 新增字段里面的内容都是一个字符串，值是用分号(;)来分割

1、str：该设置项对应的可读性的参数列表，主要用在app界面显示，比如 VIDEO_LOOP 的 可设置参数有4个：OFF(关)，1MIN（1分钟），3MIN（3分钟），5MIN（5分钟）

2、index：该设置项对应的参数值的列表，用来进行对 Topic 进行设置时的参数值，比如 VIDEO_LOOP 的可设置参数有4个：0，1，2，3

3、cyc：对应的是TopicKey，它的值，必须是index集合里面的其中一个，否则，app将无法匹配，就不会显示

• 其它支持以上规则的设置项 MONITOR_TIME、VIDEO_INV、SCREEN_PRO

3.47 设备能力集获取

• 功能描述 设备能力集获取。

• 命令描述 Topic: "CAMERA_CAPABILITY" errno: 参考设备错误列表, op: 操作类型("GET","NOTIFY") value: 能力集的字符串

其中value的每一位代表1个业务能力(方案商实现时，如果对某位的业务不支持或是不了解，默认填0)：

第0位：GPS数据业务

- 0 不支持GPS
- 1 仅支持下载后的视频文件GPS数据获取；
- 2 支持下载后的视频文件、在线回放的视频文件GPS数据获取；
- 3 支持下载后的视频文件、在线回放的视频文件、实时画面GPS数据获取；
- 4 支持下载后的视频文件、实时画面GPS数据获取；

第1位：1-运动相机，0-记录仪（默认）

第2位：1-不支持停车监控相册，0-支持停车监控相册（默认）

第3位：1-该设备支持通过APP操作文件加锁，0-不支持（默认）

第4位：1- 不支持删除加锁文件；0-支持删除加锁文件（默认）; 如果有需求不能删除加锁文件，修改此字段；

第5位：部分芯片拍照需要切换到拍照模式的，1- 不切换模式，直接录像码流抓拍，0-（默认）切换模式进行抓拍或是当前默认方式

第6位：回放是否使用rtsp的流，如果部分设备回放码率特别大，wifi传输会造成回放卡顿，需要使用rtsp播放小码流时，可以修改此字段（回放是否支持rtsp还需要设备端支持）；

0-(默认)-不使用rtsp的流，使用文件下载播放的方式， 
1- 使用RTSP的协议TCP播放回放实时流  
2- 使用RTSP的协议UDP播放回放实时流；

第7位：是否支持拍照功能，0(默认)-支持拍照功能， 1- 不支持拍照，只支持录像；部分设备资源不够，不支持拍照功能时，修改此字段，app上将会隐藏拍照按钮；

第8位：是否支持APP修改wifi名或wifi密码

- 0(默认)- 支持修改WiFi名和WiFi密码，
- 1-不支持修改WiFi名，支持修改WiFi密码，此时WiFi名将会隐藏；
- 2-支持修改WiFi名，不支持修改WiFi密码，此时WiFi密码将会隐藏；
- 3.不支持修改WiFi名，且不支持修改WiFi密码，此时WiFi名和密码都将会隐藏；

第9位：0(默认)- 不支持文件拷贝，1-支持文件拷贝

第10位：是否使用其他非HTTP的方式下载设备视频文件，0(默认)-APP自己决定下载策略，1.固定使用原厂sdk的方式下载设备视频文件，2-固定使用http下载设备视频文件，当前主要是针对杰理方案，非特殊需求，请使用默认值0；

第n位：待补充