設定播放器Logo

更新時間：2024-12-16 19:20:19

介面描述

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.ipolyv.cn/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檔案程式碼檢視)

簽名產生規則