小程序播放插件

保利威云点播小程序播放插件基于保利威强大的后台能力和视频处理技术并深度融合自身视频云业务，为用户提供简单、快速、安全、稳定的视频播放服务，让用户轻松聚焦于业务发展本身，畅享极速高清播放体验。

只需把视频上传到到保利威云点播平台后得到一个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授权。

版本迭代记录

点播小程序插件迭代记录