# 获取安卓端播放地址（好望云平台）（API名称：getP2pLiveUrl）
#### 功能介绍
该接口用于与客户系统对接获取安卓端播放地址。
#### 相关API
| 接口名称                                                                 | 调用说明                                                                                                   |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。                                           |
| [获取设备列表](https://support.huaweicloud.com/api-isdp/api_01_0135.html)  | 调用该接口获取设备编号和通道编号。 获取安卓端播放地址时，需要输入设备编号和通道编号。 |
   
#### 调用流程
图1获取安卓端播放地址流程   
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522734591.png "点击放大")
#### URL
| **请求方式** | **HTTPS地址**                                              | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/ivmRemote/getP2pLiveUrl | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**     | **类型** | **是否必填** | **描述**                                                                                                                                                                         |
|:---|:---|:---|:---|
| deviceId   | String | 是        | 设备编号 获取设备编号API请参见：[摄像头列表查询（好望云平台）（API名称：getDeviceList）](https://support.huaweicloud.com/api-isdp/api_01_0135.html)   |
| channelId  | String | 是        | 通道编号 获取设通道编号API请参见：[摄像头列表查询（好望云平台）（API名称：getDeviceList）](https://support.huaweicloud.com/api-isdp/api_01_0135.html) |
| streamType | String | 是        | 流类型                                                                                                                                                                            |
   
#### 响应参数
| **参数**       | **类型** | **描述** |
|:---|:---|:---|
| failNum      | int    | 失败数量   |
| device_id    | String | 设备编号   |
| token        | String | 鉴权码    |
| device_state | String | 设备状态   |
| channel_id   | String | 通道编号   |
| live_url     | String | 播放地址   |
   
#### 请求示例
```
{
    "deviceId": "2198061243WLL4002533",
    "channelId":"4",
    "streamType":"SECONDARY_STREAM_1"
}
```
#### 响应示例
```
{
    "failNum": 0,
    "p2p_connections":[
        {
            "device_id": "2198061243WLL4002533",
            "token": *************************************",
            "device_state": "ONLINE",
            "p2p_nodes":[
                {
                    "node_type": "COMMON",
                    "address_type": "IPV4",
                    "address":["10.10.10.1"],
                    "tcp_port": 7020,
                    "udp_port": 7050
                },
                {
                    "node_type": "COMMON",
                    "address_type": "IPV4",
                    "address":["10.10.10.2"],
                    "tcp_port": 7020,
                    "udp_port": 7050
                }
            ],
            "result":{
                "code": "IVM.0",
                "msg": "Success"
            }
        }
    ],
    "live_urls":[
        {
            "device_id": "2198061243WLL4002533",
            "channel_id": "4",
            "live_url": "jvmp://121.37.155.76:7070/live/2198061243WLL4002533?token=&**************************************************",
            "result":{
                "code": "IVM.0",
                "msg": "Success"
            }
        }
    ]
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。