TopGit
Đánh giá repo GitHub

Plyr: trình phát HTML5, YouTube và Vimeo

PTopGit review image for sampotts/plyr
Review by Topgit.dev for sampotts/plyr, with GitHub repository stats and README context.
Nhận định nhanh

Plyr làm tốt đúng một việc: thay control mặc định của HTML5, YouTube và Vimeo bằng một giao diện có thể tùy biến và một API JavaScript chuẩn hóa dùng chung cho cả ba. Plyr không tự giải mã HLS hay DASH, nên bạn vẫn phải tích hợp hls.js hoặc dash.js rồi giao phần tử kết quả cho Plyr điều khiển — nhưng một khi đã xong, cùng một bộ event và API hoạt động ở mọi nguồn.

Sao
★ 30.0k
Fork
⑂ 3.1k
Người đóng góp
👥 210
Ngôn ngữ
JavaScript
Giấy phép
MIT
Chủ đề
Frontend
Cập nhật
Oct 2026
Trang chủ
GitHub

Plyr là gì?

Plyr là một thư viện JavaScript bọc quanh phần tử video và audio HTML5 gốc, cùng embed iframe của YouTube và Vimeo, trong một giao diện player nhất quán và hỗ trợ trợ năng. Plyr được viết bằng ES6 thuần, không phụ thuộc jQuery, đi kèm CSS tùy chỉnh được qua CSS custom property, và bổ sung hỗ trợ phụ đề VTT, phím tắt bàn phím, cùng picture-in-picture.

Tính năng cốt lõi

  • ✓Phát video và audio HTML5 lẫn embed YouTube, Vimeo qua cùng một lớp bọc, nên bạn không phải xử lý ba API embed khác nhau.
  • ✓Hỗ trợ đầy đủ phụ đề VTT, kể cả nhiều track phụ đề cùng lúc, cùng markup thân thiện với screen reader.
  • ✓Dùng đúng phần tử HTML cho control — `<input type="range">` cho volume, `<progress>` cho thanh tua, `<button>` cho các nút — thay vì mẹo click bằng div.
  • ✓Cung cấp API chuẩn hóa cho playback, volume và seeking, đồng thời phát cùng bộ event dù nguồn là HTML5, YouTube hay Vimeo.
  • ✓Hỗ trợ fullscreen gốc, có fallback về chế độ 'full window' khi trình duyệt không hỗ trợ.
  • ✓Thêm picture-in-picture, phím tắt bàn phím, chỉnh tốc độ phát, và thuộc tính playsinline để phát video inline trên mobile.
  • ✓Tùy biến giao diện hoàn toàn qua CSS custom property như `--plyr-color-main`, thay vì phải viết lại stylesheet.
  • ✓Hỗ trợ phát streaming qua tích hợp với hls.js, Shaka và dash.js, cùng hỗ trợ i18n để dịch nhãn control.
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao ↗

Bạn có thể xây gì với Plyr

  • •Nhúng video HTML5 tự host kèm phụ đề và thanh control mang thương hiệu riêng.
  • •Chuẩn hóa control phát trên một trang trộn lẫn video HTML5 gốc, embed YouTube và Vimeo.
  • •Xây audio player cho podcast hoặc trang radio bằng hỗ trợ `<audio>`.
  • •Thêm stream HLS hoặc DASH, nơi Plyr lo phần giao diện còn hls.js hoặc dash.js lo giải mã.

Thêm Plyr vào dự án

Plyr có ba cách cài đặt, README mô tả đủ cả ba: cài package `plyr` rồi `import Plyr from 'plyr'` như một ES6 module; nhúng `plyr.js` và `plyr.css` từ CDN của Cloudflare — ví dụ trong README trỏ tới `https://cdn.plyr.io/3.8.4/plyr.js`, nên kiểm tra CDN để lấy bản hiện hành — chọn bản polyfilled (`plyr.polyfilled.js`) nếu cần hỗ trợ trình duyệt cũ hơn; hoặc self-host file build sẵn từ unpkg, hay chạy `npm i && npm run build` để tự tạo `dist` riêng. SVG icon sprite tự tải từ cùng CDN đó trừ khi bạn trỏ nó sang nơi khác.

Thiết lập cơ bản cho HTML5, YouTube và Vimeo

Với video HTML5 gốc, Plyr chỉ cần markup chuẩn: một phần tử `<video>` có thuộc tính `data-poster` (không phải `poster`, để ảnh không bị tải hai lần) và một `<track kind="captions">` cho phụ đề — không cần thêm HTML nào khác. Audio cũng vậy, chỉ cần `<audio controls>` thuần. Với YouTube và Vimeo, bạn progressive-enhance một `<iframe>` embed có sẵn, hoặc dùng `<div>` trơn với thuộc tính `data-plyr-provider` và `data-plyr-embed-id` nếu không muốn tự nhúng iframe. Sau khi có markup, `const player = new Plyr('#player');` biến nó thành một Plyr instance, và class `plyr__video-embed` giữ embed YouTube/Vimeo responsive ở tỷ lệ 16:9.

Vì sao developer chọn Plyr

  • ✓Một API và một bộ event dùng chung cho HTML5, YouTube và Vimeo, nên chuyển một trang từ video tự host sang embed YouTube không đòi viết lại JS.
  • ✓Control ngữ nghĩa thật (input range, phần tử progress, button) thay vì kiểu markup div chồng div quen thuộc của player video.
  • ✓CSS custom property giúp đổi giao diện player chỉ còn là đổi giá trị biến, không phải viết lại stylesheet.
  • ✓Giấy phép MIT, nên dùng miễn phí trong dự án thương mại mà không cần mua license riêng.
  • ✓Không phụ thuộc jQuery hay framework nào — thuần ES6, nên không kéo theo runtime bạn chưa sẵn có.

Hạn chế cần biết

  • △Plyr không tự giải mã stream HLS hay DASH — bạn vẫn cần hls.js, Shaka hoặc dash.js trong trang, còn Plyr chỉ điều khiển phần tử kết quả.
  • △YouTube và Vimeo là hai provider được Plyr tài liệu hóa; không có hỗ trợ dựng sẵn cho các nền tảng video khác.
  • △Tính năng ads gắn với một đối tác cụ thể (vi.ai) — muốn dùng vendor kiếm tiền khác thì bạn phải tự set `ads.tagUrl` thay vì dùng tích hợp có sẵn.
  • △Danh sách CSS custom property khá dài, nên tìm đúng biến điều khiển một chi tiết cụ thể, như kích thước mũi tên tooltip, cần đọc bảng tham chiếu chứ không đoán được.
Xem trên GitHub ↗Trang chủ ↗

Lựa chọn thay thế đáng cân nhắc

Video.js — một framework player nặng hơn với hệ sinh thái plugin, đáng cân nhắc nếu bạn cần plugin quảng cáo và analytics dựng sẵn thay vì tự nối.MediaElement.js — shim video/audio HTML5 đời cũ, hướng tới fallback trình duyệt cũ rộng hơn thay vì trọng tâm trợ năng và trình duyệt hiện đại như Plyr.Shaka Player — thư viện player của Google, phù hợp khi phát DASH/HLS và DRM là yêu cầu chính thay vì một UI control có thể tùy biến.

Câu hỏi thường gặp

Plyr có miễn phí cho mục đích thương mại không?

Plyr được phát hành theo giấy phép MIT, cho phép sử dụng thương mại mà không cần trả phí license riêng, miễn là giữ nguyên thông báo bản quyền trong mã nguồn.

Plyr có cần jQuery không?

Plyr không cần jQuery — README mô tả Plyr được viết bằng JavaScript ES6 thuần, không phụ thuộc framework nào, nên thêm Plyr vào dự án không kéo theo jQuery nếu dự án chưa dùng nó.

Làm sao để tùy chỉnh màu sắc và style của Plyr?

Style của Plyr được tùy chỉnh qua CSS custom property như `--plyr-color-main` cho màu chủ đạo và `--plyr-video-control-color` cho icon control, nên đổi giao diện nghĩa là ghi đè các biến này thay vì sửa trực tiếp stylesheet của Plyr.

Plyr có hỗ trợ streaming HLS và DASH không?

Plyr hỗ trợ phát HLS và DASH qua tích hợp với hls.js, Shaka và dash.js — Plyr lo phần giao diện và control, còn các thư viện đó lo giải mã manifest streaming.

Plyr hỗ trợ những trình duyệt nào?

README của Plyr nói hỗ trợ trình duyệt hiện đại và dẫn tới tài liệu browser-support riêng thay vì liệt kê số phiên bản cụ thể; trình duyệt cũ hơn được hỗ trợ qua bản polyfilled trên CDN thay vì bản chuẩn.

Có thể dùng Plyr với React hay Vue không?

README của Plyr không tài liệu hóa tích hợp riêng cho React hay Vue — Plyr là một ES6 module thuần khởi tạo bằng `new Plyr('#player')`, nên dùng trong React hay Vue nghĩa là tự bọc phần khởi tạo đó vào lifecycle hook của framework.

Vấn đề mà nó giải quyết

Control video HTML5 mặc định trông khác nhau ở mỗi trình duyệt, còn embed iframe của YouTube và Vimeo mỗi bên lại có API JavaScript và bộ event riêng, nên một trang trộn cả ba nguồn này kết thúc với ba kiểu control khác nhau và ba cách nghe event như 'played' hay 'ended'. Plyr gộp tất cả về một kiểu markup và một API event duy nhất.

Ai nên thử — và ai nên bỏ qua

Nên thử Plyr nếu bạn đang tự viết tay markup `<video>` hoặc phải vật lộn với style embed YouTube/Vimeo không đồng nhất trên một site — chỉ riêng API chuẩn hóa đã tiết kiệm công viết lại event handler cho từng provider. Bỏ qua nếu bạn cần giải mã HLS/DASH dựng sẵn ngay từ đầu, vì vẫn phải tự thêm hls.js hoặc dash.js, hoặc nếu dự án đã dùng sẵn plugin Video.js mà bạn phải dựng lại.

Repo liên quan

Nguồn & ghi công

Thông tin và tính năng lấy từ repository GitHub sampotts/plyr và README của nó.

Dữ liệu GitHub · đồng bộ lần cuối 15 thg 8, 2026Đánh giá bởi Henry
← Về TopGit

Muốn nghe thêm một ý kiến về plyr?

Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về plyr.

GitHub