# 设置播放器Logo

### 接口描述

```
1、修改播放器logo图片
2、接口URL中的{channelId}为 频道ID
3、接口支持https协议
```

### 接口URL

```
http://api.polyv.net/live/v2/channels/{channelId}/update
```

### 请求方式

```
POST
```

### 支持格式

```
JSON
```

### 请求数限制

```
TRUE
```

### 请求参数

| 参数名          | 必选 | 类型     | 说明                                         |
| ------------ | -- | ------ | ------------------------------------------ |
| appId        | 是  | string | 从API设置中获取，在直播系统登记的appId                    |
| timestamp    | 是  | string | 当前13位毫秒级时间戳，3分钟内有效                         |
| logoImage    | 是  | string | logo图片地址，建议大小为：长方形140x50或正方形50x50          |
| logoOpacity  | 是  | string | logo透明度，取值范围为(0,1]，即大于0，并且小于等于1            |
| logoPosition | 是  | string | logo位置，取值为为左上角(tl)、右上角(tr)、左下角(bl)、右下角(br) |
| logoHref     | 否  | string | logo图片点击跳转链接                               |
| sign         | 是  | string | 签名，32位大写MD5值                               |

### 响应成功JSON示例：

```json
{
  code: 200,
  status: "success",
  message: "",
  data: true
}
```

### 响应异常JSON示例：

```json
{
  code: 400,
  status: "error",
  message: "invalid timestamp.",
  data: ""
}
```

### 字段说明

| 参数名     | 说明     |
| ------- | ------ |
| code    | 响应状态码  |
| status  | 响应状态   |
| message | 异常错误信息 |
| data    | 异常错误数据 |

### php请求示例

```php
<?php

//引用config.php
include 'config.php';

//接口需要的参数（非sign）赋值
$channelId = "127075";
$logoImage = "http://demo.polyv.net/wfy/live/logo.jpg"; //播放器封面图
$logoOpacity = "0.5"; //透明度，取值范围为(0,1]
$logoPosition = "tr"; //图片位置，取值为左上(tl)、右上(tr)、左下(bl)、右下(br)
$logoHref ="http://www.polyv.net"; //图片点击跳转链接

$params = array(
    'appId'=>$appId,
    'logoImage'=>$logoImage,
    'logoOpacity'=>$logoOpacity,
    'logoPosition'=>$logoPosition,
    'logoHref'=>$logoHref,
    'timestamp'=>$timestamp
  );

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法

//接口请求url
$url = "http://api.live.polyv.net/v2/channels/$channelId/update?appId=$appId&timestamp=$timestamp&logoHref=$logoHref&logoImage=$logoImage&logoOpacity=$logoOpacity&logoPosition=$logoPosition&sign=$sign";
$ch = curl_init() or die ( curl_error() );
curl_setopt( $ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
$response = curl_exec ( $ch );
curl_close ( $ch );
echo $response;

?>
```

### 签名规则(config.php文件代码查看)

[签名生成规则](https://git.polyv.net/help-center/document-center/-/blob/master/live/api/buildSign/README.md)