整合說明

概述

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 檔案。

相容情況

常見相容問題：

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;