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

【旧】批量获取通道录像回放P2P地址(仅支持好望协议)

功能介绍

批量获取通道录像回放P2P地址(仅支持好望协议)

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

user_id

String

用户ID:由数字组成,长度范围[15,25],获取方式参考获取user ID与下载AK/SK章节

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Access-Token

String

用户认证AccessToken:从获取用户北向接口认证AccessToken中获取

表3 请求Body参数

参数

是否必选

参数类型

描述

channels

Array of P2PChannelsParam objects

通道列表:长度范围[1,1000]

表4 P2PChannelsParam

参数

是否必选

参数类型

描述

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

响应信息

表6 P2PDevicesResp

参数

参数类型

描述

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

备注:请求时填了开始结束时间时,响应体才会有该字段

表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 Result

参数

参数类型

描述

code

String

错误编码:请参见错误码

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

状态码

请参见状态码

错误码

请参见错误码

相关文档