回放控制
功能介绍
录像回放控制信令下发,目前只适配FLV协议回放
URI
POST /v2/{user_id}/media/control/recordctl
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
user_id |
是 |
String |
用户ID:由数字组成,长度范围[15,25],获取方式参考获取user ID与下载AK/SK章节 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Access-Token |
是 |
String |
用户认证AccessToken:从获取用户北向接口认证AccessToken中获取 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
device_id |
是 |
String |
设备ID: 好望设备:大小写字母、数字组成,长度范围[8,32],可在设备外壳或者设备web页面上获取 国标设备:由数字组成,长度固定为20个字符长度,由客户自行设置,其中第11-13位,必须是以下之一132(IPC)、111(DVR)、118(NVR),用来区分设备类型 |
|
channel_id |
是 |
String |
通道ID: 好望设备:取值范围[0,999] 国标设备:由数字组成,长度为20个字符,由客户自行在设备侧设置,可以在web界面获取 |
|
session_id |
是 |
String |
录像唯一标识:使用获取回放地址统一接口返回的PlaybackConnectionsResp中的session_id |
|
domain |
是 |
String |
域名标识:使用获取回放地址统一接口返回的PlaybackConnectionsResp中的domain |
|
action |
是 |
String |
动作类型:枚举类型 枚举值: |
|
skip_time |
否 |
String |
跳转时间:格式如:yyyy-MM-dd HH:mm:ss,北京时间;不可与speed同时出现 |
|
speed |
否 |
Float |
倍速:取值范围(0.25, 0.5, 1, 2, 4, 8, 16),云端回放支持所有倍速,前端回放倍速依赖设备能力;不可与skip_time同时出现 |
请求示例
回放控制
POST /v2/123456789*****/media/control/recordctl
{
"device_id": "210123456SMY***",
"channel_id":"0",
"session_id":"172588870750***",
"domain": "123.123.123.123",
"action":"PLAY",
"speed":4
}
响应示例
状态码: 200
OK
{
"result": {
"code": "IVM.0",
"msg": "Success"
}
}
状态码
请参见状态码
错误码
请参见错误码