Język:

Video.js vs Plyr vs react-player vs hls.js: którą bibliotekę odtwarzacza wideo wybrać?

Video.js, Plyr, react-player, hls.js czy Mux Player? Sprawdź, jak działa każda biblioteka, porównaj konfigurację i funkcje, a następnie wybierz rozwiązanie dla swojej witryny lub aplikacji — albo zrezygnuj z bibliotek.
Sprawdź, co sądzi ChatGPT
autorstwa

Potrzebujesz odtwarzacza wideo na stronie lub w aplikacji? Wciąż przewijają się cztery nazwy: Video.js, Plyr, react-player i hls.js — a jeśli korzystasz ze streamingu Mux, dołącza do nich Mux Player. Wszystkie są popularne i mają otwarty kod źródłowy, ale służą do rozwiązywania różnych problemów.

W tym przewodniku wyjaśniamy, czym właściwie jest każda z tych opcji, pokazujemy minimalny kod konfiguracji, porównujemy je i pomagamy wybrać odpowiednią — albo zdecydować, że biblioteka wcale nie jest potrzebna.

Najważniejsze wnioski



  • Video.js — rozbudowany framework odtwarzacza z bogatym ekosystemem wtyczek, różnymi skórkami i wbudowaną obsługą HLS/DASH. Najlepszy wybór, gdy liczą się kontrola i możliwość rozbudowy.
  • Plyr — lekki odtwarzacz z dopracowanym i dostępnym interfejsem dla filmów HTML5, YouTube i Vimeo. Idealny, gdy zależy Ci na atrakcyjnym odtwarzaczu bez zbędnych komplikacji.
  • react-player — komponent React, który za pomocą jednego API odtwarza różne typy adresów URL (pliki, YouTube, Vimeo i inne). Najlepiej sprawdza się w aplikacjach React korzystających z różnych źródeł.
  • hls.js — to nie interfejs odtwarzacza, lecz silnik transmisji strumieniowej, który umożliwia odtwarzanie HLS w przeglądarkach bez natywnej obsługi tego formatu. Połącz go ze znacznikiem wideo lub odtwarzaczem.
  • Mux Player — odtwarzacz stworzony z myślą o filmach hostowanych w Mux, z wbudowaną analityką. Najlepszy wybór, jeśli korzystasz z Mux jako platformy wideo.
  • Jeśli chcesz dodać na stronach marketingowych galerię filmów z YouTube, TikToka lub Instagrama, gotowy widget zwykle pozwoli Ci zrobić to szybciej niż dowolna biblioteka.

Jaki problem rozwiązujesz?

Zanim porównasz funkcje, zastanów się, do czego potrzebujesz narzędzia. Większość zespołów znajduje się w jednej z czterech sytuacji:

  1. Odtwarzaj własne pliki MP4 w bardziej dopracowanym interfejsie niż domyślny odtwarzacz przeglądarki — skorzystaj z Plyr lub Video.js.
  2. Transmituj długie filmy lub prowadź transmisje na żywo w adaptacyjnej jakości (HLS/DASH) — użyj Video.js, hls.js z własnym interfejsem albo odtwarzacza swojej platformy wideo (np. Mux Player).
  3. Odtwarzaj adresy URL z wielu serwisów w aplikacji React — dziś YouTube, jutro link do Vimeo, a w przyszłym tygodniu plik MP4 — react-player.
  4. Wyświetlanie wielu filmów z YouTube, TikToka lub Instagrama w formie galerii na stronie to nie tyle kwestia odtwarzacza, co treści i układu (zobacz ostatnią sekcję).

Biblioteki w skrócie

 Video.jsPlyrreact-playerhls.jsMux Player
Co to jestPełny framework odtwarzaczaLekki interfejs odtwarzaczaWrapper Reacta dla wielu źródełSilnik streamingu HLS (bez interfejsu)Odtwarzacz wideo hostowanego w Mux
LicencjaApache 2.0MITMITApache 2.0MIT
Pliki wideo HTML5TakTakTakZa pomocą elementu wideoZasoby Mux
YouTube / VimeoZa pomocą wtyczekWbudowaneWbudowaneNieNie
HLSWbudowany (VHS)Z hls.jsUżywa hls.js dla plików .m3u8Tak — taki jest jego celTak
PULPITWbudowany (VHS)Z biblioteką DASHZa pomocą wtyczki odtwarzacza plikówNie—
NapisyTakTakZależy od źródłaObsługuje je Twój odtwarzaczTak
Skórki / motywySkórki CSS, motywy, wtyczkiZmienne CSSInterfejs samego źródła—Zmienne CSS, motywy
Obsługa ReactZa pomocą komponentu opakowującegoZa pomocą wrapperaNatywnyDowolny framework@mux/mux-player-react
Najlepsze dlaKontrola, wtyczki, streamingSzybki i przejrzysty interfejs od razu po instalacjiMieszane adresy URL w ReactHLS w Chrome, Firefox i EdgeZespoły w Mux

Video.js

Video.js to sprawdzony, open source’owy odtwarzacz wideo. Opakowuje element wideo HTML5 w spójny, konfigurowalny interfejs i udostępnia system wtyczek, który obejmuje wszystko — od wyboru jakości po analitykę i reklamy. Wbudowany silnik strumieniowania (VHS) obsługuje HLS i DASH, więc do adaptacyjnego strumieniowania rzadko potrzebujesz dodatkowych bibliotek. Odtwarzanie HLS w Video.js działa od razu po instalacji.

Zainstaluj i skonfiguruj

npm install video.js
import videojs from "video.js";
import "video.js/dist/video-js.css";

const player = videojs("my-video", {
  controls: true,
  fluid: true,
  sources: [{ src: "https://example.com/stream.m3u8", type: "application/x-mpegURL" }]
});
<video id="my-video" class="video-js" playsinline></video>

Video.js z React

To standardowy wzorzec Video.js w React. Utwórz odtwarzacz w efekcie i zwolnij jego zasoby przy odmontowaniu komponentu — w przeciwnym razie po zmianie trasy odtwarzacze będą nadal działać w pamięci.

import { useEffect, useRef } from "react";
import videojs from "video.js";
import "video.js/dist/video-js.css";

export function Player({ src }: { src: string }) {
  const ref = useRef<HTMLVideoElement>(null);
  useEffect(() => {
    const player = videojs(ref.current!, { controls: true, fluid: true, sources: [{ src }] });
    return () => player.dispose();
  }, [src]);
  return <video ref={ref} className="video-js" />;
}

Skórki i motywy

Video.js zawiera domyślny motyw, który możesz dostosować za pomocą CSS. Oficjalne i społecznościowe motywy oraz wtyczki, np. do obsługi playlist czy menu jakości, pozwalają zmienić wygląd odtwarzacza bez przebudowywania jego elementów sterujących. Jeśli zależy Ci na odtwarzaczu dopasowanym do identyfikacji wizualnej marki, uwzględnij czas na pracę z CSS — Video.js udostępnia wszystkie potrzebne opcje, ale dopracowanie wyglądu należy do Ciebie.

Kiedy wybrać Video.js

  • Przesyłasz strumieniowo HLS lub DASH i chcesz korzystać z jednej biblioteki obsługującej oba formaty.
  • Potrzebujesz wtyczek do analityki, reklam, zmiany jakości i tworzenia playlist.
  • Szukasz dojrzałego projektu z długą historią i dużą społecznością.

Plyr

Odtwarzacz wideo Plyr (często wyszukiwany jako „Plyr JS”) skupia się na jednym: zapewnia estetyczny i dostępny odtwarzacz, który działa od razu po instalacji. Obsługuje wideo i audio HTML5, a także materiały osadzone z YouTube i Vimeo — wszystko w tym samym interfejsie. Wygląd odtwarzacza można dostosować za pomocą niestandardowych właściwości CSS, więc dopasowanie kolorów do marki zajmuje zaledwie kilka minut. Plyr nie obsługuje samodzielnie strumieniowania HLS — w tym celu połącz go z hls.js.

Zainstaluj i skonfiguruj

npm install plyr
import Plyr from "plyr";
import "plyr/dist/plyr.css";

const player = new Plyr("#player", {
  controls: ["play-large", "play", "progress", "current-time", "mute", "volume", "captions", "fullscreen"]
});
<video id="player" playsinline controls poster="poster.jpg">
  <source src="clip.mp4" type="video/mp4">
</video>

<!-- or a YouTube video behind the same UI -->
<div id="player" data-plyr-provider="youtube" data-plyr-embed-id="VIDEO_ID"></div>

Plyr z HLS

const video = document.querySelector("video");
const hls = new Hls();
hls.loadSource("https://example.com/stream.m3u8");
hls.attachMedia(video);
const player = new Plyr(video);

Kiedy wybrać Plyr

  • Szukasz nowoczesnego, minimalistycznego odtwarzacza, który dobrze współpracuje z klawiaturą i czytnikami ekranu, a przy tym jest łatwy w konfiguracji.
  • Łączysz własne pliki z materiałami z YouTube lub Vimeo i chcesz zachować spójny interfejs.
  • Nie potrzebujesz rozbudowanego ekosystemu wtyczek.

react-player

react-player (pakiet npm, którego wiele osób szuka po prostu pod hasłem „react player”) to komponent React, który przyjmuje adres URL i automatycznie dobiera sposób odtwarzania: plik MP4, strumień HLS, link do YouTube lub Vimeo i materiały z kilku innych serwisów. Nie zastępuje odtwarzacza danego serwisu — osadza go — ale zapewnia jeden spójny interfejs React do odtwarzania, wstrzymywania, przewijania i nasłuchiwania zdarzeń.

Instalacja i obsługa

npm install react-player
import ReactPlayer from "react-player";

export function Hero() {
  return (
    <ReactPlayer
      url="https://www.youtube.com/watch?v=VIDEO_ID"
      controls
      width="100%"
      height="100%"
    />
  );
}

Uwaga: sprawdź dokumentację zainstalowanej głównej wersji — w nowszych wersjach zmieniono nazwy niektórych właściwości. Zasada pozostaje ta sama: jeden komponent, wiele źródeł.

Kiedy warto wybrać react-player

  • Twoja aplikacja React odtwarza adresy URL z różnych serwisów.
  • Potrzebujesz szybkiego, deklaratywnego API, zamiast tworzyć odtwarzacz od podstaw.
  • Nie przeszkadza Ci, że w komponencie każda usługa ma własny interfejs odtwarzacza.

hls.js

hls.js is a JavaScript library that plays HLS (HTTP Live Streaming) in browsers that don’t support it natively, using Media Source Extensions. It has no UI — you attach it to a <video> element or to a player such as Plyr. Safari plays HLS natively, so you only need hls.js for Chrome, Firefox and Edge.

Zainstaluj i skonfiguruj

npm install hls.js
import Hls from "hls.js";

const video = document.querySelector("video");
const src = "https://example.com/stream.m3u8";

if (Hls.isSupported()) {
  const hls = new Hls();
  hls.loadSource(src);
  hls.attachMedia(video);
} else if (video.canPlayType("application/vnd.apple.mpegurl")) {
  video.src = src; // Safari plays HLS natively
}

Dokumentacja i demo

Projekt hls.js udostępnia dokumentację API oraz demonstracyjną stronę hls.js, na której możesz wkleić adres URL strumienia i sprawdzić poziomy jakości, buforowanie oraz błędy. To przydatne narzędzie do debugowania strumienia, zanim zaczniesz budować wokół niego własne rozwiązanie.

Kiedy wybrać hls.js

  • Masz strumienie HLS i chcesz, by działały wszędzie.
  • Masz już interfejs użytkownika (lub korzystasz z Plyr) i potrzebujesz tylko silnika do streamingu.
  • Chcesz precyzyjnie kontrolować buforowanie i przełączanie jakości.

Mux Player

Jeśli hostujesz wideo w Mux, Mux Player to naturalny wybór: komponent internetowy (dostępny także w wersji dla React), który odtwarza transmisje Mux w adaptacyjnej jakości i przesyła dane o oglądaniu do narzędzi analitycznych Mux. Możesz dostosować jego motyw, a napisy, miniatury i oś czasu są obsługiwane automatycznie. Sprawdzi się gorzej, jeśli Twoje wideo znajduje się w innym miejscu.

npm install @mux/mux-player-react
import MuxPlayer from "@mux/mux-player-react";

<MuxPlayer playbackId="YOUR_PLAYBACK_ID" metadata={{ video_title: "Product demo" }} />

HLS i DASH w dwóch akapitach

HLS i DASH dzielą wideo na krótkie fragmenty w kilku poziomach jakości i opisują je w pliku manifestu (.m3u8 dla HLS, .mpd dla DASH). Odtwarzacz pobiera fragmenty po kolei i wybiera jakość odpowiednią do połączenia widza — to właśnie streaming adaptacyjny. Dzięki niemu długie filmy szybko się uruchamiają i nie zacinają.

Jeśli masz tylko krótkie pliki MP4, nie potrzebujesz żadnego z tych rozwiązań — element wideo HTML5 odtwarza je wszędzie. Streaming przydaje się w przypadku długich nagrań, transmisji na żywo i dużej liczby odbiorców. W takich sytuacjach większość zespołów korzysta z platformy wideo, która koduje strumienie za nich.

Wydajność: jak nie spowolnić swojej witryny

  • Wczytuj odtwarzacze tylko tam, gdzie są potrzebne. Importuj bibliotekę na stronach, na których faktycznie znajdują się filmy. Najlepiej użyj importu dynamicznego, gdy odtwarzacz pojawi się w polu widzenia.
  • Zacznij od miniatury. Wyświetl lekką miniaturę i utwórz odtwarzacz po kliknięciu — to szczególnie ważne na stronach z kilkoma filmami.
  • Zarezerwuj miejsce. Ustaw aspect-ratio kontenera, aby strona nie przeskakiwała podczas ładowania odtwarzacza (Cumulative Layout Shift).
  • W przypadku plików użyj preload="metadata", aby przeglądarka nie pobierała od razu całego filmu.
  • Przesyłaj strumieniowo długie filmy zamiast udostępniać jeden duży plik MP4.

Lista kontrolna dostępności

  • Napisy do wszystkich wypowiedzi w filmie (ścieżki WebVTT).
  • Pełna obsługa klawiaturą: odtwarzanie/wstrzymywanie, przewijanie, regulacja głośności, tryb pełnoekranowy.
  • Widoczne wskaźniki fokusu i etykiety przycisków dla czytników ekranu.
  • Nie odtwarzaj automatycznie z dźwiękiem. W przypadku wideo w tle uwzględnij ustawienie prefers-reduced-motion.

Plyr i Video.js uwzględniają potrzeby osób z niepełnosprawnościami, ale niezależnie od wybranego rozwiązania przetestuj je za pomocą klawiatury i czytnika ekranu — niestandardowe skórki mogą zaburzyć działanie funkcji, które są dostępne w ustawieniach domyślnych.

Poradnik decyzyjny

Jeśli potrzebujesz…Wybierz
Dopracowany domyślny odtwarzacz plików MP4 oraz filmów z YouTube i VimeoPlyr
Wtyczki, skórki, integracja z analityką, HLS i DASH dostępne od rękiVideo.js
Wiele typów adresów URL w aplikacji React przy minimum kodureact-player
HLS w Chrome, Firefox i Edge z własnym interfejsemhls.js
Odtwarzanie i analityka filmów hostowanych w MuxMux Player
Galeria filmów z YouTube, TikToka, Instagrama lub Vimeo na stronie marketingowejWidżet galerii (zobacz poniżej)

Kiedy biblioteka to przerost formy nad treścią

Biblioteki odtwarzaczy dają Ci odtwarzacz. Jeśli potrzebujesz sekcji wideo — z Twoim kanałem YouTube, playlistą poradników czy opiniami klientów z TikToka i Instagrama — musisz samodzielnie stworzyć układ galerii, pobierać filmy z API poszczególnych platform (z użyciem kluczy i limitów), dbać o aktualność materiałów i zapewnić zespołowi możliwość zarządzania nimi.

Galeria wideo Elfsight zrobi to za Ciebie: połącz YouTube, Vimeo, TikTok, Instagram Reels, Twitch lub dowolny link do wideo, wybierz jeden z siedmiu układów i dodaj galerię do dowolnej witryny — albo aplikacji React za pomocą oficjalnego komponentu react-elfsight-widget. Nowe filmy będą pojawiać się automatycznie, odtworzysz je w wyskakującym oknie na stronie, a po każdym z nich możesz wyświetlić kartę z wezwaniem do działania.

Stwórz swoją galerię wideo tutaj ↓

See how it works for React and Next.js.

Najczęściej zadawane pytania

Jaki jest najlepszy open source’owy odtwarzacz wideo?

W przypadku większości witryn warto wybrać Video.js (rozbudowane funkcje, wtyczki i streaming) lub Plyr (lekki odtwarzacz z dopracowanym interfejsem). Wybierz Video.js, jeśli korzystasz ze streamingu HLS/DASH lub potrzebujesz wtyczek. Postaw na Plyr, jeśli zależy Ci na atrakcyjnym wyglądzie bez skomplikowanej konfiguracji.

Czy Video.js jest darmowy?

Tak. Video.js to oprogramowanie open source udostępniane na licencji Apache 2.0.

Czy Plyr może odtwarzać filmy z YouTube i Vimeo?

Tak. Plyr obsługuje osadzone filmy z YouTube i Vimeo, a także wideo i audio w formacie HTML5 — wszystko w tym samym interfejsie.

Czy potrzebuję hls.js do Video.js?

Zazwyczaj nie. Video.js ma własny silnik strumieniowania (VHS) obsługujący HLS i DASH.

Czy w Safari potrzebuję hls.js?

Nie. Safari obsługuje HLS natywnie. hls.js jest przeznaczony dla przeglądarek, które nie obsługują HLS natywnie.

Czy react-player obsługuje HLS?

Tak. W przypadku adresów URL .m3u8 działa w tle biblioteka hls.js.

Jaki odtwarzacz wideo do Reacta jest najlepszy?

react-player do odtwarzania adresów URL z różnych serwisów; Video.js z nakładką React, jeśli potrzebujesz pełnej kontroli i obsługi streamingu; Mux Player React, jeśli korzystasz z Mux.

Czym różni się odtwarzacz wideo od SDK lub API odtwarzacza wideo?

Biblioteka odtwarzacza zapewnia interfejs i funkcje odtwarzania. SDK lub API platformy wideo obsługuje także przesyłanie plików, kodowanie, streaming i analitykę. Jeśli chcesz tylko odtwarzać pliki hostowane już na własnym serwerze, wystarczy biblioteka.

Który odtwarzacz wideo jest najlżejszy?

Spośród kompletnych odtwarzaczy Plyr jest najlżejszy. hls.js zajmuje jeszcze mniej miejsca, ale jest tylko silnikiem do strumieniowania i wymaga dodatkowo elementu wideo lub odtwarzacza.

Jak dodać galerię filmów z YouTube do aplikacji React bez korzystania z biblioteki odtwarzacza?

Skorzystaj z widgetu: utwórz galerię wideo w Elfsight, połącz ją ze swoim kanałem lub playlistą i wyświetl za pomocą react-elfsight-widget. Bez kluczy API i kodu odtwarzacza.
Autor artykułu
Kierownik ds. marketingu
Nazywam się Andrei Kozinskiy, specjalista ds. marketingu w Elfsight. Odpowiadam za napędzanie wzrostu użytkowników poprzez treści i różnorodne kanały ruchu. Lubię dzielić się spostrzeżeniami i doświadczeniami, które pomagają innym odnieść sukces.