小程式播放插件

保利威雲點播小程式播放插件基於保利威強大的後台能力與影片處理技術，並深度融合自身影片雲業務，為用戶提供簡單、快速、安全、穩定的影片播放服務，讓用戶輕鬆專注於業務發展本身，暢享極速高清播放體驗。

只需將影片上傳到保利威雲點播平台後，取得一個 vid 即可使用外掛程式播放影片，快速與自有業務整合。

點擊進入微信官方頁面查看本文件。

微信小程式接入方式

申請使用外掛程式

首先，請參閱微信官方的插件使用文檔申請插件權限，在申請使用插件時，填寫以下 appid：wx4a350a258a6f7876。 添加後，請聯繫您的客戶經理或「保利威」官方客服，申請審核通過。

引入外掛

詳見官方文件，請盡量使用最新版本的插件。

// 使用插件前，使用者要在 app.json 中声明需要使用的插件
"plugins": {
  "polyv-player": {
    "version": "1.9.0",
    "provider": "wx4a350a258a6f7876"
  }
}

// 使用插件提供的自定义组件。在 json 文件定义需要引入的自定义组件时，使用 plugin:// 协议指明插件的引用名和自定义组件名
"usingComponents": {
  "polyv-player": "plugin://polyv-player/player"
}

使用播放器元件

wxml 檔案

<polyv-player
  id="{{playerContext}}" // 组件ID
  playerId="{{playerId}}" //播放器ID
  vid="{{vid}}" // 视频ID
  viewerInfo="{{viewerInfo}}" // 观众信息
  autoplay="{{true}}" // 是否自动播放
  bind:statechange="onStateChange" //事件绑定
  >
  <!-- 使用具名插槽，实现在全屏和非全屏的情况，在 video 组件上显示内容 -->
  <view slot="custom">自定义插槽</view>
</polyv-player>

組件元素支援的屬性

元件支援的事件

外掛程式 API

可透過外掛程式取得播放器實例，包含以下方法：

範例程式碼：

// 通过插件的自定义组件ID获取上下文，在一些特殊场景下，如触发小程序生命周期onShow或onHide，建议重新使用this.selectComponent('#myComponentID')再次获取一次组件上下文
var polyvPlayerContext = this.selectComponent('#myComponentID');
polyvPlayerContext.play();  // 播放
polyvPlayerContext.pause(); // 暂停
polyvPlayerContext.stop() //停止
polyvPlayerContext.seek(100);  //跳转到指定位置，单位：秒
polyvPlayerContext.playbackRate(1.5); // 设置播放速率
var PolyvBarrageContext = this.selectComponent('#myComponentID').getPolyvBarrage(); // 获取弹幕实例
PolyvBarrageContext.sendDanmu({
   color: '#ffffff',
   text: this.data.danmuText
}); // 添加单条弹幕数据
PolyvBarrageContext.addDanmuData([{
   color: '#ffffff',
   text: this.data.danmuText
}]); // 添加多条弹幕数据
PolyvBarrageContext.closeDanmu(); // 关闭弹幕
PolyvBarrageContext.openDanmu(); // 开启弹幕

wx.onWindowResize(windowResize); // 监听窗口尺寸变化

var windowResize = function() {
   var polyvSkinContext = this.selectComponent('#polyvPlayer').getPolyvSkin(); // 获取皮肤实例
   polyvSkinContext.resize(); // 自适应进度条尺寸
}

跑馬燈參數

marqueeConfig 參數屬性如下：

錯誤代碼

外部樣式類別

從插件的 0.15.0 版本開始，支援外部樣式類別，用於自訂播放器的控制欄皮膚樣式，關於外部樣式類別的詳細說明與限制可以參考微信小程式官方文件。若樣式修改無效，建議可以加上 !important 來提高優先級。

目前可以支援修改的樣式：

範例 wxml 和 wxss：

<polyv-vod-player
  ex-control-icon-play="plv-custom-control-play" //自定义的class名
  ex-control-icon-pause="plv-custom-control-pause"
  ex-control-timeline="ex-control-timeline"
  ex-control-current="ex-control-current"
  ex-control-duration="ex-control-duration"
  ex-control-icon-setting="ex-control-setting"
  ex-control-setting-panel="ex-control-setting-panel"
  ex-control-icon-fullscreen="ex-control-icon-fullscreen"
  ex-control-icon-audio="ex-control-icon-audio"
  ex-control-icon-back="ex-control-icon-back"
  ex-control-progress-dot="ex-control-progress-dot"
  ex-control-progress-bar="ex-control-progress-bar"
  ex-control-progress-load="ex-control-progress-load"
  ex-control-progress-current="ex-control-progress-current"
  ex-control-skin="ex-control-skin"
  ex-control-setting-btn="ex-control-setting-btn"
  ex-control-setting-btn-select="ex-control-setting-btn-select"
  ex-control-setting-text="ex-control-setting-text"
/>

.plv-custom-control-play {
  background: url('https://{自定义的icon地址}/play.png') !important;
}

.plv-custom-control-pause {
  background: url('https://{自定义的icon地址}/pause.png') !important;
}

.ex-control-timeline {
  color: red;
}

Q&A

• Q1. 使用點播小程式插件是否需要申請影片類資格？

• A1. 使用點播小程式插件時，小程式通常無需重複申請插件自身具備的「文娛 - 其他影片」類目資質，但僅支援微信允許的非個人主體小程式。接入方仍需確保主體類型、實際業務內容和所選服務類目符合微信要求，並遵守小程式使用「影片類插件」的相關規範。如果小程式不透過本插件，而是使用自研元件或其他方式提供影片播放，應根據實際業務申請相應服務類目。最終以微信審核結果為準，具體可參考小程式插件功能介紹和微信開放的服務類目。

• Q2. 小程式授權的影片無法播放？

• A2. 目前小程式點播外掛暫不支援小程式授權方式的影片，建議使用WEB授權。

版本迭代紀錄

點播小程式外掛迭代記錄