小程式SDK

更新時間：2025-10-10 12:02:04

註：點播影片播放的小程式SDK功能相對簡單，只提供了獲取影片播放位址以及日誌發送等基本功能。建議使用點播影片播放的小程式插件，整合更簡單，功能更豐富。

小程式點播SDK下載（點擊下載諮詢）

開發前準備

1.小程式微信開發者後台設定-開發設定-伺服器域名中設定 [request合法域名]

router.polyv.net
hls.videocc.net
prtas.videocc.net
player.polyv.net

開始開發

1.獲取影片播放位址

index.js

import polyv from '../../utils/polyv.js';

Page({
  ...
  onReady: function () {
      //获取视频播放地址
      let vid = "e8888b74d1bd0f19e821d6185279564a_e";
    let vidObj = {
        vid: vid,
        callback: function(videoInfo){
            that.setData({
                // 按数组下标递增的顺序分别为流畅、高清、超清视频的分辨率
              videoSrc: videoInfo.src[0]
            });
        }
    };
    polyv.getVideo(vidObj);
  }
}

選項說明

vid

類型：String 說明：影片Id

callback（videoInfo）

類型：Function 說明：獲取影片資訊成功時觸發參數：videoInfo 參數類型：object 參數說明：

參數	參數說明
src	陣列：多個碼率影片播放位址，獲取成功後取其中一種碼率設定為video元件的src 依陣列下標遞增的順序分別為流暢、高清、超清影片的解析度
poster	影片封面
title	影片標題
teaser_url	影片片頭，以回傳連結後綴判斷圖片/影片類型
duration	影片總時長
timeoutflow	只回傳該屬性並為true，表示套餐過期
outflow	只回傳該屬性並為true，表示套餐流量不足

params

類型：object 說明：播放日誌自訂參數

參數值可選	說明
param1	使用者ID
param2	觀眾暱稱

sid

類型：String 說明：POLYV後台觀看日誌中自訂ID

ts

類型：String 說明：web授權加密時間戳，使用web授權影片播放時添加

sign

類型：String 說明：web授權加密驗證sign，使用web授權影片播放時添加

appId

類型：String 說明：子帳號appId，使用子帳號播放web授權影片播放時添加。同時，sign計算需要使用帳號對應的secretkey

2.獲取影片預覽播放位址

onReady: function () {
      //获取视频预览播放地址
      let vid = "e8888b74d1bd0f19e821d6185279564a_e";
    let vidObj = {
        vid: vid,
        callback: function(videoInfo){
            that.setData({
              videoSrc: videoInfo.src[0]
            });
        }
    };
    polyv.getPreviewVideo(vidObj);
  }

3.播放日誌發送

//需要绑定video组件bindtimeupdate时间并调用polyv.timeUpdate
<video id="polyvVideo" class="vp-v" src="{{videoSrc}}" bindtimeupdate="timeUpdate"></video>

timeUpdate: function (e) {
  polyv.timeUpdate(e);
}

ps：請留意參數e為必須項

4.銷毀播放日誌定時器

onUnload: function () {
  polyv.destroy();
}

更新說明

6.7.3微信新版本下，非加密影片播放失敗問題已修復相容（2018-10-10）。