# 【旧】批量获取通道录像回放P2P地址（仅支持好望协议） #### 功能介绍 批量获取通道录像回放P2P地址（仅支持好望协议） **备注：输入P2P播放地址播放需要全选[响应示例]中所有的返回结果输入到播放地址栏！** #### URI POST /v1/{user_id}/devices/channels/p2p-connect/playback 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | user_id | 是 | String | 用户ID：由数字组成，长度范围\[15,25\]，获取方式参考[获取user ID与下载AK/SK](https://support.huaweicloud.com/api-ivm/ivm_03_0005.html#ZH-CN_TOPIC_0000001710465704__section1213543912215)章节 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Access-Token | 是 | String | 用户认证AccessToken：从[获取用户北向接口认证AccessToken](https://support.huaweicloud.com/api-ivm/ivm_03_0002.html)中获取 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | channels | 是 | Array of [P2PChannelsParam] objects | 通道列表：长度范围\[1,1000\] | 表4P2PChannelsParam | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | | start_time | 否 | String | 开始时间：格式如：YYYY-MM-DD HH:MM:SS，北京时间 例如：2022-05-31 00:00:00 备注：开始时间与结束时间要一起使用 | | end_time | 否 | String | 结束时间：格式如：YYYY-MM-DD HH:MM:SS，北京时间 例如：2022-05-31 02:00:00 备注：开始时间与结束时间要一起使用 | #### 响应参数 **状态码： 200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | failNum | Integer | 获取设备url失败的数量 | | p2p_connections | Array of [P2PDevicesResp] objects | 响应信息 | 表6P2PDevicesResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | device_id | String | 设备ID： 好望协议：大小写字母、数字，长度为8\~32个字符 | | p2p_nodes | Array of [P2PMTSListResp] objects | p2p连接可用节点 | | device_state | String | 在线状态：枚举类型 枚举值： - **OFFLINE** 离线 - **ONLINE** 在线 | | token | String | P2P请求Token | | result | [Result] object | 错误信息 | | start_time | String | 开始时间：格式：YYYY-MM-DD HH:MM:SS，北京时间 例如：2022-05-31 00:00:00 备注：请求时填了开始结束时间时，响应体才会有该字段 | | end_time | String | 结束时间：格式：YYYY-MM-DD HH:MM:SS，北京时间 例如：2022-05-31 02:00:00 备注：请求时填了开始结束时间时，响应体才会有该字段 | 表7P2PMTSListResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 表8Result | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | 错误编码：请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html) | | msg | String | 错误信息 | #### 请求示例 批量获取通道录像回放P2P地址（仅支持好望协议） ``` POST /v1/2562572829***/devices/channels/p2p-connect/playback { "channels": [ { "device_id": "952352LWXT***", "channel_id": "0", "stream_type": "PRIMARY_STREAM" }, { "device_id": "952352LWXT***", "channel_id": "0", "stream_type": "SECONDARY_STREAM_1", "start_time":"2022-05-31 00:00:00", "end_time":"2022-05-31 02:00:00" } ] } ``` #### 响应示例 **状态码： 200** OK ``` { "p2p_connections" : [ { "device_id" : "952352LWXT***", "token" : "XSab786654", "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" } }, { "device_id" : "952352LWXT***", "token" : "XSab786654", "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": "2022-05-31 00:00:00", "end_time": "2022-05-31 02:00:00" } ] } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-ivm/ivm_03_0136.html) #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html)