媒体播放管理（媒体管理的接口需搭配SDK使用）-华为云

行业视频管理服务 IVM-获取回放地址统一接口:响应示例

响应示例状态码： 200 OK { "playback_connections": { "device_id": "219123456CYP***", "channel_id": "0", "cloud_trans_connections": { "playback_url": "jvmp://123.123.123.123:7070/vod/219123456CYP***?token=content***" }, "p2p_connections": { "token": "content***", "device_state": "ONLINE", "p2p_nodes": [ { "node_type": "COMMON", "address_type": "IPV4", "address": [ "123.123.123.123" ], "tcp_port": 0, "udp_port": 7050 } ], "result": { "code": "IVM.0", "msg": "Success" }, "start_time": "2023-03-20 10:05:00", "end_time": "2023-03-20 12:50:00" } } } { "playback_connections": { "device_id": "219123456CYP***", "channel_id": "0", "cloud_trans_connections": { "playback_url": "http://123.123.123.123:7083/dev_vod/vod.m3u8?token=content***&device_id=219123456CYP***&channel_id=0&stream_type=0" }, "p2p_connections": {} } } { "playback_connections": { "device_id": "219123456CYP***", "channel_id": "0", "cloud_trans_connections": { "playback_url": "https://123.123.123.123:7081/vod/vod.m3u8?token=content***&device_id=219123456CYP***&channel_id=0" }, "p2p_connections": {} } }

行业视频管理服务 IVM 媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务 IVM-获取回放地址统一接口:请求示例

请求示例查询前端的录像回放地址 GET /v2/123456789*****/devices/219123456CYP***/channels/0/media/playback-connections?start_time=2023-03-20 10:05:00&end_time=2023-03-20 12:50:00&playback_protocol=HOLO&record_position=DEVICE GET /v2/123456789*****/devices/219123456CYP***/channels/0/media/playback-connections?start_time=2023-03-20 10:05:00&end_time=2023-03-20 12:50:00&playback_protocol=HTTP_HLS&record_position=DEVICE GET /v2/123456789*****/devices/219123456CYP***/channels/0/media/playback-connections?record_position=CLOUD&start_time=2023-03-20 10:05:00&end_time=2023-03-20 12:50:00&playback_protocol=HTTPS_HLS

行业视频管理服务 IVM 媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务 IVM-获取回放地址统一接口:URI

URI GET /v2/{user_id}/devices/{device_id}/channels/{channel_id}/media/playback-connections 表1 路径参数参数是否必选参数类型描述 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 device_id 是 String 设备ID：好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR)，用来区分设备类型 channel_id 是 String 通道ID：好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取表2 Query参数参数是否必选参数类型描述 playback_protocol 是 String 媒体播放协议：枚举类型，选择获取地址的媒体播放协议类型枚举值： HOLO 好望协议的录像 HTTP_HLS 基于HTTP的HLS流媒体传输协议的录像 HTTPS_HLS 基于HTTPS的HLS流媒体传输协议的录像 RTSP RTSP流媒体传输协议的录像 start_time 是 String 开始时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 end_time 是 String 结束时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 record_position 是 String 录像位置，枚举类型枚举值： CLOUD 云端录像 DEVICE 前端录像 record_type 否 String 录像类型：枚举类型，仅针对查询云端录像，不填则默认默认值为 ALL_RECORD 枚举值： ALL_RECORD 所有录像 NORMAL_RECORD 全量录像 MOTION_RECORD 动检录像 expire_time 否 String 自定义Url过期时间：时间范围[30, 86400]，不填写时默认值为 30（单位/秒）说明：仅对CloudTransChannelsResp中的playback_url有效 use_times 否 String 自定义Url使用次数：枚举类型，不填写时默认值为 0，RTSP协议固定为 0 枚举值： 0 使用一次 1 有效时间内任意使用，此参数对RTSP协议无效说明：仅对CloudTransChannelsResp中的playback_url有效 stream_type 否 String 码流类型：枚举类型，不填写时默认值为 PRIMARY_STREAM 枚举值： PRIMARY_STREAM 主码流 SECONDARY_STREAM_1 子码流1 SECONDARY_STREAM_2 子码流2

行业视频管理服务 IVM 媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务 IVM-获取回放地址统一接口:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 playback_connections PlaybackConnectionsResp object 回放信息表5 PlaybackConnectionsResp 参数参数类型描述 device_id String 设备ID：设备唯一标识，长度范围[1,32] channel_id String 通道ID：长度范围[1,20] cloud_trans_connections CloudTransChannelsResp object 转发实况连接结构体 p2p_connections P2PChannelsResp object P2P实况连接结构体：仅支持HOLO媒体播放协议，前端回放类型且请求设备为好望设备表6 CloudTransChannelsResp 参数参数类型描述 playback_url String 转发回放地址：将此url输入播放地址栏开始播放表7 P2PChannelsResp 参数参数类型描述 token String P2P请求Token device_state String 在线状态：枚举类型枚举值： OFFLINE 离线 ONLINE 在线 p2p_nodes Array of P2PMTSListResp objects P2P连接可用节点 result Result object 错误信息表8 P2PMTSListResp 参数参数类型描述 node_type String 节点类型：枚举类型枚举值： COMMON 普通：普通的三线（移动，联通，电线）服务器，与地域有关，服务器由运营商托管，网络通信质量低 BETTER 优质：全网通服务器（华为云服务器等），网络通信质量高 address_type String 地址类型：枚举类型 DOMAIN 域地址 IPV4 IPv4地址 IPV6 IPv6地址 address Array of strings 媒体转发服务地址：协议头在SDK封装，根据address_type决定地址类型 DOMAIN: www.huawei.com IPV4: 123.123.123.123 IPV6: fe80::f816:3eff:feed:5821 tcp_port Integer TCP端口：默认值为 0 备注：未使用0端口，tcp_port只作为兼容字段保留 udp_port Integer UDP端口：默认值为 7050 表9 Result 参数参数类型描述 code String 错误编码：请参见错误码 msg String 错误信息

行业视频管理服务 IVM 媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务 IVM-获取实况地址统一接口:请求示例

请求示例获取实况地址请求： POST /v2/123456789*****/devices/channels/media/live-connections { "expire_time":30, "use_times":0, "channels": [ { "channel_id": "0", "device_id": "219123456CYP***", "live_protocol":"HOLO", "stream_type": "SECONDARY_STREAM_1" }, { "channel_id": "1", "device_id": "219123456CYP***", "live_protocol":"HOLO", "stream_type": "PRIMARY_STREAM" } ] }

行业视频管理服务 IVM 媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务 IVM-获取实况地址统一接口:响应示例

响应示例状态码： 200 OK { "fail_num": 1, "live_connections": [ { "device_id": "219123456CYP***", "channel_id": "0", "cloud_trans_connections": {}, "p2p_connections": {}, "result": { "code": "IVM.10026004", "msg": "The param stream_type is not support." } }, { "device_id": "210123456SMY***", "channel_id": "0", "cloud_trans_connections": { "live_url": "jvmp://123.123.123.123:7070/live/210123456SMY***?token=content***" }, "p2p_connections": { "token": "content***", "device_state": "ONLINE", "p2p_nodes": [ { "node_type": "COMMON", "address_type": "IPV4", "address": [ "123.123.123.123" ], "tcp_port": 0, "udp_port": 7050 } ] }, "result": { "code": "IVM.0", "msg": "Success" } } ] }

行业视频管理服务 IVM 媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务 IVM-获取实况地址统一接口:响应参数

响应参数状态码： 200 表5 响应Body参数：播放P2P实况需要将响应Body参数中的所有内容输入到播放地址栏参数参数类型描述 fail_num Integer 获取设备url失败的数量 live_connections Array of LiveConnectionResp objects 实况响应信息表6 LiveConnectionResp 参数参数类型描述 device_id String 设备ID：设备唯一标识，长度范围[1,32] channel_id String 通道ID：长度范围[1,20] cloud_trans_connections CloudTransChannelsResp object 转发实况连接结构体 p2p_connections P2PChannelsResp object P2P实况连接结构体：仅支持HOLO媒体播放协议且请求设备为好望设备 result Result object 错误信息表7 CloudTransChannelsResp 参数参数类型描述 live_url String 转发实况播放地址：将此url输入播放地址栏开始播放表8 P2PChannelsResp 参数参数类型描述 token String P2P请求Token device_state String 在线状态：枚举类型枚举值： OFFLINE 离线 ONLINE 在线 p2p_nodes Array of P2PMTSListResp objects P2P连接可用节点表9 P2PMTSListResp 参数参数类型描述 node_type String 节点类型：枚举类型枚举值： COMMON 普通：普通的三线（移动，联通，电线）服务器，与地域有关，服务器由运营商托管，网络通信质量低 BETTER 优质：全网通服务器（华为云服务器等），网络通信质量高 address_type String 地址类型：枚举类型 DOMAIN 域地址 IPV4 IPv4地址 IPV6 IPv6地址 address Array of strings 媒体转发服务地址：协议头在SDK封装，根据address_type决定地址类型 DOMAIN: www.huawei.com IPV4: 123.123.123.123 IPV6: fe80::f816:3eff:feed:5821 tcp_port Integer TCP端口：默认值为 0 备注：未使用0端口，tcp_port只作为兼容字段保留 udp_port Integer UDP端口：默认值为 7050 表10 Result 参数参数类型描述 code String 错误编码：请参见错误码 msg String 错误信息

行业视频管理服务 IVM 媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务 IVM-获取实况地址统一接口:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取表3 请求Body参数参数是否必选参数类型描述 channels 是 Array of ChannelsLiveParamV2 objects 请求信息V2 expire_time 否 Integer 自定义Url过期时间：时间范围[30, 86400]，不传默认为 30（单位/秒）备注：仅对CloudTransChannelsResp中的live_url有效 use_times 否 Integer 自定义Url使用次数：枚举类型，不填写时默认值为 0，RTSP协议固定为 0 备注：仅对CloudTransChannelsResp中的live_url有效枚举值： 0 使用一次 1 有效时间内任意使用，此参数对RTSP协议无效表4 ChannelsLiveParamV2 参数是否必选参数类型描述 device_id 是 String 设备ID：好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR)，用来区分设备类型 channel_id 是 String 通道ID：好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 live_protocol 是 String 媒体播放协议：枚举类型，选择获取地址的媒体播放协议类型枚举值： HOLO 好望协议 HTTP_HLS 基于HTTP的HLS流媒体传输协议 HTTPS_HLS 基于HTTPS的HLS流媒体传输协议 HTTP_FLV 基于HTTP的FLV媒体协议 HTTPS_FLV 基于HTTPS的FLV媒体协议 RTSP RTSP流媒体传输协议 stream_type 是 String 码流类型：枚举类型枚举值： PRIMARY_STREAM 主码流 SECONDARY_STREAM_1 子码流1 SECONDARY_STREAM_2 子码流2

行业视频管理服务 IVM 媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务-【旧】批量获取通道实况P2P地址（仅支持好望协议）:响应示例

响应示例状态码： 200 OK { "p2p_connections" : [ { "device_id" : "D123", "token" : "XSab786654", "p2p_nodes" : [ { "address_type" : "IPV4", "address" : [ "123.123.*.*", "lingwai123.123.*.*" ], "tcp_port" : 0, "udp_port" : 7050, "node_type" : "BETTER" } ], "device_state" : "ONLINE", "result" : { "code" : "IVM.0", "msg" : "Success" } }, { "device_id" : "D124", "token" : "XSab786654", "p2p_nodes" : [ { "address_type" : "IPV4", "address" : [ "123.123.*.*", "123.123.*.*" ], "tcp_port" : 0, "udp_port" : 7050, "node_type" : "BETTER" } ], "device_state" : "ONLINE", "result" : { "code" : "IVM.0", "msg" : "Success" } } ], "live_urls" : [ { "device_id" : "D123", "channel_id" : "0", "live_url" : "jvmp://123.123.*.*:***/live/2102412469", "result" : { "code" : "IVM.0", "msg" : "Success" } }, { "device_id" : "D124", "channel_id" : "1", "live_url" : "jvmp://123.123.*.*:***/live/2102412469", "result" : { "code" : "IVM.0", "msg" : "Success" } } ] }

行业视频管理服务媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务-【旧】批量获取通道实况P2P地址（仅支持好望协议）:请求示例

请求示例发起P2P实况连接信息 POST /v1/2562572829***/devices/channels/p2p-connect/live { "channels": [ { "device_id": "952352LWXT***", "channel_id": "123", "stream_type": "PRIMARY_STREAM" }, { "device_id": "952352LWXT***", "channel_id": "123", "stream_type": "SECONDARY_STREAM_1" } ] }

行业视频管理服务媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务-【旧】批量获取通道实况P2P地址（仅支持好望协议）:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取表3 请求Body参数参数是否必选参数类型描述 channels 是 Array of P2PChannelsLiveParam objects 请求信息 expire_time 否 Integer 自定义Url过期时间：时间范围[30, 86400]，不填写时默认值为 30（单位/秒）备注：仅对live_urls中的live_url有效 use_times 否 Integer 自定义Url使用次数：枚举类型，不填写时默认值为 0 备注：仅对live_urls中的live_url有效枚举值： 0 使用一次 1 有效时间内任意使用表4 P2PChannelsLiveParam 参数是否必选参数类型描述 device_id 是 String 设备ID：好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取备注：国标协议不支持P2P连接 channel_id 是 String 通道ID：好望设备：取值范围[0,999] stream_type 是 String 码流类型：枚举类型枚举值： PRIMARY_STREAM 主码流 SECONDARY_STREAM_1 子码流1 SECONDARY_STREAM_2 子码流2

行业视频管理服务媒体播放管理（媒体管理的接口需搭配SDK使用）

行业视频管理服务-【旧】批量获取通道实况P2P地址（仅支持好望协议）:响应参数

响应参数状态码： 200 表5 响应Body参数参数参数类型描述 fail_num Integer 获取设备url失败的数量 p2p_connections Array of P2PDevicesResp objects P2P信息列表 live_urls Array of getLiveURLChannelsResp objects 云转发地址列表 request_id String 该请求的id 表6 P2PDevicesResp 参数参数类型描述 device_id String 设备ID：设备唯一标识，长度范围[1,32] p2p_nodes Array of P2PMTSListResp objects p2p连接可用节点 device_state String 在线状态：枚举类型枚举值： OFFLINE 离线 ONLINE 在线 token String P2P请求Token result Result object 错误信息表7 P2PMTSListResp 参数参数类型描述 address Array of strings 媒体转发服务地址：协议头在SDK封装，根据address_type决定地址类型 DOMAIN: www.huawei.com IPV4: 123.123.123.123 IPV6: fe80::f816:3eff:feed:5821 address_type String 地址类型：枚举类型 DOMAIN 域地址 IPV4 IPv4地址 IPV6 IPv6地址 node_type String 节点类型：枚举类型枚举值： COMMON 普通：普通的三线（移动，联通，电线）服务器，与地域有关，服务器由运营商托管，网络通信质量低 BETTER 优质：全网通服务器（华为云服务器等），网络通信质量高 tcp_port Integer TCP端口：默认值为 0 备注：未使用0端口，tcp_port只作为兼容字段保留 udp_port Integer UDP端口：默认值为 7050 表8 getLiveURLChannelsResp 参数参数类型描述 device_id String 设备ID：设备唯一标识，长度范围[1,32] channel_id String 通道ID：长度范围[1,20] live_url String 媒体实况播放地址 result Result object 错误信息表9 Result 参数参数类型描述 code String 错误编码，请参见错误码 msg String 错误信息

行业视频管理服务媒体播放管理（媒体管理的接口需搭配SDK使用）

云服务器内容精选

媒体播放管理（媒体管理的接口需搭配SDK使用）

7*24

备案

专业服务

退订

建议反馈

售前咨询热线