设置播放器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示例：

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

响应异常JSON示例：

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

字段说明

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

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文件代码查看)

签名生成规则