bindDeviceLive（创建设备源直播地址）

bindDeviceLive：创建设备源直播地址

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

创建设备源直播地址。重要：直播地址对外公开后，他人可直接查看摄像头视频画面，请注意妥善保管您的直播地址。

请求参数

参数名	参数类型	是否必填	默认值	合法值	参数说明
token	String	是			管理员accessToken
deviceId	String	是			设备序列号
channelId	String	是			通道号
streamId	Integer	是			码流类型,0:高清主码流；1:标清辅码流
liveMode	String	否	`cdn`	`cdn`、`proxy`	直播链路：缺省为 `cdn`；代理转发填 `proxy`

请求示例

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
        "time":1603366491,
        "nonce":"7aed0429-1a92-4a51-b8b0-cfebb60dcc85"
    },
    "id":"a25f887f-33f0-44ef-9ed3-f60f83193482",
    "params":{
        "streamId":1,
        "deviceId":"TESTQWERXXXX",
        "channelId":"0",
        "token": "<yourAccessToken>"
    }
}

响应字段

字段名		字段类型	字段说明
liveToken		String	直播授权token
liveStatus		Integer	直播状态（1：开启；2：暂停）
liveType		Integer	直播源类型（1：设备；2：流地址）
deviceId		String	设备序列号
channelId		String	通道号
coverUpdate		Integer	视频封面更新频率（单位：s）
streams	hls	String	直播流hls访问地址
	coverUrl	String	直播视频封面图地址
	streamId	Integer	码流类型（0:高清主码流；1:标清辅码流）(当直播地址由rtsp源生成时，无该字段)
job	status	Boolean	直播计划状态（true:开；false:关）
job	period	String	任务周期

响应示例

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
            "liveType":1,
            "coverUpdate":90,
            "streams":[
                {
                    "coverUrl":"http://livecloudpic.lechange.cn/LCO/TESTQWERXXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.jpg",
                    "streamId":1,
                    "hls":"http://cmgw-vpc.lechange.com:8888/LCO/TESTQWERXXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.m3u8"
                }
            ],
            "liveToken":"57877dd6774f4cbeb657568be0b7a621",
            "job":[
                {
                    "period":"always",
                    "status":true
                }
            ],
            "deviceId":"TESTQWERXXXX",
            "liveStatus":1,
            "channelId":"0"
        }
    },
    "id":"a25f887f-33f0-44ef-9ed3-f60f83193482"
}

错误码

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

网关与鉴权（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；子账号不可调用本接口。

接口请求格式

接口请求方式及部分鉴权参数如sign等计算方式，请参考开发规范