集成说明

概述

Polyv 音频播放器是保利威云点播Web播放器的重要补充，主要应用于音频为主的业务场景，基于HTML5实现PC/移动端兼容，并深度融合了保利威视频云业务，如支持加密播放等，为用户提供简单、快速、安全、稳定的播放服务。

基础功能

1. 支持播放上传到保利威平台的音视频文件，并且支持播放加密的音视频文件。

2. 播放控制（播放、暂停，拖拽进度调整等）。

3. 两套默认皮肤可选，也可以自定义样式。

格式支持

• 音频格式：mp3、aac、m3u8

• 音频编码：mp3、aac

• 视频格式：mp4、m3u8

• 视频编码：h264

注：

1. 如果上传文件时设置的是默认转码方式，所有的文件都会转码为视频文件，使用音频播放器播放视频文件时，只会播放声音，没有图像。

2. 如果上传文件时设置了"源文件播放"，平台不会对源文件进行转码，播放器会直接播放源文件。建议上传mp3或aac格式的文件，其它音频格式文件，如3gp、ogg、wav、FLAC、mov等，能否正常播放取决于浏览器支持。

3. 如果上传视频文件时设置了“生成音频文件”，平台在转码时会额外转出一份mp3文件，音频播放器会播放该mp3文件。

适配情况

	mp3	aac	mp4	m3u8
iOS	✔️	✔️	✔️	✔️
Android	✔️	✔️	✔️	4.0+
Chrome	✔️	✔️	✔️	34+
Firefox	✔️	✔️	✔️	49+
IE	IE9+	IE9+	IE9+	IE11+ for Windows 8.1+
Edge	✔️	✔️	✔️	✔️
Safari	✔️	✔️	✔️	8+

常见适配问题：

1. 设置autoplay=true无效，不会自动播放

   • 移动端浏览器中音频自动播放一直是禁止的，目前通用的办法是通过用户手动触发播放（例如监听用户的点击事件并调用play方法），但不排除一些特性的浏览器和webview允许自动播放。

   • PC端Chrome 55以上版本、MacOS High Sierra Safari 11以上的浏览器也都限制自动播放。

2. 音量调节功能（setVolume）在iOS和部分Android浏览器上不支持。

3. 倍速播放功能（setSpeed）在部分移动端浏览器上不支持，比如Android 微信。

集成方式

引入资源

<!-- 指定版本 -->
<script src="//player.polyv.net/resp/vod-audio-player/0.1.2/audio-player.min.js"></script>
<!-- 最新版本 -->
<script src="//player.polyv.net/resp/vod-audio-player/latest/audio-player.min.js"></script>

创建 HTML 节点

<div id="myAudioPlayer"></div>

创建播放器实例

const plvAudioPlayer = new PlvAudioPlayer({
  vid: '从 polyv 后台获取的 vid',
  wrap: '#myAudioPlayer',
  skin: 'white'
});

在线运行

监听播放器事件

// 播放器初始化完毕
plvAudioPlayer.on('ready', function() {
  console.info('ready');
});

调用播放器方法，及获取播放器属性

// 切换加密视频
plvAudioPlayer.changeVid({
  ts: ts,
  sign: sign,
  vid: vid
});
// 获取音频文件当前播放进度
const currentTime = plvAudioPlayer.currentTime;