createDeviceFlvLive（创建设备 FLV 直播：实况与录像回放）
createDeviceFlvLive：创建设备 FLV 直播：实况与录像回放
功能说明
根据设备序列号与通道号创建 FLV 协议直播地址，支持实况（realTime）与录像回放（playback）。
请求地址
https://openapi-[DataCenter].easy4ip.com/openapi/createDeviceFlvLive
请求格式
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法取值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员 accessToken | ||
| deviceId | String | 是 | 设备序列号 | ||
| channelId | String | 是 | 通道号 | ||
| type | String | 否 | realTime | realTime、playback | 直播类型：realTime 实况；playback 录像回放 |
| beginTime | String | 否 | type 为 playback 时必填；回放起始时间，格式 yyyy-MM-dd HH:mm:ss；与 endTime 最大跨度 24 小时，可跨自然日 | ||
| endTime | String | 否 | type 为 playback 时必填；回放截止时间，格式 yyyy-MM-dd HH:mm:ss | ||
| recordType | String | 否 | localRecord、cloudRecord | type 为 playback 时必填；localRecord 本地录像；cloudRecord 云录像 | |
| speed | Integer | 否 | 1 | 云录像 2/4/8/16；本地录像 2/4/8 | 回放倍速，仅 playback 生效 |
请求体根字段
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| system | Object | 鉴权与版本 |
| id | String | 请求 ID |
| params | Object | 业务参数，见上表 |
请求示例
{
"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":"At_00000ad9e6e87f0142eb92e207aec46a",
"type": "playback",
"beginTime": "2022-01-01 10:50:50",
"endTime": "2022-01-02 10:50:50",
"recordType": "localRecord",
"speed": 2
}
}
返回 data 字段
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| deviceId | String | 设备序列号 |
| channelId | String | 设备通道号 |
| flv | String | 标清 FLV 地址 |
| flvHD | String | 高清 FLV 地址 |
响应根字段
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| result | Object | 返回结果 |
| id | String | 请求 ID |
响应示例
{
"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 | 签名校验异常 | 按 HTTP 开发规范 核对 sign |
TK1002 | token 无效或过期 | 重新获取 accessToken |
OP1002 | 缺少必填参数 | 补必填字段 |
OP1003 | 参数不合法 | 按本页参数表核对 |
OP1009 | 权限不足 | 核对 token 与设备绑定/分享权限 |
OP1013 | 接口总次数超限 | 降低调用频率 |
OP1014 | 接口日限额超限 | 见 接口调用限额 |
DV1007 | 设备离线 | 等设备上线 |
更多见 错误码 · OP/SN/TK。
子账号（SUB）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SUB1001–SUB1002 | 子账号无接口权限 | 在 addPolicy 中补策略 |
SUB1005 | 子账号 token 过期 | 重新 subAccountToken |
SUB1006 | 子账号与设备无授权 | 核对 Resource 与设备序列号 |
SUB1008 | 子账号未绑定应用 | 先创建并绑定子账号 |
更多见 错误码 · SUB。
设备访问与通道（DV10xx）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
DV1007 | 设备离线或超时 | 等设备上线 |
DV1009 | 设备正忙 | 稍后重试 |
DV1012 | 分享/授权设备权限不足 | 核对子账号 Permission / Resource |
DV1019 | 能力集不支持 | 确认型号与能力列表 |
DV1020 | 通道离线 | 检查通道状态 |
DV1026 | 不支持此功能 | 换接口或升级固件 |
DV1028 | 未绑定或通道不存在 | 核对 deviceId / channelId |
更多见 错误码 · DV。
直播绑定（LV）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
LV1001 | 直播已存在 | 先 unbindLive 或换源 |
| :--- | :--- | :--- |
LV1002 | 直播不存在 | 先创建直播 |
| :--- | :--- | :--- |
LV1005 | 直播信息不存在 | 核对直播 id |
| :--- | :--- | :--- |
LV1006 | 同 rtsp 源当日仅可绑一次 | 次日再绑 |
| :--- | :--- | :--- |
LV1008 | 需实名认证 | 在开放平台完善主体信息 |
| :--- | :--- | :--- |
LV1020 | 已绑定直播无法删除 | 先解绑 |
| :--- | :--- | :--- |
OP1021 | 获取播放地址失败 | 检查直播状态与套餐 |
| :--- | :--- | :--- |
OP1022 | 需开启云解码授权 | 按返回说明在 App 中授权 |
更多见 错误码 · LV。
说明
仅支持管理员 accessToken。FLV 按 deviceId+channelId 管理，不需 bindDeviceLive 的 HLS liveToken。
type=realTime（默认）：实况写入平台，可用 deleteDeviceFlvLive / queryDeviceFlvLive 删查；同通道重复创建可能返回 LV1001。type=playback：一次性点播 URL，不入库；到期失效后勿用 delete/query 清理。localRecord前请确认时间段内有录像；国标设备本地录像场景下flv与flvHD可能相同。Ot_前缀 OAuth token 创建realTime可能返回不支持鉴权操作类错误，请使用管理员 accessToken。