本页目录
请求参数
请求示例
响应字段
响应示例
错误码
说明
相关

createDeviceFlvLive（创建设备flv直播（支持录像直播和实时直播））

createDeviceFlvLive：创建设备flv直播（支持录像直播和实时直播）

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

根据设备号、通道号创建flv协议的直播地址（支持录像直播和实时直播）。

请求参数

参数名参数类型是否必填默认值合法值参数说明
tokenString是授权token，支持管理员和用户模式
deviceIdString是设备序列号
channelIdString是通道号
typeString否realTimerealTime实时视频直播,playback回放视频直播直播类型，realTime实时直播，playback回放视频直播
beginTimeString否beginTime和endTime最大跨度24小时，可跨天回放起始时间，格式yyyy-MM-dd HH:mm:ss。type为“playback”时必填
endTimeString否beginTime和endTime最大跨度24小时，可跨天回放截止时间，格式yyyy-MM-dd HH:mm:ss。type为“playback”时必填
recordTypeString否localRecord设备本地录像,cloudRecord设备云录像回放录像类型，type为“playback”时必填
speedInteger否1倍速云录像直播可选 2/4/8/16 倍速，本地录像直播可选 2/4/8 倍速回放直播画面多倍速播放。只有type为“playback”时生效

请求示例

{
    "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>",
        "type": "playback",
        "beginTime": "2022-01-01 10:50:50",
        "endTime": "2022-01-02 10:50:50",
        "recordType": "localRecord",
        "speed": 2
        
    }
}

响应字段

字段名字段类型字段说明
deviceIdString设备序列号
channelIdString设备通道号
flvString标清flv直播地址
flvHDString高清flv直播地址

响应示例

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
			"deviceId": "TESTQWERXXXX",
			"channelId": "0",
			"flv": "https://flvproxy-hzpaas-hzaliedge.lechange.com:7088/vod/c4908bc67e190fcd8c4b090bc4f6a099.flv?expire=1645511833&digest=cd7cb066fad01a9c6834f26af796406c",
            "flvHD": "https://flvproxy-hzpaas-hzaliedge.lechange.com:7088/vod/031bafb40770a8c129a9be993f62c79f.flv?expire=1645511833&digest=789d50426fcff6b2bf8959f6c26dc8cc"
        }
    },
    "id":"051824b1-9655-4755-9cc2-adcc9ab5fef1"
}

错误码

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

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

错误码错误码说明下一步
SN1001签名异常按 签名 核对 sign
TK1002token 无效或过期重新获取 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；子账号不可调用本接口。FLV 地址按 deviceId+channelId 管理，不需 bindDeviceLive 的 HLS liveToken。

  • type=realTime（默认）：实况地址写入 Open-Hls，可用 deleteDeviceFlvLive / queryDeviceFlvLive 删查；同通道重复创建可能返回 LV1001（已存在）。
  • type=playback：一次性点播 URL（createDeviceFlvVod 路径），不入库；到期失效后勿调 delete/query 清理。非白名单账号可能受并发/流量校验；localRecord 前须确认时间段内有片（可先 queryLocalRecords），无录像常见 NO_CLOUD_RECORD。国标设备本地录像场景下 flv 与 flvHD 可能返回相同 URL。
  • Ot_ 前缀 OAuth token 创建 realTime 可能返回不支持鉴权操作类错误，请用管理员 accessToken。

相关

queryDeviceRtmpLive（查询rtmp协议直播地址）
deleteDeviceFlvLive（删除设备flv直播（只支持删除实时直播））