快速接入範例

範例程式碼接入前提條件

在對接保利威直播API功能前，確保B端已經具備如下環境：

• 安裝Java環境。

  範例程式碼支援JDK 1.8或更高版本。

• 取得金鑰

  到保利威官網註冊保利威帳號並取得存取金鑰資訊（UserId、AppId、AppSecret）。

  

  

1.報文協定

1.1 Protocol

HTTP 1.0/1.1

1.2 Header

• Method: POST

Content-Type = application/json;charset=UTF-8

Accept = application/json;charset=UTF-8

• Method: GET

Content-Type = application/json;charset=UTF-8

Accept = application/json;charset=UTF-8

2.新增Maven依賴

  將如下依賴加入到專案的POM檔案中：

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <httpclient.version>4.5.13</httpclient.version>
        <slf4j.version>1.7.30</slf4j.version>
        <lombok.version>1.18.16</lombok.version>
        <fastjson.version>1.2.70</fastjson.version>
        <junit.version>4.12</junit.version>
    </properties>

    <dependencies>
        <!-- 基本工具 -->
        <dependency>
            <groupId>org.apache.httpcomponents</groupId>
            <artifactId>httpclient</artifactId>
            <version>${httpclient.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.httpcomponents</groupId>
            <artifactId>httpmime</artifactId>
            <version>${httpclient.version}</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
 

3.系統基礎程式碼

快速接入基礎程式碼請下載相關依賴原始碼， 點擊下載原始碼 ，下載後加入到自己的原始碼工程中即可。測試案例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下載檔案中。

4.執行測試程式碼

  測試依據頻道分類ID修改直播頻道分類名稱，單元測試程式碼如下：

package net.polyv.live.account;

import net.polyv.LiveBaseTest;
import net.polyv.util.HttpUtil;
import net.polyv.util.LiveSignUtil;
import org.junit.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.IOException;
import java.security.NoSuchAlgorithmException;
import java.util.HashMap;
import java.util.Map;

public class AccountTest extends LiveBaseTest {

    private static final Logger log = LoggerFactory.getLogger(AccountTest.class);
    /**
     * 修改直播频道分类名称
     * @throws IOException
     */
    @Test
    public void testUpdateCategoryName() throws IOException, NoSuchAlgorithmException {
        //公共参数,填写自己的实际参数
        String appId=super.appId;
        String appSecret=super.appSecret;
        String userId = super.userId;
        String timestamp=String.valueOf(System.currentTimeMillis());
        //业务参数
        String url = "http://api.polyv.net/small-class/xx/xx";
        String categoryId = "345134";
        String categoryName = "分类234";

        //http 调用逻辑
        Map<String,String> requestMap = new HashMap<>();
        requestMap.put("appId", appId);
        requestMap.put("timestamp",timestamp);
        requestMap.put("categoryId",categoryId);
        requestMap.put("categoryName",categoryName);
        requestMap.put("sign",LiveSignUtil.getSign(requestMap, appSecret));
        String response = HttpUtil.postFormBody(url, requestMap);
        log.info("测试修改直播频道分类名称，返回值：{}",response);
        //do somethings

    }
}

  執行程式碼後，控制台應有如下關鍵輸出，表示接入成功：

测试修改直播频道分类名称接口返回值：{"code":200,"status":"success","message":"","data":""}