2.2.8

媒體來源

最後更新


本頁說明 FlexPlyr 支援的四種媒體來源、同時設定多個來源時的取捨,以及 YouTube/Vimeo 必須等 SDK 載入後才能建立的原因。

四種來源


設定欄位值底層播放器備註
video影片 URL<video preload="auto" playsinline>桌面版點擊畫面切換播放;行動裝置另建全螢幕播放器
audio音訊 URL<audio>(隱藏)只顯示控制面板;full 按鈕不渲染
youtubeYouTube 影片 IDYT.Player以 controls: 0、modestbranding: 1 等參數嵌入,FlexPlyr 面板取代原生控制列
vimeoVimeo 影片 IDVimeo.Player以 background=1&controls=0 嵌入 iframe

值會先 String() 再 trim(),空字串視為未設定。
其他網頁播放器涵蓋的來源各有重疊。Video.js 自述為支援 HTML 與 React 的開源媒體播放器框架,支援 HLS 與 DASH 串流;Plyr 是支援 HTML5、YouTube 與 Vimeo 的簡易播放器,維護者已標示停止開發、改推 Video.js 10;MediaElement.js 把 HTML5 影音與 YouTube、Vimeo、SoundCloud、Facebook、HLS、DASH 統一在同一套 API;vLitejs 以極簡主題替 HTML5、YouTube、Vimeo、Dailymotion 播放器換膚。FlexPlyr 專注四種來源(video、audio、youtube、vimeo),以單一 FPlyr 設定驅動;只需一支腳本,載入時自行注入樣式表與兩個 SDK;透過 option.panelType 切換五種內建面板風格;video 與 youtube 來源在行動裝置全螢幕時以隱藏的第二個播放器同步進度(見行動裝置全螢幕)。

優先順序


同時設定多個來源時,依 video → youtube → vimeo → audio 取第一個非空值(src/js/model/player.js:100),其餘欄位不會被寫入實例。
  1. <div style="max-width: 480px; aspect-ratio: 16 / 9"><div id="player"></div></div>
  2. <script>
  3. const player = new FPlyr({
  4. id: "player",
  5. youtube: "O5O3yK8DJCc",
  6. video: "https://cdn.pixabay.com/video/2023/11/28/191159-889246512_tiny.mp4",
  7. });
  8. console.log("video:", player.video);
  9. console.log("youtube:", player.youtube);
  10. </script>
即時預覽 · @pardnchiu/flexplyr@2.2.9

音訊


  1. <div id="player"></div>
  2. <script>
  3. const player = new FPlyr({
  4. id: "player",
  5. audio: "https://interactive-examples.mdn.mozilla.net/media/cc0-audio/t-rex-roar.mp3",
  6. option: { panelType: "classic" },
  7. when: {
  8. ready: () => console.log("audio ready, full button:", player.panel.buttonFull != null),
  9. },
  10. });
  11. </script>
即時預覽 · @pardnchiu/flexplyr@2.2.9

YouTube 與 Vimeo:等待 SDK


FlexPlyr 在載入時以 async 注入 iframe_api 與 player.js,但建構子會立即建立 YT.Player/Vimeo.Player(src/js/model/player.js:824、:864)。若在 SDK 尚未載入完成時建立播放器,會拋出 ReferenceError: YT is not defined 或 Vimeo is not defined,且之後不會重試。
由腳本注入的 async script 會延後 window 的 load 事件,因此在 load 之後建立播放器即可:
  1. <div style="max-width: 480px; aspect-ratio: 16 / 9"><div id="player"></div></div>
  2. <script>
  3. addEventListener("load", () => {
  4. const player = new FPlyr({
  5. id: "player",
  6. youtube: "O5O3yK8DJCc",
  7. when: {
  8. ready: () => setTimeout(() => console.log("youtube ready, paused:", player.isPaused())),
  9. },
  10. });
  11. });
  12. </script>
即時預覽 · @pardnchiu/flexplyr@2.2.9

  1. <div style="max-width: 480px; aspect-ratio: 16 / 9"><div id="player"></div></div>
  2. <script>
  3. addEventListener("load", () => {
  4. const player = new FPlyr({
  5. id: "player",
  6. vimeo: "76979871",
  7. when: {
  8. ready: () => setTimeout(() => console.log("vimeo ready, paused:", player.isPaused())),
  9. },
  10. });
  11. });
  12. </script>
即時預覽 · @pardnchiu/flexplyr@2.2.9

load 已經觸發後(例如 SPA 中途建立播放器)才建立時,SDK 已存在,可直接建立。

相關頁面


EN