版權保護最佳實踐

1. 功能介紹

保利威致力於提升影片播放的安全性，保護您的影片資源。透過自行研發的影片版權保護方案（VRM）和自有專利的加密演算法，保利威能夠最大限度保證影片檔案的安全。您在對接保利威 PlaySafe 影片保護功能時，建議參考本文的最佳實踐，以獲得最佳的影片安全保護效果。

2. 整體方案

對接影片加密功能，需要您的伺服器側和客戶端側進行一定量的修改，以下流程圖展示了播放加密影片功能的整體工作流程：

接下來對流程圖中的各個步驟進行詳細描述：

1. 您的終端向您的伺服器請求Token

在播放影片前，您的終端（包括 Web 端、行動 App 端、pc 播放器等）應使用待播放影片的vid，透過您內部自己開發的介面，向您的伺服器請求播放 Token。為了加強 Token 的安全性，您的介面應當使用 HTTPS 協定。

2. 您的伺服器向保利威伺服器請求Token

您的伺服器端應透過 取得影片播放憑證 介面向保利威伺服器請求加密影片播放所需的 Token。

• 建議您聯繫保利威技術支援設定IP白名單 限制功能，在設定白名單後，只有您指定的 IP 可以透過該介面取得 Token，其它 IP 均無法請求該介面獲得 Token

3. 保利威伺服器返回Token給您的伺服器

保利威伺服器在收到您的取得指定影片播放憑證的請求後，在校驗無異常時，會向您的伺服器回傳一個用於播放加密影片的 Token

4. 您的伺服器端返回Token給您的終端

您的伺服器在收到保利威回傳來的 Token 時，需要向終端回傳該 Token。在向終端回傳 Token 時，您應當使用自己定義的一套加密規則對 Token 加密，以免該 Token 在網路傳輸過程中被洩露出去。

5. 您的終端使用點播SDK播放影片

在播放加密影片前，您需要呼叫點播 SDK 的介面，傳遞從您的伺服器獲得的 Token。若您在伺服器已經對 Token 進行了加密，您需要在終端先根據對應的規則進行解密，再傳遞真實的 Token 給點播 SDK

下面將對您需要改動的地方進行說明，並提供範例程式碼以供參考。

3. 伺服器側

您的伺服器需要關注的是上圖中「客戶伺服器和保利威伺服器的互動」這一部份。

在伺服器側，您應該提供一個介面實現從保利威伺服器申請播放對應影片（指定vid）的 Token 並回傳的功能，以便您的終端可以透過伺服器取得播放 Token，具體功能點如下：

1）取得介面請求參數：影片 vid，使用者 viewerId，以及其他參數；

2）請求保利威伺服器的 取得影片播放憑證 介面，行動端請求需對 viewerId 進行 base64 處理；

3）解析介面回傳值，取得 Token；

4）透過自己定義的一套加密規則對 Token 加密，以免洩露；

5）向客戶端回傳加密後的 Token。

3.1 範例程式碼

/**
 * 获取点播加密视频的播放token
 */
@PostMapping("/getVodToken")
@ResponseBody
public ResponseVO getVodToken(@RequestBody GetTokenRequestVO tokenReq, HttpServletRequest request) throws IOException, NoSuchAlgorithmException {
    // 请求参数处理
    String videoId = tokenReq.getVideoId();
    String viewerId = tokenReq.getViewerId();
    if (StringUtils.isEmpty(videoId) || StringUtils.isEmpty(viewerId)) {
        return ResponseVO.failure("argument is error");
    }
    Map<String, Object> args = new HashMap<>(16);
    args.put("videoId", videoId);
    args.put("viewerId", viewerId);
    args.put("viewerIp", IPUtil.getIPAddress(request));
    args.put("viewerName", tokenReq.getViewerName());
    args.put("expires", tokenReq.getExpires());
    args.put("disposable", tokenReq.getDisposable());
    args.put("iswxa", tokenReq.getIswxa());
    args.put("userId", USER_ID);
    args.put("ts", System.currentTimeMillis());
    // 去除空值参数
    Map<String, String> params = args.entrySet()
            .stream()
            .filter(entry -> entry.getValue() != null)
            .collect(
                    Collectors.toMap(Map.Entry::getKey, entry -> String.valueOf(entry.getValue()))
            );
    // 请求参数签名
    params.put("sign", LiveSignUtil.getSign(params, SECRET_KEY));
    
    // 向保利威服务器请求Token
    TokenVO vo = RequestTokenService.requestTokenFromServer(params);
    if (vo == null || vo.getCode() == null || vo.getCode() != HttpStatus.OK.value()) {
        return ResponseVO.failure("请求数据失败");
    } else {
        // TODO 在返回Token前建议实现自己的加密逻辑，以免在网络传输过程中泄露Token
        return ResponseVO.success(vo.getData());
    }
}

其中 requestTokenFromServer 方法實現了呼叫保利威伺服器 取得影片播放憑證 介面取得 Token

private const val API_URL = "http://hls.videocc.net/service/v1/token"

/**
 * 向保利威服务器请求Token
 * POST方式，Content-type: application/x-www-form-urlencoded
 */
fun requestTokenFromServer(params: Map<String, String>): TokenVO {
    return httpClient.submitForm(
        url = API_URL,
        formParameters = Parameters.build {
            params.forEach { (key, value) ->
                append(key, value)
            }
        }
    ).bodyAsObject<TokenVO>()
}

更詳細的程式碼可以移步 Gitee地址 進行瀏覽

3.2 GetTokenRequestVO 參數描述

3.3 TokenVO 參數描述

4. 終端側

終端側需要關注的是上圖中「客戶終端和客戶伺服器的互動」、「客戶終端和保利威點播SDK的互動」這兩部份。

在終端側，您需要做的事情如下：

1）影片播放前，呼叫您的伺服器自行開發的介面，透過影片vid，獲得對應影片的播放 Token。

注意，行動端（iOS端和android端）向您的伺服器請求取得播放 Token 時，請求參數的 viewerId 必須經過 Base64 編碼。

2）若您在伺服器側已經對 Token 進行了加密，您還需要先根據自訂的規則對取得的 Token 進行解密。

3）透過保利威點播 SDK 所提供的 API 傳遞解密後的 Token。

上述步驟1和2，屬於「客戶終端和客戶伺服器的互動」，需要您自行開發，這裡不予細述，以下範例程式碼主要展示了步驟3——如何呼叫點播 SDK 的 API 傳遞 Token，這部份屬於「客戶終端和保利威點播SDK的互動」。

4.1 Web 端

完整的範例程式碼請參考 點播 JS SDK 播放加密影片

var player = polyvPlayer({
   wrap: '#player',
   width: 800,
   height: 533,
   vid: '88083abbf5bcf1356e05d39666be527a_8',
   playsafe:'81814fed-bdd0-4506-bec1-ebc8093148c5-hfevwsfxcsbcocx', // 通过 playsafe 传入 token
   ts:'1568131545000',
   sign:'88313661ba7ded642c7b557b0a364b4b'
});

4.2 iOS 端

完整的範例程式碼請參考 點播 iOS SDK 4.影片播放 4.1.2 外部傳入播放憑證。

// 通过配置播放器的 requestCustomKeyTokenBlock 属性，播放器内部在开始播放加密视频时，将会自动执行该 block ，并使用 block 返回的 token 对加密视频进行解密。
self.player.requestCustomKeyTokenBlock = ^NSString *(NSString *vid) {
        // 通过参数 vid，向客户自己的服务器请求 token
        NSString *encodeToken = @"xxxxxxxx";
        // 将服务器返回的 token 进行解密
        NSString *decodeToken = @"yyyyyyyy";
    return decodeToken;
};
// 通过 vid 获取在线播放视频模型
[PLVVodVideo requestVideoWithVid:vid completion:^(PLVVodVideo *video, NSError *error) {
    // 播放视频 
    weakSelf.player.video = video;
}];

4.3 Android 端

4.3.1 影片播放

完整的範例程式碼請參考 點播 Android SDK 4.影片播放 1.2 外部傳入播放憑證

videoView.setVideoTokenRequestListener(new IPLVVideoTokenRequestListener() {
    @Override
    public String onRequestToken(PolyvVideoVO videoVO, String viewerId, String viewerName, String viewerParam) {
        // 返回外部获取的 token
        return token;
    }
});
// 通过vid播放视频
videoView.setVid(vid, bitrate, isMustFromLocal);

4.3.2 影片下載

完整的範例程式碼請參考 點播 Android SDK 5.影片下載

downloader.setDownloaderTokenRequestListener(new IPLVDownloaderTokenRequestListener() {
    @Override
    public String onRequestToken(@NotNull String videoId, int bitRate) {
        // 返回视频下载的token
        return token;
    }
});

4.4 C++ SDK

C++ SDK 如何傳遞 Token 並播放影片程式碼範例：

// 创建播放器对象，window为播放窗口句柄
auto player = PLVPlayerCreate(window);
// 播放前要先设置vid, videoPath为离线播放的视频存放地址，videoRate为视频的清晰度
PLVPlayerSetVideo(player, vid, videoPath, videoRate);
// 开始在线播放，token通过业务侧获取传入，seekMillisecond开始播放时想要seek的位置，sync是否同步(播放时会请求videoJson，同步时会阻塞等待请求结果，异步时通过回调通知结果)
PLVPlayerPlay(palyer, token, seekMillisecond, sync);

4.5 APICloud 平台

APICloud 如何呼叫點播 SDK 的 API 傳遞 Token 並播放影片程式碼範例：

// 设置 播放外部播放 token
this.polyvVideo.setCustomVideoToken({token:""}, function (ret, err) {
});
// 通过 vid 播放在线视频
this.polyvVideo.setVid({
     vid: ""
 });

4.6 uniapp 平台

uniapp 如何呼叫點播 SDK 的 API 傳遞 Token 並播放影片程式碼範例：

// 设置 播放外部播放 token
this.$refs.vod.setCustomVideoToken({token: ""},(ret) => {
})
// 通过 vid 播放在线视频
this.$refs.vod.setVid({
        vid: "",
    level: 0
},(ret) => {
})