• 1. 概述
• 2. 当前支持
  • 2.1 概述
  • 2.2 CMD表格
  • 2.3 关于记录仪文件特殊性
    • 2.3.1 停车监控视频
    • 2.3.2 紧急视频：
    • 2.3.3 显示前后视频标记：
  • 2.4 录像状态
• 3. 部分功能补充说明
  • 3.1 多存储卡支持
    • • 3.1.1 获取当前存储信息列表
        • 请求参数
        • 响应结果参数说明
      • 3.1.2 切换查看存储文件的存储卡
        • 请求参数
        • 响应结果参数说明
  • 3.2. 电压选项
    • • 3.2.1 支持电压选项
        • 请求参数
        • 响应结果参数说明
  • 3.3 多路摄像头识别
    • 方式一：使用CMD3028的响应结果
    • 方式二：自定义CMD 9095
  • 3.4 设备能力集查询

1. 概述

本文档描述当前公版APP兼容联咏方案的CMD和设置项，如果想要设备更好的匹配我们公版APP，请认真核对下面的协议；

对1.0版本的公版APP主要有以下几个功能模块：

1. 实时预览：按联咏官方定义，使用RTSP协议，支持over tcp 或是 udp其中之一即可；rtsp地址 通过CMD 2019中的响应MovieLiveViewLink字段：

   http://192.168.1.254/?custom=1&cmd=2019
   <?xml version="1.0" encoding="UTF-8" ?>
   <LIST> 
   <MovieLiveViewLink>rtsp://192.168.1.254/xxx.mov</MovieLiveViewLink>
   <PhotoLiveViewLink>http://192.168.1.254:8192</PhotoLiveViewLink>
   </LIST>
   

   或是固定为：

   rtsp://192.168.1.254/xxx.mov
   

   如果需要指定底层的通讯协议是tcp 或 udp，需要增加over字段，可选参数：tcp 或是 udp，当如果预览有花屏时，可以尝试设置为‘tcp'，如下：

   http://192.168.1.254/?custom=1&cmd=2019
   <?xml version="1.0" encoding="UTF-8" ?>
   <LIST> 
   <MovieLiveViewLink>rtsp://192.168.1.254/xxx.mov</MovieLiveViewLink>
   <PhotoLiveViewLink>http://192.168.1.254:8192</PhotoLiveViewLink>
   <Over>tcp</Over>
   </LIST>
   

2. 文件列表和回放 文件列表通过联咏官方文档CMD 3015来获取； 只要设备端支持http server 即可支持视频的在线回放，但要注意：http server 要支持http的range 0-xx的协议；

3. 拍照、录像 按联咏的官方CMD即可完成对接；

4. 设置项 联咏的官方定义了部分设置项，但各个方案商厂家进行了设置项的扩展，不同的厂家会存在设置项的CMD的冲突（相同的CMD在不同的方案商上代表的含义不一样），对此当前有两种解决方案可以完成适配：

   • 按下表中的“命令字(当前使用的)”，进行匹配， 其中如果是“6013#9967#3040” 由‘#’进行分割的多个，只要方案商定义的是其中之一即可适配；
   • 用最后一列“6帧探官方”的，我们即可适配；

2. 当前支持

2.1 概述

本表描述了当前支持的各个功能和设置对应的CMD，此处列出了CMD和业务对应关系，只要对应一致，即可功能正常；下表的各个字段含义：

• 命令字(当前使用的)： 当前适配的CMD，如果设备方案中使用的”命令字“和 “命令功能”和此表对应，则APP能够正常显示功能，否则则需要调整；
• 命令功能： 该CMD对应的业务功能描述；
• CMD类型：我们将CMD分为3类来进行统一描述（操作、选项、开关）
  • 选项普通的业务操作，比如：拍照、开始录像、停止录像等；
  • 设置界面中的开关类设置项，比如：mic的开关，时间水印开关；
  • 设置界面中的下拉选项类设置项，比如：录像时长（1分钟、3分钟、5分钟）
• 是否官方文档中的： 联咏提供有一份官方的协议文档，其中定义大部分的官方CMD，官方定义的CMD，以官方为准；
• 6帧探官方定义：为了更好的方便和统一个方案商新增CMD，6帧探官方定义了一套，公版APP会优先适配；
• 备注： 某些CMD的特殊扩展含义描述；

2.2 CMD表格

关于 “官方”的CMD详情，请参考 《NT9666x Wi-Fi Command User Guide.pdf》；

CMD为 “6013#9967#3040” 表示：只用对应其中的一个CMD(比如：3040)，就表示支持该项目；

2.3 关于记录仪文件特殊性

2.3.1 停车监控视频

现在大部分的设备都支持停车监控，app中记录仪文件中有个独立的文件夹：“停车视频”，为了让停车监控时所录制的文件适配到“停车视频”文件夹中，设备只要满足如下条件即可（不区分大小写）：

CMD3015上报APP的文件路径中含有“MOVIE_TL" 、"parking"、"24HOUR"、"_T"之一即可；

2.3.2 紧急视频：

APP会对碰撞视频用单独的文件夹存放，怎么识别出文件列表的视频是碰撞视频，满足以下条件其一（不区分大小写）即可：

1. 文件路径中含有“RO"、"EMR"、"SOS"之一；
2. 文件只读；

2.3.3 显示前后视频标记：

APP会对前后路的文件显示标签，让用户可以很容易区分出是哪路摄像头记录的视频文件： 前后路文件区分，以下条件具备其一即为后路文件（不区分大小写：

1. 文件名以"b"结尾）； 比如xxxxxx_b.mp4 或 2019121223212B.mp4
2. 文件路径中含有”_rear“、"emr_e"、"movie_e" ，比如：/movie/movie_e/2019121223212B.mp4

2.4 录像状态

APP上会显示当前的录制状态，录制状态通过2016获取，官方文档描述：

Command: http://192.168.1.254/?custom=1&cmd=2016
Parameter: Null

<?xml version="1.0" encoding="UTF-8" ?>
- <Function>
<Cmd>2016</Cmd>
<Status>0</Status>
<Value>0</Value>
</Function>

Note:
1. The value 0 means is not recording
2. If cyclic record on, the recording time would reset depend on cyclic period.

value 为0表示当前未启动录制；大于0 表示正在录制中

3. 部分功能补充说明

3.1 多存储卡支持

3.1.1 获取当前存储信息列表

请求参数

• CMD: 8018
• 请求样例：

        http://192.168.1.254/?custom=1&cmd=8018
  

响应结果参数说明

响应结果举例：

    <?xml version="1.0" encoding="UTF-8" ?>
    <Function>
    <Cmd>8018</Cmd>
    <Status>0</Status>
    <List>
    <Option>
    <Index>0</Index>
    <Name>eMMC</Name>
    <FreeSize>14990376960</FreeSize>
    <TotalSize>14990442496</TotalSize>
    </Option>
    <Option>
    <Index>1</Index>
    <Name>SD Card</Name>
    <FreeSize>55450075136</FreeSize>
    <TotalSize>62247665664</TotalSize>
    </Option>
    </List>
    </Function>

3.1.2 切换查看存储文件的存储卡

请求参数

• CMD: 8019
• 请求样例：

        http://192.168.1.254/?custom=1&cmd=8019&par=0
  

响应结果参数说明

响应结果举例：

<?xml  version="1.0"  encoding="UTF-8"  ?>
  <Function>
  <Cmd>8019</Cmd>
  <Status>0</Status>
  </Function>

3.2. 电压选项

3.2.1 支持电压选项

电压选项通常有12V 和 24V两种场景：

• 当设备场景下只支持其中一种时采用9001的方式进行设置，这是联咏的通用的某个设置的选项；

• 如果是 12V和24V都同时支持，我们希望通过我们自定义的布局实现，而非当前底部弹框(选项太多了)

  • 当前已经实现了一种方案(万汇的)，app只能获取到当前值，其他app写死处理的；
  • 暂未实现，只是假设： 设备列出所有选项，app分析出12V和24V，进入自定义界面？

请求参数

• CMD: 9001
• 请求样例：

        http://192.168.1.254/?custom=1&cmd=9001&par=0
  

响应结果参数说明

响应结果举例：

<?xml  version="1.0"  encoding="UTF-8"  ?>
  <Function>
  <Cmd>9001</Cmd>
  <Status>0</Status>
  </Function>

3.3 多路摄像头识别

怎么让APP知道设备当前有几个摄像头，以便app支持多镜头切换的功能，按下面的方式实现其一即可；

方式一：使用CMD3028的响应结果

联咏官方CMD中没有多路摄像头，但是有"Setup PIP Style"的CMD 3028，APP根据该CMD进行是否支持多路摄像头的切换处理；

切换多路摄像头

• CMD: 3028 (Set PIP (Picture in Picture) style for live view streaming (HTTP + MJPG))
• 请求样例：

        http://192.168.1.254/?custom=1&cmd=3028&par=0
  

  其中的参数par:
  • 0: 双路中的前路画面
  • 1：双路中的后路画面
  • 2：前后路画面画中画模式(前路是主画面)；
  • 3：前后路画面画中画模式(后路是主画面)；

APP是怎么识别有多个摄像头

• 通过3031中获取设置支持的设置项中，返回3028，且返回的3028的选项个数>=2;

举例：

请求：
http://192.168.1.254:80/?custom=1&cmd=3031&str=all

响应结果中部分：
……
<Item>
<Cmd>3028</Cmd>
<Name>PIP_VIEW</Name>
<MenuList>
<Option>
<Index>0</Index>
<Id>1T1F</Id>
</Option>
<Option>
<Index>1</Index>
<Id>2T2F</Id>
</Option>
<Option>
<Index>2</Index>
<Id>1T1B2S</Id>
</Option>
<Option>
<Index>3</Index>
<Id>1T1S2B</Id>
</Option>
</MenuList>
……

方式二：自定义CMD 9095

• CMD: 9095
• 操作：查询

Command: http://192.168.1.254/?custom=1&cmd=9095

<?xml version="1.0" encoding="UTF-8" ?>
- <Function>
<Cmd>9095</Cmd>
<Status>0</Status>
<Value>1</Value>
</Function>

• CMD : 9095
• Vaule： 镜头数
  • 1：单镜头
  • 2：两个镜头

3.4 设备能力集查询

• CMD: 9143
• 操作：查询

Command: http://192.168.1.254/?custom=1&cmd=9143

<?xml version="1.0" encoding="UTF-8" ?>
<Function>
<Cmd>9143</Cmd>
<Status>0</Status>
<String>1000</String>
</Function>

其中String自动的每一位代表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位：待补充