保利威云直播小程序播放插件提供了开箱即用的直播播放器，为客户在小程序端快速接入直播能力提供了有力支持。
快速接入
注意：请确保您的小程序具备电商平台或在线视频课程类目，否则无法使用本插件（详见微信小程序相关文档说明）。
在接入过程中，除了本文档，也可以参阅官方的小程序插件使用说明。
添加插件
在小程序管理后台的“设置-第三方服务-插件管理”中查找并添加插件，有两种查找方式：
通过 appid 查找。填写 wxfb2e591959a8bacf ，搜索插件并添加。
通过插件名称查找。填写 Polyv观看 ，搜索插件并添加。
引入插件代码包
如无特殊情况，请尽量使用插件的最新版本。
// 使用插件前，使用者要在 app.json 中声明需要使用的插件
"plugins": {
"polyv-live-player": {
"version": "0.11.0",
"provider": "wxfb2e591959a8bacf"
}
}
// 使用插件提供的自定义组件。在 json 文件定义需要引入的自定义组件时，使用 plugin:// 协议指明插件的引用名和自定义组件名
"usingComponents": {
"polyv-live-player": "plugin://polyv-live-player/live-player"
}
调用播放器组件
<!--
videoOption 为视频配置
controls 为控制栏配置
appSettings 为鉴权配置
配置字段见 API 说明
-->
<polyv-live-player
id="polyvPlayer"
videoOption="{{videoOption}}"
controls="{{controls}}"
appSetting="{{appSetting}}"
>
</polyv-live-player>
API
参数说明
videoOption: {
uid: '',
cid: '',
// 自动切换直播/暂存
isAutoChange: true,
// 画中画，同微信小程序video的 picture-in-picture-mode
pipMode: [],
// statistics 设置自定义统计参数
statistics: {
param1: 'param1',
param2: 'param2',
param4: 'param4',
param5: 'param5'
},
// 自动播放，默认true
autoplay: true,
// 回放视频循环播放，默认false
vodLoop: true,
// 回放指定视频初始播放位置, 单位秒
vodInitialTime: 20
},
// app参数设置
appSetting: {
// polyv后台appId
apiId: appId,
// 加密sign， 需要channelId, appId, timestamp 3个参数按照加密规则生成参数
sign,
// 时间戳
timestamp,
},
/**
* controls: Array | null | string
* 方式1: Array: ["play", "progress", "fullscreen", "refresh", "setting"]
* play：播放/暂停按钮
* progress：进度条
* fullscreen：全屏按钮
* refresh：刷新按钮（仅直播支持
* setting: 设置按钮 (回放 + 直播)
*
* 方式2: controls: null 不显示控制栏
*
* 方式3：controls: 'default' 显示默认的控制栏
**/
controls: ["play", "progress", "fullscreen", "refresh", "setting"]
播放器接口
获取组件的实例
// 假设插件的组件id为polyvPlayer
const polyvVideoContext = this.selectComponent('#polyvPlayer');
获取当前播放视频的上下文，具体内置方法，请参考微信官方文档。
getLiveType() :'live' | 'warmImage' | 'warmVideo' | 'vod' | ''
获取当前的直播状态。返回值说明：
''：播放器初始化未完成时，liveType为空字符串。
'warmImage'：处于显示暖场图片或暂无直播状态。
destroy() : void
销毁播放器（逻辑上销毁）。UI 界面请通过 wx:if 控制。
播放器事件
使用示例
<polyv-live-player
id="polyvPlayer"
videoOption="{{videoOption}}"
appSetting="{{appSetting}}"
bind:onChannelDetailReq="onChannelDetailReq"
bind:onLiveStatusChange="onLiveStatusChange"
bind:onLiveTypeChange="onLiveTypeChange"
>
</polyv-live-player>
onLiveTypeChange
liveType 发生改变时触发。
示例：
onLiveTypeChange(e) {
// e.detail 即为状态的字符串表示（见 getLiveType 的返回值说明）
console.log('liveType:', e.detail);
}
onLiveStorageProgress
适用于直播回放、暖场等场景，在进度发生改变时触发。
示例：
onLiveStorageProgress(e) {
// e.detail.currentTime 为当前视频的播放进度
console.log('onLiveStorageProgress', e.detail.currentTime);
}
onLiveVodWaiting
适用于回放等场景，在播放发生缓冲时触发。
示例：
onLiveVodWaiting() {
console.log('onLiveVodWaiting');
},
onLiveVodEnd
适用于直播回放、暖场等场景，在播放结束时触发。
示例：
onLiveVodEnd() {
console.log('onLiveVodEnd');
},
onChannelDetailReq
频道详情接口请求成功后触发的事件。
示例：
onChannelDetailReq(e) {
// e.detail 为频道详情数据
console.log('onChannelDetailReq', e.detail);
},
onLiveStatusChange
直播状态改变时触发。
示例：
onLiveStatusChange(e) {
// status 为当前直播状态的字符串表示，有 'live' 和 'end' 两个取值
// sessionId 为直播场次
console.log('onLiveStatusChange', e.detail.status, e.detail.sessionId)
}
扩展
本插件仅具备视频播放能力，如需实现直播介绍、聊天室、连麦等功能，可参考微信小程序SDK进行集成。
Change log
v0.11.0
v0.10.1
v0.10.0
新增播放组件参数autoplay、vodLoop、vodInitialTime。
新增回放缓冲事件onLiveVodWaiting。
v0.9.0
v0.8.0
v0.7.0
新增获取视频上下文实例的方法 getVideoContext()。
v0.6.0
v0.5.0
新增参数控制播放器控制栏的元素, 参数controls，不传这个参数时显示默认控制栏，传空数组时不显示控制栏，传非空数组时根据数组内容显示对应的元素。
新增事件 onChannelDetailReq 返回频道详情数据。
修复 播放器控件栏会先出现直播的控制栏，再切到回放的控制栏。
v0.2.0~0.4.0
v0.1.0
