1. 功能说明

用于监控录像,支持RTSP/RTCP/RTP协议的录播

2. 协议设计原则

  • 完全支持RFC2326,RTSP/RTCP/RTP协议
  • 采用HTTP协议通讯
  • 采用EasyProtocol协议格式
  • 本服务为RMS

3. 请求地址

GET http://[通过CMS的协议获得地址]:[通过CMS的协议提供端口]/api/easyrecordmodule

4. 消息类型定义

定义 描述
MSG_CLI_SMS_HLS_ACK 应答开始/停止录像
MSG_CLI_RMS_RECORD_LIST_ACK 应答获取录像列表

5. 调用方法

5.1 启动录像

  • 调用示例

http://123.123.123.123:10800/api/easyrecordmodule?name=aabbccdd2fa5&url=rtsp://123.123.123.123:10700/test.sdp

  • 返回示例
{
   "EasyDarwin" : {
      "Header" : {
         "MessageType" : "MSG_CLI_SMS_HLS_ACK",
         "Version" : "1.0"
      }
   }
}
  • 调用参数说明
参数 选项 说明 备注
name 必填 设备序列号 设备的序列号
url 必填 设备RTSP推流地址 设备的RTSP推流地址
  • 返回数据说明
参数 说明 备注
Header:Version 王力云平台的API版本,所有服务统一版本号 公共参数version
Header:MessageType 请求的消息类型 消息类型定义

5.2 停止录像

  • 调用示例

http://123.123.123.123:10800/api/easyrecordmodule?name=aabbccdd2fa5&cmd=stop

  • 返回示例
{
    "EasyDarwin": {
        "Header": {
            "MessageType": "MSG_CLI_SMS_HLS_ACK",
            "Version": "1.0"
        }
    }
}
  • 调用参数说明
参数 选项 说明 备注
name 必填 设备序列号 设备的序列号
cmd 必填 命令字 stop
  • 返回数据说明
参数 说明 备注
Header:Version 王力云平台的API版本,所有服务统一版本号 公共参数version
Header:MessageType 请求的消息类型 消息类型定义

5.3 获取录像列表

  • 调用示例

http://123.123.123.123:10800/api/easyrecordmodule?name=aabbccdd2fa5&cmd=list&begin=20170901000000&end=20170930153045

  • 返回示例
{
    "EasyDarwin": {
        "Body": {
            "Records": [
                {
                    "time": "20170920094820",
                    "url": "http://av.wonlycloud.com/1234567890/20170920094820/1234567890.m3u8"
                },
                {
                    "time": "20170920095020",
                    "url": "http://av.wonlycloud.com/1234567890/20170920095020/1234567890.m3u8"
                }
            ]
        },
        "Header": {
            "MessageType": "MSG_CLI_RMS_RECORD_LIST_ACK",
            "Version": "1.0"
        }
    }
}
  • 调用参数说明
参数 选项 说明 备注
name 必填 设备序列号 设备的序列号
cmd 必填 命令字 list
begin 必填 查询记录开始时间 需要查询录像列表的开始时间,格式为yyyyMMddHHmmss
end 必填 查询记录结束时间 需要查询录像列表的结束时间,格式为yyyyMMddHHmmss,例如查询2015年11月1日至2015年11月3日15时30分45秒的所有录像
  • 返回数据说明
参数 说明 备注
Header:Version 王力云平台的API版本,所有服务统一版本号 公共参数version
Header:MessageType 请求的消息类型 消息类型定义
Body:Records:time 本条录像的时间 本条录像的时间,格式为yyyyMMddHHmmss
Body:Records:url 本条录像的地址 本条录像的播放地址