【旧】批量获取通道实况P2P地址（仅支持好望协议）

功能介绍

批量获取通道实况P2P地址（仅支持好望协议）

备注：输入P2P播放地址播放需要全选响应示例中所有的返回结果输入到播放地址栏！

URI

POST /v1/{user_id}/devices/channels/p2p-connect/live

表1 路径参数
参数	是否必选	参数类型	描述
user_id	是	String	用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节

请求参数

表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使用次数：枚举类型，当expire_time和use_times都不填写时，use_times默认为1，仅use_times不填写时，use_times默认为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

响应参数

状态码： 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	错误信息

请求示例

发起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

{
  "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"
    }
  } ]
}