2.2.8

快速開始

最後更新


本頁說明如何載入 FlexPlyr、在頁面上掛載第一個播放器,並在播放器就緒後呼叫它的方法。

前置需求


  • 支援 ES2022 私有欄位(#field)與 CSS :has() 的現代瀏覽器
  • 頁面可連線至 cdn.jsdelivr.net、fonts.googleapis.com、www.youtube.com、player.vimeo.com(見執行期相依資源)
  • 僅能在瀏覽器執行:模組一載入就存取 document 與 navigator

安裝


jsDelivr CDN


  1. <script src="https://cdn.jsdelivr.net/npm/@pardnchiu/flexplyr@2.2.9/dist/FlexPlyr.js"></script>

載入後即有全域 FPlyr。

npm


  1. npm i @pardnchiu/flexplyr

  1. import { FPlyr } from "@pardnchiu/flexplyr/dist/FlexPlyr.esm.js";

package.json 的 main 指向 dist/FlexPlyr.js(非模組建置,掛載 window.FPlyr);要用具名匯出需引入 dist/FlexPlyr.esm.js。

第一個播放器


指定既有元素的 id 與一個媒體來源。播放器會把該元素變成 .FPlyr 容器,寬高填滿父元素,因此父元素需要有高度。
  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. video: "https://cdn.pixabay.com/video/2023/11/28/191159-889246512_tiny.mp4",
  6. when: {
  7. ready: () => setTimeout(() => console.log("ready, paused:", player.isPaused())),
  8. },
  9. });
  10. </script>
即時預覽 · @pardnchiu/flexplyr@2.2.9

在 ready 之後才呼叫方法


when.ready 在播放器內部設定來源旗標之前觸發(src/js/model/player.js:395),因此在 ready 回呼中同步呼叫 isPaused()、isMuted()、play() 會得到 undefined 或沒有作用。把呼叫延到下一個 task(如 setTimeout)即可取得正確結果,詳見生命週期事件。

下一步


EN