文档首页/ 行业视频管理服务 IVM/ API参考/ 媒体播放管理(媒体管理的接口需搭配SDK使用)/ 【旧】批量获取通道实况P2P地址(仅支持好望协议)
更新时间:2024-05-21 GMT+08:00
分享

【旧】批量获取通道实况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使用次数:枚举类型,不填写时默认值为 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

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

状态码

请参见状态码

错误码

请参见错误码

相关文档