Update Player Logo Information

API Description

更新一个播放器的logo设置信息

API URL

http://api.polyv.net/v2/player/update-logo

Online API Call

Request Method

POST

API Constraints

1. The API supports both HTTP and HTTPS. HTTPS is recommended for security. API calls have frequency limits. See details

Request Parameter Description

Example

http://api.polyv.net/v2/player/update-logo?userid=abcde12345sign=F809B946258A112A78627A832B1F6A7D&ptime=1617845463779&playerId=xxx&logoOpacity=100&logoDisplayLocation=1&logoLinkUrl=xxx

Response Parameter Description

data Field Description

skin Field Description

logo Field Description

teaserTrailer Field Description

Java Request Example

For quick integration of the base code, please download the relevant dependency source code. Click to download source code. After downloading, add it to your own source code project. The HttpUtil.java and VodSignUtil.java in the test cases are included in the download file.

It is strongly recommended to use the VOD Java SDK for API integration. The VOD Java SDK provides unified encapsulation and optimization for API call logic, exception handling, data signing, and HTTP request thread pooling.

private static final Logger log = LoggerFactory.getLogger(VodVideoPlayerTest.class);

/**
 * 查询播放器列表
 */
@Test
public void testPlayerUpdateLogo() throws Exception, NoSuchAlgorithmException {
        //公共参数,填写自己的实际参数
        String secretKey = "xxx";
        String userid = "xxx";
        String ptime = String.valueOf(System.currentTimeMillis());
        String url = "http://api.polyv.net/v2/player/update-logo";

        Map<String, String> requestMap = new HashMap<>();
        requestMap.put("userid", userid);
        requestMap.put("ptime", ptime);
        requestMap.put("sign", VodSignUtil.getSign(requestMap, secretKey));
        
        requestMap.put("playerId", "xxx");
        requestMap.put("logoOpacity", "100");
        requestMap.put("logoDisplayLocation", "1");
        requestMap.put("logoLinkUrl", "xxx");
    
        Map<String,File> fileMap = new HashMap<>();
        fileMap.put("logoImageFile",new File("abc.jpg"));
    
        String response = HttpUtil.postFile(url, requestMap, fileMap, Constant.UTF8);
        log.debug("测试更新播放器logo,{}", response);
        //do something
}

Response Example

For global error descriptions, see Global Error Description

Success Example

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "playerId": "abcde12345",
        "playerName": "默认播放器",
        "isDefault": 1,
        "updateTime": "2025-02-18 17:10:39",
        "skin": {
            "skinTheme": "skin_39",
            "skinColor": "#d1d1d1",
            "skinColorApplyType": "",
            "skinControlLocation": 2
        },
        "logo": {
            "logoImageUrl": "https://img.videocc.netxxx.jpg",
            "logoLinkUrl": "http://www.polyv.net",
            "logoOpacity": 100,
            "logoDisplayLocation": 1
        },
        "teaserTrailer": {
            "teaserShow": 0,
            "teaserMediaUrl": "",
            "teaserPlayTime": 0,
            "trailerShow": 0,
            "trailerMediaUrl": "",
            "trailerPlayTime": 0
        }
    }
}

Error Example

{
    "code": 400,
    "status": "error",
    "message": "the sign is not right.",
    "data": ""
}