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.
- 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:
- Odtwarzaj własne pliki MP4 w bardziej dopracowanym interfejsie niż domyślny odtwarzacz przeglądarki — skorzystaj z Plyr lub Video.js.
- 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).
- 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.
- 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.js | Plyr | react-player | hls.js | Mux Player | |
|---|---|---|---|---|---|
| Co to jest | Pełny framework odtwarzacza | Lekki interfejs odtwarzacza | Wrapper Reacta dla wielu źródeł | Silnik streamingu HLS (bez interfejsu) | Odtwarzacz wideo hostowanego w Mux |
| Licencja | Apache 2.0 | MIT | MIT | Apache 2.0 | MIT |
| Pliki wideo HTML5 | Tak | Tak | Tak | Za pomocą elementu wideo | Zasoby Mux |
| YouTube / Vimeo | Za pomocą wtyczek | Wbudowane | Wbudowane | Nie | Nie |
| HLS | Wbudowany (VHS) | Z hls.js | Używa hls.js dla plików .m3u8 | Tak — taki jest jego cel | Tak |
| PULPIT | Wbudowany (VHS) | Z biblioteką DASH | Za pomocą wtyczki odtwarzacza plików | Nie | — |
| Napisy | Tak | Tak | Zależy od źródła | Obsługuje je Twój odtwarzacz | Tak |
| Skórki / motywy | Skórki CSS, motywy, wtyczki | Zmienne CSS | Interfejs samego źródła | — | Zmienne CSS, motywy |
| Obsługa React | Za pomocą komponentu opakowującego | Za pomocą wrappera | Natywny | Dowolny framework | @mux/mux-player-react |
| Najlepsze dla | Kontrola, wtyczki, streaming | Szybki i przejrzysty interfejs od razu po instalacji | Mieszane adresy URL w React | HLS w Chrome, Firefox i Edge | Zespoł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-ratiokontenera, 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 Vimeo | Plyr |
| Wtyczki, skórki, integracja z analityką, HLS i DASH dostępne od ręki | Video.js |
| Wiele typów adresów URL w aplikacji React przy minimum kodu | react-player |
| HLS w Chrome, Firefox i Edge z własnym interfejsem | hls.js |
| Odtwarzanie i analityka filmów hostowanych w Mux | Mux Player |
| Galeria filmów z YouTube, TikToka, Instagrama lub Vimeo na stronie marketingowej | Widż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.

