# 【旧】批量获取通道实况P2P地址（仅支持好望协议） #### 功能介绍 批量获取通道实况P2P地址（仅支持好望协议） **备注：输入P2P播放地址播放需要全选[响应示例]中所有的返回结果输入到播放地址栏！** #### URI POST /v1/{user_id}/devices/channels/p2p-connect/live 表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 [P2PChannelsLiveParam] objects | 请求信息 | | expire_time | 否 | Integer | 自定义Url过期时间：时间范围\[30, 86400\]，不填写时默认值为 30（单位/秒） **备注：仅对live_urls中的live_url有效** | | use_times | 否 | Integer | 自定义Url使用次数：枚举类型，当expire_time和use_times都不填写时，use_times默认为1，仅use_times不填写时，use_times默认为0 **备注：仅对live_urls中的live_url有效** 枚举值： - **0** 使用一次 - **1**有效时间内任意使用 | 表4P2PChannelsLiveParam | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | #### 响应参数 **状态码： 200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | fail_num | Integer | 获取设备url失败的数量 | | p2p_connections | Array of [P2PDevicesResp] objects | P2P信息列表 | | live_urls | Array of [getLiveURLChannelsResp] objects | 云转发地址列表 | | request_id | String | 该请求的id | 表6P2PDevicesResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 错误信息 | 表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 | 表8getLiveURLChannelsResp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | device_id | String | 设备ID：设备唯一标识，长度范围\[1,32\] | | channel_id | String | 通道ID：长度范围\[1,20\] | | live_url | String | 媒体实况播放地址 | | result | [Result] object | 错误信息 | 表9Result | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | 错误编码，请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html) | | msg | String | 错误信息 | #### 请求示例 发起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" } ] } ``` #### 响应示例 **状态码： 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" } } ] } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-ivm/ivm_03_0136.html) #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html)