车载视频监控
车载视频监控服务是智能云首个软硬一体化方案,主要用于车辆主动安全报警监控。该服务包含云端和设备端,本文档介绍的API适用于从云端下发的指令操作。
接口概览
接口类型 | 描述 |
---|---|
直播、点播接口 | 车载视频监控支持端上直播、云端观看,以及端上历史视频的回放(点播)。该组接口包括建立直播接口、结束直播接口,建立点播接口、结束点播接口。 |
任务管理接口 | 端上报文件内容的同时云端会建立一个上传任务。任务管理接口包括文件上传、任务取消、状态查询、列表获取等。 |
获取地址接口 | 获取的地址包括视频播放地址、视频下载地址、图片下载地址。 |
权限下发接口 | ADAS/DMS设备参数设置相关接口。 |
检索相关接口 | 包括视频信息检索、报警+多媒体联合检索、报警信息检索、轨迹+报警+多媒体联合检索。 |
产品限制
目前产品仅支持车载视频监控相关设备使用,其他类型的设备将无法通过认证。
车载视频监控错误码
错误码 | 错误消息 | HTTP状态码 | 描述 |
---|---|---|---|
NotExistResource | 资源不存在: {message} | 404 | 指定的资源(视频、图片等)不存在。 |
InvalidVideoType | 非法音视频: {message} | 400 | 非法的音视频(传输格式非法等)。 |
InvalidAlarmType | 非法报警类型: {message} | 400 | 非法的报警类型。 |
DuplicateResource | 重复创建资源: {message} | 400 | 重复创建资源。 |
InvalidRequestParam | 请求参数有误: {message} | 400 | 请求参数有误。 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务。 |
setParamFailure | 参数设置失败 | 400 | 参数设置失败。 |
TaskNotPublished | 上传任务未发布 | 400 | 上传任务未发布。 |
MediaNotInCloud | 资源文件未上传到云端 | 400 | 资源文件未上传到云端。 |
MediaInWrongState | Media is in wrong state:{status}, operation not permitted | 400 | 多媒体状态不对,不允许操作。 |
ServerInternalError | {message} | 500 | 服务器内部错误。 |
DefaultPlayableUrlSizeExceedOne | Default playable url size exceeds 1, count={count} | 400 | 默认播放地址数超过1。 |
InvalidPageSize | pageSize参数不合法,合法范围为[1,{maxSize}] | 400 | 单页显示数(pageSize)不合法。 |
InvalidPageNum | pageNum参数不合法,pageNum应大于0 | 400 | 页码值(pageNum)不合法,应大于0。 |
PlaybackPushOccupied | 当前其他观众正在回看直播,通道被占用,请等待 | 400 | 当前已有历史回看正在推流,通道被占用,请等待 |
RealtimePushOccupied | 当前其他观众正在实时直播,通道被占用,请等待 | 400 | 当前已有实时监控正在推流,通道被占用,请等待 |
DeviceError | 设备有误:{message} | 400 | 设备有误。 |
VehicleOffline | 车辆离线:{message} | 400 | 车辆离线。 |
TryToRetry | 请重试 | 500 | 请重试。 |
MaxRetryCountExceeds | Upload task retry exceeds max count: %d", maxCount | 400 | 上传任务重传次数超过最大限制 |
直播、点播接口
开始实时视频监控
接口描述:本接口用于触发设备端实时视频监控。
- 此接口会与设备端进行交互,因此,调用此接口时应确保设备端处于连接状态;否则,调用会抛出异常(VehicleOffline)。
- 此接口会返回一个拉流的播放地址,用户可通过返回参数观看直播视频;参数videoType用于指定拉流视频的格式,支持RTMP、FLV、HLS。
注意事项
本接口用于指定特定的设备、特定的通道进行直播推流。
- 调用时确保设备属于多媒体设备(PK:QGON)
请求结构
POST /v1/video/real-time/{vehicleId}/{channel}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"dataType" : dataType,
"streamType" : streamType,
"videoType" : videoType
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
channel | int | 是 | URL参数 | 通道号 |
dataType | String | 否 | RequestBody参数 | 实时监控数据类型。BOTH:音视频,VIDEO:视频,AUDIO:音频。可选参数,缺省为BOTH |
streamType | String | 否 | RequestBody参数 | 实时监控码流类型。MAIN_STREAM:主码流,SUB_STREAM:子码流。可选参数,缺省为MAIN_STREAM |
videoType | String | 否 | RequestBody参数 | 实时监控音视频格式。RTMP / FLV / HLS。可选参数,缺省为FLV。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
address | String | 播放地址。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DeviceError | 设备有误:非多媒体设备 | 400 | 设备有误:非多媒体设备 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
VehicleOffline | 车辆离线:未连接平台 | 400 | 车辆离线:未连接平台 |
PlaybackPushOccupied | 当前其他观众正在回看直播,通道被占用,请等待 | 400 | 当前已有历史回看正在推流,通道被占用,请等待 |
InvalidVideoType | 非法音视频:不支持的音视频传输格式{videoType} | 400 | 非法音视频:不支持的音视频传输格式{videoType} |
InvalidTask | 任务异常 | 400 | 任务异常 |
NotExistResource | 资源不存在: 没有可以继续的实时流任务 | 404 | 资源不存在:没有可以继续的实时流任务 |
ServerInternalError | 内部服务错误,请稍候重试 | 500 | 内部服务错误,请稍候重试 |
TryToRetry | 请重试 | 500 | 请重试 |
请求示例
POST /v1/video/real-time/QGON_10000/1
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
{
"dataType" : "BOTH",
"streamType" : "MAIN_STREAM",
"videoType" : "FLV"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"address":"http://flv.play.ivc.gz.baidubce.com/36e27cdd809943d197eb7ee05080b869/QGON_10000_channel_1.flv"
}
继续实时视频监控
接口描述
本接口用于延长设备端实时视频监控时间。
- 此接口会与设备端进行交互,因此,调用此接口时应确保设备端处于连接状态;否则,调用会抛出异常(VehicleOffline)。
- 此接口会返回一个拉流的播放地址,用户可通过返回参数观看直播视频;参数videoType用于指定拉流视频的格式,支持RTMP、FLV、HLS。
注意事项
本接口用于指定特定的设备、特定的通道继续直播推流。
- 调用时确保设备属于多媒体设备(PK:QGON)
- 调用时确保设备处于直播推流中。
请求结构
POST /v1/video/real-time/{vehicleId}/{channel}?continue
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"dataType" : dataType,
"streamType" : streamType,
"videoType" : videoType
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
channel | int | 是 | URL参数 | 通道号 |
dataType | String | 否 | RequestBody参数 | 实时监控数据类型。BOTH:音视频,VIDEO:视频,AUDIO:音频。可选参数,缺省为BOTH |
streamType | String | 否 | RequestBody参数 | 实时监控码流类型。MAIN_STREAM:主码流,SUB_STREAM:子码流。可选参数,缺省为MAIN_STREAM |
videoType | String | 否 | RequestBody参数 | 实时监控音视频格式。RTMP / FLV / HLS。可选参数,缺省为FLV。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
address | String | 播放地址。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DeviceError | 设备有误:非多媒体设备 | 400 | 设备有误:非多媒体设备 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
ServerInternalError | 内部服务器错误,请稍后重试 | 500 | 内部服务器错误,请稍后重试 |
VehicleOffline | 车辆离线:未连接平台 | 400 | 车辆离线:未连接平台 |
PlaybackPushOccupied | 当前其他观众正在回看直播,通道被占用,请等待 | 400 | 当前已有历史回看正在推流,通道被占用,请等待 |
InvalidVideoType | 非法音视频:不支持的音视频传输格式{videoType} | 400 | 非法音视频:不支持的音视频传输格式{videoType} |
NotExistResource | 资源不存在:没有可以继续的实时流任务 | 404 | 资源不存在:没有可以继续的实时流任务 |
InvalidTask | 任务异常 | 400 | 任务异常 |
TryToRetry | 请重试 | 500 | 请重试 |
请求示例
POST /v1/video/real-time/QGON_10000/1?continue
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
{
"dataType" : "BOTH",
"streamType" : "MAIN_STREAM",
"videoType" : "FLV"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"address":"http://flv.play.ivc.gz.baidubce.com/36e27cdd809943d197eb7ee05080b869/QGON_10000_channel_1.flv"
}
结束实时视频监控
接口描述
本接口用于结束设备端实时视频监控。
- 此接口会与设备端进行交互,因此,调用此接口时应确保设备端处于连接状态;否则,调用会抛出异常(VehicleOffline)。
请求结构
PUT /v1/video/real-time/{vehicleId}/{channel}?close
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
channel | int | 是 | URL参数 | 通道号 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
无。
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DeviceError | 设备有误:非多媒体设备 | 400 | 设备有误:非多媒体设备 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
ServerInternalError | 内部服务器错误,请稍后重试 | 500 | 内部服务器错误,请稍后重试 |
VehicleOffline | 车辆离线:未连接平台 | 400 | 车辆离线:未连接平台 |
InvalidTask | 任务异常 | 400 | 任务异常 |
请求示例
PUT /v1/video/real-time/QGON_10000/1?close
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
开始多路直播
接口描述
本接口用于指示设备端同时开启多路实时视频监控。
- 此接口会与设备端进行交互,因此,调用此接口时应确保设备端处于连接状态;否则,调用会抛出异常(VehicleOffline)。
- 此接口会返回多个拉流的播放地址,用户可通过返回参数观看直播视频;参数videoType用于指定拉流视频的格式,支持RTMP、FLV、HLS。
- 此接口不支持不同通道的视频返回不同的播放格式。
注意事项
本接口用于指定特定的设备、特定的通道进行直播推流。
- 调用时确保设备属于多媒体设备(PK:QGON)
请求结构
POST /v1/video/real-time/{vehicleId}?open&layout={layout}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"dataType" : dataType,
"streamType" : streamType,
"videoType" : videoType
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
layout | int | 是 | Query参数 | 通道数。目前仅支持1路或者4路。1路推流时,默认推流通道1。 |
dataType | String | 否 | RequestBody参数 | 实时监控数据类型。BOTH:音视频,VIDEO:视频,AUDIO:音频。可选参数,缺省为BOTH |
streamType | String | 否 | RequestBody参数 | 实时监控码流类型。MAIN_STREAM:主码流,SUB_STREAM:子码流。可选参数,缺省为MAIN_STREAM |
videoType | String | 否 | RequestBody参数 | 实时监控音视频格式。RTMP / FLV / HLS。可选参数,缺省为FLV。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
playUrls | List<ChannelPlayUrl> | 播放地址列表。 |
availableChannels | List<Integer> | 空闲通道。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DeviceError | 设备有误:非多媒体设备 | 400 | 设备有误:非多媒体设备 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
ServerInternalError | 内部服务器错误,请稍后重试 | 500 | 内部服务器错误,请稍后重试 |
VehicleOffline | 车辆离线:未连接平台 | 400 | 车辆离线:未连接平台 |
InvalidRequestParam | 请求参数有误:layout非法,目前只支持1或4 | 400 | 请求参数有误:layout非法,目前只支持1或4 |
PlaybackPushOccupied | 当前其他观众正在回看直播,通道被占用,请等待 | 400 | 当前已有历史回看正在推流,通道被占用,请等待 |
InvalidVideoType | 非法音视频:不支持的音视频传输格式{videoType} | 400 | 非法音视频:不支持的音视频传输格式{videoType} |
InvalidTask | 任务异常 | 400 | 任务异常 |
NotExistResource | 资源不存在:没有可以继续的实时流任务 | 400 | 资源不存在:没有可以继续的实时流任务 |
TryToRetry | 请重试 | 500 | 请重试 |
请求示例
POST /v1/video/real-time/QGON_10000?open&layout=1
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
{
"dataType" : "BOTH",
"streamType" : "MAIN_STREAM",
"videoType" : "FLV"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"playUrls": [
{
"channel": 1,
"address":"http://flv.play.ivc.gz.baidubce.com/36e27e05080b869/QGON_10000_channel_1.flv"
}
],
"availableChannels":[1,2,3]
}
继续多路直播
接口描述
本接口用于指示设备端同时延长多路实时视频监控时间。
- 此接口会与设备端进行交互,因此,调用此接口时应确保设备端处于连接状态;否则,调用会抛出异常(VehicleOffline)。
- 此接口会返回多个拉流的播放地址,用户可通过返回参数观看直播视频;参数videoType用于指定拉流视频的格式,支持RTMP、FLV、HLS。
- 此接口不支持不同通道的视频返回不同的播放格式。
注意事项
本接口用于指定特定的设备、特定的通道进行直播推流。
- 调用时确保设备属于多媒体设备(PK:QGON)
- 调用时确保设备处于直播推流中。
请求结构
POST /v1/video/real-time/{vehicleId}?continue&layout={layout}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"dataType" : dataType,
"streamType" : streamType,
"videoType" : videoType
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
layout | int | 是 | Query参数 | 通道数。目前仅支持1路或者4路。1路推流时,默认推流通道1。 |
dataType | String | 否 | RequestBody参数 | 实时监控数据类型。BOTH:音视频,VIDEO:视频,AUDIO:音频。可选参数,缺省为BOTH |
streamType | String | 否 | RequestBody参数 | 实时监控码流类型。MAIN_STREAM:主码流,SUB_STREAM:子码流。可选参数,缺省为MAIN_STREAM |
videoType | String | 否 | RequestBody参数 | 实时监控音视频格式。RTMP / FLV / HLS。可选参数,缺省为FLV。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
playUrls | List<ChannelPlayUrl> | 播放地址列表。 |
availableChannels | List<Integer> | 空闲通道。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DeviceError | 设备有误:非多媒体设备 | 400 | 设备有误:非多媒体设备 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
ServerInternalError | 内部服务器错误,请稍后重试 | 500 | 内部服务器错误,请稍后重试 |
VehicleOffline | 车辆离线:未连接平台 | 400 | 车辆离线:未连接平台 |
InvalidRequestParam | 请求参数有误:layout非法,目前只支持1或4 | 400 | 请求参数有误:layout非法,目前只支持1或4 |
PlaybackPushOccupied | 当前其他观众正在回看直播,通道被占用,请等待 | 400 | 当前已有历史回看正在推流,通道被占用,请等待 |
InvalidVideoType | 非法音视频:不支持的音视频传输格式{videoType} | 400 | 非法音视频:不支持的音视频传输格式{videoType} |
InvalidTask | 任务异常 | 400 | 任务异常 |
NotExistResource | 资源不存在:没有可以继续的实时流任务 | 404 | 资源不存在:没有可以继续的实时流任务 |
TryToRetry | 请重试 | 500 | 请重试 |
请求示例
POST /v1/video/real-time/QGON_10000?continue&layout=1
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
{
"dataType" : "BOTH",
"streamType" : "MAIN_STREAM",
"videoType" : "FLV"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"playUrls": [
{
"channel": 1,
"address":"http://flv.play.ivc.gz.baidubce.com/36e27e05080b869/QGON_10000_channel_1.flv"
}
],
"availableChannels":[1,2,3]
}
结束多路直播
接口描述
本接口用于指示设备端同时结束多路实时视频监控。
- 此接口会与设备端进行交互,因此,调用此接口时应确保设备端处于连接状态;否则,调用会抛出异常(VehicleOffline)。
请求结构
PUT /v1/video/real-time/{vehicleId}?close&layout={layout}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
layout | int | 是 | Query参数 | 通道数。目前仅支持1路或者4路。1路推流时,默认推流通道1。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
无。
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DeviceError | 设备有误:非多媒体设备 | 400 | 设备有误:非多媒体设备 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
ServerInternalError | 内部服务器错误,请稍后重试 | 500 | 内部服务器错误,请稍后重试 |
InvalidRequestParam | 请求参数有误:layout非法,目前只支持1或4 | 400 | 请求参数有误:layout非法,目前只支持1或4 |
InvalidTask | 任务异常 | 400 | 任务异常 |
VehicleOffline | 车辆离线:未连接平台 | 400 | 车辆离线:未连接平台 |
InvalidRequestParam | 请求参数有误:layout非法,目前只支持1或4 | 400 | 请求参数有误:layout非法,目前只支持1或4 |
请求示例
PUT /v1/video/real-time/QGON_10000?close&layout=1
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
开始历史视频远程回放
接口描述
本接口用于指示设备端进行历史视频远程回放
- 此接口会与设备端进行交互,因此,调用此接口时应确保设备端处于连接状态;否则,调用会抛出异常(VehicleOffline)。
权限说明
采用文档开头提及的API认证机制
注意事项
本接口用于指定特定的设备对特定的视频文件进行远程回放。
- 调用时确保设备属于多媒体设备(PK:QGON)
- 调用时确保视频文件存在于设备中
请求结构
POST /v1/video/playback/{vehicleId}?open
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"videoType": videoType,
"fileName": fileName
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
videoType | String | 否 | RequestBody参数 | 实时监控音视频格式。RTMP / FLV / HLS。可选参数,缺省为FLV。 |
fileName | String | 是 | RequestBody参数 | 要回放的目标文件名。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
address | String | 播放地址。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DeviceError | 设备有误:非多媒体设备 | 400 | 设备有误:非多媒体设备 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
ServerInternalError | 内部服务器错误,请稍后重试 | 500 | 内部服务器错误,请稍后重试 |
VehicleOffline | 车辆离线:未连接平台 | 400 | 车辆离线:未连接平台 |
NotExistResource | 资源不存在:不存在的多媒体信息 | 404 | 资源不存在:不存在的多媒体信息 |
PlaybackPushOccupied | 当前其他观众正在回看直播,通道被占用,请等待 | 400 | 当前已有历史回看正在推流,通道被占用,请等待 |
RealtimePushOccupied | 当前其他观众正在实时直播,通道被占用,请等待 | 400 | 当前已有实时监控正在推流,通道被占用,请等待 |
InvalidVideoType | 非法音视频:不支持的音视频传输格式{videoType} | 400 | 非法音视频:不支持的音视频传输格式{videoType} |
InvalidTask | 任务异常 | 400 | 任务异常 |
请求示例
POST /v1/video/playback/QGON_10000?open
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
{
"videoType": "FLV",
"fileName": "test.mp4"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"address": "http://flv.play.ivc.gz.baidubce.com/36e27e05080b869/QGON_WEIPAI03_playback.flv"
}
结束历史视频远程回放
接口描述
本接口用于指示设备端结束历史视频远程回放
- 此接口会与设备端进行交互,因此,调用此接口时应确保设备端处于连接状态;否则,调用会抛出异常(VehicleOffline)。
权限说明
采用文档开头提及的API认证机制
请求结构
PUT /v1/video/playback/{vehicleId}?close&fileName={fileName}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
fileName | String | 是 | Query参数 | 要结束回放的目标文件名。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
无。
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DeviceError | 设备有误:非多媒体设备 | 400 | 设备有误:非多媒体设备 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
ServerInternalError | 内部服务器错误,请稍后重试 | 500 | 内部服务器错误,请稍后重试 |
VehicleOffline | 车辆离线:未连接平台 | 400 | 车辆离线:未连接平台 |
请求示例
PUT /v1/video/playback/QGON_10000?close&fileName=test.mp4
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
任务管理接口
根据文件名上传文件
接口描述
本接口用于指示设备端上传音视频文件。
- 此接口会与设备端进行交互,因此,调用此接口时应确保设备端处于连接状态;否则,调用会抛出异常(VehicleOffline)。
注意事项
本接口用于指示设备端上传文件到云端。
- 调用时确保设备属于多媒体设备(PK:QGON)
- 调用时确保要上传的文件存在于设备端。
请求结构
POST /v1/video/upload/{vehicleId}?name
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"fileName": fileName
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
fileName | String | 是 | RequestBody参数 | 要上传的文件名。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
taskId | String | 上传任务ID |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DeviceError | 设备有误:非多媒体设备 | 400 | 设备有误:非多媒体设备 |
VehicleOffline | 车辆离线:未连接平台 | 400 | 车辆离线:未连接平台 |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
ServerInternalError | 内部服务器错误,请稍后重试 | 500 | 内部服务器错误,请稍后重试 |
NotExistResource | 资源不存在:不存在的视频信息, fileName={fileName} | 404 | 资源不存在:不存在的视频信息, fileName={fileName} |
DuplicateResource | 重复创建资源: 存在执行中的重复任务, fileName={fileName} | 400 | 重复创建资源: 存在执行中的重复任务, fileName={fileName} |
NotExistResource | 资源不存在:不存在的视频信息, fileName={fileName} | 404 | 资源不存在:不存在的视频信息, fileName={fileName} |
请求示例
POST /v1/video/upload/QGON_10000?name
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
{
"fileName": "test.mp4"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"taskId": "a0ca5ac39504426e978ea33f4df96d60"
}
任务取消
接口描述
根据任务ID,取消未完成的升级任务。
请求结构
PUT /v1/video/upload/tasks/{taskUuid}?cancel
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
taskUuid | String | 是 | URL参数 | 文件上传任务的Uuid。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
无。
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
NotExistResource | 资源不存在:不存在的上传任务, taskUuid={taskUuid} | 404 | 资源不存在:不存在的上传任务, taskUuid={taskUuid} |
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车辆网服务 |
ServerInternalError | 内部服务器错误,请稍后重试 | 500 | 内部服务器错误,请稍后重试 |
请求示例
PUT /v1/video/upload/tasks/a0ca5ac39504426e978ea33f4df96d60?cancel
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
获取上传任务状态
接口描述
根据任务ID,获取上传任务的状态
请求结构
GET /v1/video/playback/tasks/{taskUuid}?status
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
taskUuid | String | 是 | URL参数 | 文件上传任务的Uuid。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
status | String | 上传任务的状态。UPLOADING:上传中, PROCESSING:处理中,UPLOAD_FAILED:上传失败, PROCESS_FAILED:处理失败, PUBLISHED:已发布 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
NotExistResource | 资源不存在:不存在的上传任务, taskUuid={taskUuid} | 404 | 资源不存在:不存在的上传任务, taskUuid={taskUuid} |
请求示例
GET /v1/video/playback/tasks/a0ca5ac39504426e978ea33f4df96d60?status
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"status": "PUBLISHED"
}
获取地址接口
根据任务获取播放地址
接口描述
根据任务ID,获取相应视频的播放地址
请求结构
GET /v1/video/playback/tasks/{taskUuid}?url
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
taskUuid | String | 是 | URL参数 | 文件上传任务的Uuid。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
address | String | 音视频播放地址。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
NotExistResource | 资源不存在:不存在的上传任务 or 不存在的多媒体信息 | 404 | 资源不存在:不存在的上传任务 or 不存在的多媒体信息 |
TaskNotPublished | 上传任务未发布 | 400 | 上传任务未发布 |
DefaultPlayableUrlSizeExceedOne | Default playable url size exceeds 1, count=%d | 400 | 默认播放器地址数超过1 |
MediaInWrongState | Media is in wrong state:%s, operation not permitted | 400 | 多媒体资源当前状态错误,操作不允许 |
MediaNotInCloud | 资源文件未上传到云端 | 400 | 资源文件未上传到云端 |
请求示例
GET /v1/video/playback/tasks/a0ca5ac39504426e978ea33f4df96d60?url
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"address": "http://jg7v9fgf4e1y571dnxf.exp.bcevod.com/mda-jhij7jnk8rbhicki/mda-jhij7jnk8rbhicki.mp4"
}
根据文件名获取播放地址
接口描述
根据上传的音视频文件名获取播放地址。
请求结构
POST /v1/video/playback/{vehicleId}?name
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"fileName": fileName
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID。 |
fileName | String | 是 | RequestBody参数 | 要获取播放地址的文件名。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
address | String | 音视频播放地址。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
NotExistResource | 资源不存在:不存在的视频信息 or 不存在的多媒体资源 | 404 | 资源不存在:不存在的视频信息 or 不存在的多媒体资源 |
MediaNotInCloud | 资源文件未上传到云端 | 400 | 资源文件未上传到云端 |
DefaultPlayableUrlSizeExceedOne | Default playable url size exceeds 1, count=%d | 400 | 默认播放器地址数超过1 |
MediaInWrongState | Media is in wrong state:%s, operation not permitted | 400 | 多媒体资源当前状态错误,操作不允许 |
请求示例
POST /v1/video/playback/QGON_10000?name
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/9b46660219574104b8773a200b4871a0/2019-09-24T06:43:17Z/3600/host;x-bce-console-rpc-id;x-bce-date/2e11709c6d364d7b90ca07278fe085b1c7cef985c8452ed646c8c930dcab7567
Content-Type: application/json
x-bce-console-rpc-id: 223b9f01-1165-4fd8-ac5c-50ea28b405be
x-bce-date: 2019-09-24T06:43:17Z
{
"fileName": "test.mp4"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"address": "http://jg7v9fgf4e1y571dnxf.exp.bcevod.com/mda-jhij7jnk8rbhicki/mda-jhij7jnk8rbhicki.mp4"
}
根据mediaUuid列表批量获取播放地址
接口描述
根据mediaUuid列表批量获取文件的播放地址
请求结构
POST /v1/video/playback/media/batch
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"pageSize": pageSize,
"pageNo": pageNo,
"mediaUuidList":mediaUuidList
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
pageSize | int | 是 | RequestBody参数 | 单页显示数。最大值为50,最小值为1。默认为10。 |
pageNo | int | 是 | RequestBody参数 | 页码数。最小值为1。默认为1。 |
mediaUuidList | List<String> | 是 | RequestBody参数 | 需要查询的mediaUuid列表。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
count | int | 获取到的播放地址总数。 |
pageSize | int | 单页显示数。 |
pageNo | int | 页码数。 |
results | List<AddressResult> | 当页获取的播放地址信息列表。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
DefaultPlayableUrlSizeExceedOne | Default playable url size exceeds 1, count=%d | 400 | 默认播放器地址数超过1 |
MediaInWrongState | Media is in wrong state:%s, operation not permitted | 400 | 多媒体资源当前状态错误,操作不允许 |
请求示例
POST /v1/video/playback/media/batch
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"pageSize": 10,
"pageNo": 1,
"mediaUuidList": [
"dbd628502a9246fdbca4a",
"41c437f7c2494d3baa089"
]
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"count": 3,
"pageSize": 10,
"pageNo": 1,
"results": [
{
"mediaUuid": "dbd628502a9246fdbca4a5737683afd7",
"fileName": "test.mp4",
"address": "http://jg7v9fgf4e1y571dnxf.exp.bcevod.com/mda-jhij7jnk8rbhicki/mda-jhij7jnk8rbhicki.mp4"
},
{
"mediaUuid": "41c437f7c2494d3baa089f4610cf2fd3",
"fileName": "test1.mp4",
"address": "http://g7v9fgfj127h571dnxf.exp.bcevod.com/mda-jhikdos82rbhicki/mda-jhikdos82rbhicki.mp4"
}
]
}
获取音视频文件下载地址
接口描述
用于根据文件名获取音视频文件下载地址。
请求结构
POST /v1/video/download/{vehicleId}?video
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"fileName": fileName
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | Url参数 | 车辆ID |
fileName | String | 是 | RequestBody参数 | 要获取的音视频文件名。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
address | String | 音视频播放地址。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
NotExistResource | 资源不存在:不存在的视频信息 or 不存在的多媒体资源 | 404 | 资源不存在:不存在的视频信息 or 不存在的多媒体资源 |
MediaNotInCloud | 资源文件未上传到云端 | 400 | 资源文件未上传到云端 |
DefaultPlayableUrlSizeExceedOne | Default playable url size exceeds 1, count=%d | 400 | 默认播放器地址数超过1 |
MediaInWrongState | Media is in wrong state:%s, operation not permitted | 400 | 多媒体资源当前状态错误,操作不允许 |
请求示例
POST /v1/video/download/QGON_10000?video
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"fileName": "test.mp4"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"address": "http://jg7v9fgf4e1y571dnxf.exp.bcevod.com/mda-jhembidg6ym7hkpw/mda-jhembidg6ym7hkpw.mp4"
}
获取图片文件下载地址
接口描述
用于根据文件名获取图片文件下载地址。
请求结构
POST /v1/video/download/{vehicleId}?image
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"fileName": fileName
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | URL参数 | 车辆ID |
fileName | String | 是 | RequestBody参数 | 要获取的音视频文件名。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
address | String | 音视频播放地址。 |
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
NotExistResource | 资源不存在:不存在的图片信息 or 不存在的多媒体资源 | 404 | 资源不存在:不存在的图片信息 or 不存在的多媒体资源 |
MediaNotInCloud | 资源文件未上传到云端 | 400 | 资源文件未上传到云端 |
请求示例
POST /v1/video/download/QGON_10000?video
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"fileName": "test.mp4"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
{
"address": "https://bj.bcebos.com/v1/dugo-default/12ji43oaa04/QGON_10000/pic-ttFMpvPM7CaFM3no.jpg"
}
权限下发接口
权限设置
接口描述
用于向设备端下发权限信息。
请求结构
PUT /v1/video/param-setting/{vehicleId}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"paramHex": paramHex
}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
vehicleId | String | 是 | Url参数 | 车辆ID |
paramHex | String | 是 | RequestBody参数 | 十六进制的权限设置字符串。满足正则表达式:^[A-Fa-f0-9]{1,210}$ |
响应头域
除公共头域外,无其它特殊头域。
响应参数
无。
错误码
错误码 | 错误描述 | HTTP状态码 | 中文解释 |
---|---|---|---|
IvcNotEnable | 未购买车联网服务 | 400 | 未购买车联网服务 |
setParamFailure | 参数设置失败 | 400 | 参数设置失败 |
ServerInternalError | 内部服务器错误,请稍后重试 or 参数设置失败 | 500 | 内部服务器错误,请稍后重试 or 参数设置失败 |
请求示例
PUT /v1/video/param-setting/QGON_10000
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
x-bce-date: 2019-09-24T04:02:05Z
{
"paramHex": "11001011"
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 24 Sep 2019 08:44:33 GMT
X-Bce-Request-Id: 97e6d443-2737-4dfb-bdac-c640a8920682
Server: BWS
检索相关接口
数据类型
直播点播接口对象定义
ChannelPlayUrl
参数名称 | 类型 | 描述 |
---|---|---|
channel | String | 通道号 |
address | String | 播放地址 |
AddressResult
参数名称 | 类型 | 描述 |
---|---|---|
mediaUuid | String | 多媒体uuid |
fileName | String | 对应的文件名 |
address | String | 播放地址 |