createDeviceRecordHls（根据设备录像片段生成 hls 直播地址）

createDeviceRecordHls：根据设备录像片段生成 hls 直播地址

要点：https://openapi.lechange.cn/openapi/createDeviceRecordHls · 见错误码

根据设备号、通道号、时间段创建设备的录像的 hls 地址。

请求参数

参数名	参数类型	是否必填	合法值	参数说明
token	String	是		管理员 accessToken；子账号 token 返回 `OP_SUB_NO_USE`
deviceId	String	是		设备序列号
channelId	String	是		通道号
streamId	Integer	否		码流类型，0-主码流，1-辅码流，不传默认主码流
beginTime	String	是		回放起始时间，格式 yyyy-MM-dd HH:mm:ss，不支持跨天时间
endTime	String	是		回放截止时间，格式 yyyy-MM-dd HH:mm:ss，不支持跨天时间
recordType	String	是	localRecord 设备本地录像,cloudRecord 设备云录像	回放录像类型

请求示例

{
  "system": {
    "ver": "1.0",
    "appId": "lcdxxxxxxxxx",
    "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
    "time": 1603366946,
    "nonce": "2e84717c-0f22-4424-8afe-19bab0d6d606"
  },
  "id": "051824b1-9655-4755-9cc2-adcc9ab5fef1",
  "params": {
    "deviceId": "TESTQWERXXXX",
    "channelId": "0",
    "token": "<yourAccessToken>",
    "beginTime": "2022-01-01 10:50:50",
    "endTime": "2022-01-01 11:50:50",
    "recordType": "localRecord"
  }
}

响应字段

字段名	字段类型	字段说明
url	string	hls地址

响应示例

{
  "result": {
    "msg": "操作成功。",
    "code": "0",
    "data": {
      "url": "https://paashls04-vpc.lechange.com:7080/vod/97eb092514758f7ffc3e50a870d8f4e4.m3u8?proto=https"
    }
  },
  "id": "051824b1-9655-4755-9cc2-adcc9ab5fef1"
}

错误码

本接口可能返回下列码；完整分组见错误码。

网关与鉴权（SN / TK / OP）

错误码	错误码说明	下一步
`SN1001`	签名异常	按签名核对 `sign`
`TK1002`	token 无效或过期	重新获取 token
`OP1002`	缺少必填参数	补必填字段
`OP1003`	参数不合法	按本页参数表核对
`OP1039`	分钟级限流	等到下一分钟再试
`OP1040`	调用超限	降低频率
`DV1007`	设备离线或超时	等设备上线

子账号（SUB）

错误码	错误码说明	下一步
`SUB1001`	子账号无指定权限	在子账号策略中补权限
`SUB1002`	子账号无任何设备权限	授权设备或调整策略
`SUB1005`	子账号 token 过期	重新获取子账号 token
`SUB1006`	子账号与设备无授权关系	核对 `Resource` 与设备序列号
`SUB1008`	子账号未绑定当前应用	先创建并绑定子账号
`SUB1007`	创建子账号失败	核对参数后重试
`SUB1009`	子账号创建失败，账号格式错误	`account` 须为手机号或邮箱
`SUB1010`	子账号创建失败，账号已存在	勿重复绑定同一子账号到应用

更多见错误码 · SUB。

设备访问与通道（DV10xx）

错误码	错误码说明	下一步
`DV1007`	设备离线或超时	等设备上线；低电休眠先唤醒
`DV1009`	设备正忙	稍后重试
`DV1012`	分享/授权设备权限不足	核对子账号 `Permission` / `Resource`
`DV1019`	能力集不支持	确认型号与设备能力
`DV1020`	通道离线	检查通道与设备状态
`DV1026`	不支持此功能	换接口或升级固件
`DV1028`	未绑定或通道不存在	核对 `deviceId` / `channelId`
`DV1030`	设备休眠	唤醒后再调
`DV1057`	通道不存在	核对通道号
`DV1061`	设备响应超时	检查设备网络
`DV1062`	需先唤醒设备	调用唤醒接口
`DV1069`	不满足操作条件	见 `msg`

直播绑定（LV）

错误码	错误码说明	下一步
`LV1001`	直播已存在	先解绑或换源
`LV1002`	直播不存在	先创建直播
`LV1005`	直播信息不存在	核对直播 id
`LV1006`	同 rtsp 源当日仅可绑一次	次日再绑
`LV1008`	需实名认证	在开放平台完善主体信息
`LV1020`	已绑定直播无法删除	先解绑
`OP1021`	获取播放地址失败	检查直播状态与套餐
`OP1022`	需开启云解码授权	按返回说明在 App 中授权

更多见错误码 · LV。

说明

仅支持管理员 accessToken；子账号与用户模式 token 不可调用本接口（与 bindDeviceLive 一致）。用户模式直播为独立 Open-Hls 入口，不在本页方法名内。

beginTime/endTime 须 同一自然日（网关保证 begin≤end）；勿按跨日样例调用。下游 PaaS 可能对跨日片段另有限制。