Anda memerlukan video di situs atau aplikasi, dan ada empat nama yang sering disebut: Video.js, Plyr, react-player, dan hls.js — serta Mux Player jika Anda melakukan streaming dari Mux. Semuanya populer dan bersumber terbuka, tetapi masing-masing dirancang untuk kebutuhan yang berbeda.
Panduan ini menjelaskan fungsi masing-masing, menunjukkan kode penyiapan minimal, membandingkannya secara berdampingan, dan membantu Anda memilih yang tepat—atau memutuskan bahwa Anda tidak memerlukan pustaka sama sekali.
- Video.js adalah kerangka pemutar lengkap dengan ekosistem plugin yang luas, beragam tampilan, serta pemutaran HLS/DASH bawaan. Pilihan tepat jika Anda membutuhkan kendali dan fleksibilitas.
- Plyr — pemutar ringan dengan UI bawaan yang elegan dan mudah diakses untuk video HTML5, YouTube, dan Vimeo. Pilihan tepat jika Anda ingin pemutar yang menarik dengan cepat.
- react-player — komponen React yang dapat memutar berbagai jenis URL (berkas, YouTube, Vimeo, dan lainnya) melalui satu API. Cocok untuk aplikasi React yang menggunakan beragam sumber.
- hls.js — bukan antarmuka pemutar, melainkan mesin streaming yang menghadirkan pemutaran HLS di browser tanpa dukungan bawaan. Padukan dengan tag video atau pemutar.
- Mux Player — pemutar untuk video yang dihosting di Mux, lengkap dengan analitik bawaan. Pilihan terbaik jika Mux adalah platform video Anda.
- Jika Anda ingin menampilkan galeri video YouTube, TikTok, atau Instagram di halaman pemasaran, widget siap pakai biasanya lebih cepat daripada menggunakan library apa pun.
Masalah apa yang ingin Anda atasi?
Sebelum membandingkan fitur, tentukan dulu kebutuhan Anda. Sebagian besar tim menghadapi salah satu dari empat situasi berikut:
- Putar file MP4 Anda sendiri dengan antarmuka yang lebih menarik daripada pemutar bawaan browser — gunakan Plyr atau Video.js.
- Streaming video berdurasi panjang atau siaran langsung dengan kualitas adaptif (HLS/DASH) — gunakan Video.js, hls.js dengan UI buatan sendiri, atau pemutar dari platform video Anda (misalnya Mux Player).
- Putar URL dari berbagai layanan di aplikasi React — YouTube hari ini, tautan Vimeo besok, MP4 minggu depan — react-player.
- Menampilkan banyak video dari YouTube, TikTok, atau Instagram sebagai galeri di situs web bukanlah masalah pemutar video, melainkan masalah konten dan tata letak (lihat bagian terakhir).
Sekilas tentang perpustakaan
| Video.js | Plyr | react-player | hls.js | Mux Player | |
|---|---|---|---|---|---|
| Apa itu | Kerangka pemutar lengkap | Antarmuka pemutar yang ringan | Wrapper React untuk berbagai sumber | Mesin streaming HLS (tanpa UI) | Pemutar video yang dihosting di Mux |
| Lisensi | Apache 2.0 | MIT | MIT | Apache 2.0 | MIT |
| Berkas video HTML5 | Ya | Ya | Ya | Melalui elemen video | Aset Mux |
| YouTube / Vimeo | Melalui plugin | Bawaan | Bawaan | Tidak | Tidak |
| HLS | Bawaan (VHS) | Dengan hls.js | Menggunakan hls.js untuk .m3u8 | Ya — itulah tujuannya | Ya |
| DASH | Bawaan (VHS) | Dengan pustaka DASH | Melalui plugin pemutar berkas | Tidak | — |
| Takarir | Ya | Ya | Tergantung sumber | Pemutar Anda akan menanganinya | Ya |
| Tampilan / tema | Skin, tema, dan plugin CSS | Variabel CSS | UI bawaan sumber | — | Variabel CSS, tema |
| Dukungan React | Melalui komponen pembungkus | Melalui wrapper | Native | Framework apa pun | @mux/mux-player-react |
| Terbaik untuk | Kontrol, plugin, streaming | Antarmuka bawaan yang cepat dan rapi | URL Campuran di React | HLS di Chrome/Firefox/Edge | Tim di Mux |
Video.js
Video.js adalah pemain lama di dunia pemutar video open source. Video.js membungkus elemen video HTML5 dalam UI yang konsisten dan dapat disesuaikan, serta menyediakan sistem plugin untuk berbagai kebutuhan, mulai dari pemilih kualitas hingga analitik dan iklan. Mesin streaming bawaannya (VHS) mendukung HLS dan DASH, jadi Anda jarang memerlukan pustaka tambahan untuk streaming adaptif—pemutaran HLS di Video.js langsung berfungsi.
Instal dan siapkan
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 dengan React
Ini adalah pola standar Video.js di React. Buat pemutar di dalam effect dan hapus saat komponen di-unmount — jika tidak, pemutar akan tetap berjalan di memori saat pengguna berpindah rute.
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" />;
}
Skin dan tema
Video.js dilengkapi tampilan bawaan yang dapat Anda sesuaikan dengan CSS. Tema resmi dan komunitas (serta plugin untuk fitur seperti daftar putar atau menu kualitas) memungkinkan Anda mengubah tampilannya tanpa perlu membuat ulang kontrol. Jika Anda menginginkan pemutar dengan identitas merek yang kuat, sisihkan waktu untuk mengolah CSS—Video.js menyediakan semua yang Anda perlukan, tetapi hasil akhirnya bergantung pada sentuhan Anda.
Kapan sebaiknya memilih Video.js
- Anda menyiarkan HLS atau DASH dan ingin menggunakan satu pustaka yang mendukung keduanya.
- Anda memerlukan plugin untuk analitik, iklan, pergantian kualitas, dan daftar putar.
- Anda menginginkan proyek yang sudah matang, berpengalaman, dan didukung komunitas besar.
Plyr
Pemutar video Plyr (sering dicari dengan kata kunci “Plyr JS”) berfokus pada satu hal: menghadirkan pemutar yang menarik dan mudah diakses, serta bisa langsung digunakan. Pemutar ini mendukung video dan audio HTML5, serta video sematan dari YouTube dan Vimeo dalam antarmuka yang sama. Tampilannya diatur dengan properti kustom CSS, jadi Anda hanya perlu beberapa menit untuk menyesuaikan warna dengan merek Anda. Plyr tidak dapat memutar streaming HLS tanpa bantuan—pasangkan dengan hls.js untuk itu.
Instal dan siapkan
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 dengan 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);
Kapan sebaiknya memilih Plyr
- Anda menginginkan pemutar yang simpel dan modern, mendukung keyboard serta pembaca layar dengan baik, dan mudah disiapkan.
- Anda menggabungkan file sendiri dengan video YouTube atau Vimeo dan ingin semuanya tampil dengan UI yang konsisten.
- Anda tidak memerlukan ekosistem plugin yang besar.
react-player
react-player (paket npm yang banyak dicari dengan nama “react player”) adalah komponen React yang menerima URL dan menentukan cara memutarnya: file MP4, stream HLS, tautan YouTube atau Vimeo, serta beberapa layanan lainnya. Komponen ini tidak menggantikan pemutar dari setiap layanan—melainkan menyematkannya—sehingga Anda dapat menggunakan satu API React yang konsisten untuk memutar, menjeda, berpindah ke bagian tertentu, dan mendengarkan event.
Instal dan gunakan
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%"
/>
);
}
Catatan: periksa dokumentasi untuk versi mayor yang Anda instal — beberapa properti berganti nama di versi terbaru. Prinsipnya tetap sama: satu komponen, banyak sumber.
Kapan memilih react-player
- Aplikasi React Anda memutar URL dari berbagai layanan.
- Anda membutuhkan API deklaratif yang praktis, bukan harus membuat pemutar sendiri.
- Anda tidak keberatan menggunakan tampilan pemutar bawaan masing-masing layanan di dalam komponen.
hls.js
hls.js adalah library JavaScript yang memutar HLS (HTTP Live Streaming) di browser yang tidak mendukungnya secara bawaan, dengan menggunakan Media Source Extensions. Library ini tidak memiliki UI — Anda dapat menghubungkannya ke elemen <video> atau pemutar seperti Plyr. Safari mendukung pemutaran HLS secara bawaan, jadi hls.js hanya diperlukan untuk Chrome, Firefox, dan Edge.
Instal dan siapkan
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
}
Dokumentasi dan demo
Proyek hls.js menyediakan dokumentasi API dan halaman demo hls.js langsung. Anda bisa menempelkan URL streaming untuk memeriksa tingkat kualitas, buffering, dan error — berguna untuk men-debug streaming sebelum membangun fitur apa pun.
Kapan sebaiknya memilih hls.js
- Anda punya streaming HLS dan ingin memutarnya di semua platform.
- Anda sudah memiliki UI (atau menggunakan Plyr) dan hanya memerlukan mesin streaming.
- Anda ingin mengontrol buffering dan pergantian kualitas dengan lebih presisi.
Mux Player
Jika Anda menghosting video di Mux, Mux Player adalah pilihan yang tepat: komponen web (dengan versi React) yang memutar streaming Mux dengan kualitas adaptif dan mengirimkan data penayangan ke analitik Mux. Tampilan pemutar bisa disesuaikan, dan fitur teks, thumbnail, serta linimasa sudah tersedia. Namun, pemutar ini kurang berguna jika video Anda dihosting di platform lain.
npm install @mux/mux-player-react
import MuxPlayer from "@mux/mux-player-react";
<MuxPlayer playbackId="YOUR_PLAYBACK_ID" metadata={{ video_title: "Product demo" }} />
HLS dan DASH dalam Dua Paragraf
HLS dan DASH membagi video menjadi segmen-segmen pendek dengan beberapa tingkat kualitas, lalu menjelaskannya dalam file manifes (.m3u8 untuk HLS, .mpd untuk DASH). Pemutar mengunduh segmen satu per satu dan memilih kualitas yang sesuai dengan koneksi penonton. Inilah yang disebut streaming adaptif, yang membuat video berdurasi panjang cepat dimulai dan tidak tersendat.
Jika Anda hanya memiliki file MP4 berdurasi pendek, Anda tidak memerlukan semua ini: elemen video HTML5 dapat memutarnya di mana saja. Streaming diperlukan untuk video berdurasi panjang, siaran langsung, dan audiens yang besar—untuk kebutuhan tersebut, kebanyakan tim menggunakan platform video yang menangani proses encoding.
Performa: cara menjaga situs tetap cepat
- Muat pemutar hanya saat diperlukan. Impor pustaka di halaman yang benar-benar memuat video. Idealnya, gunakan impor dinamis saat pemutar masuk ke area tampilan.
- Mulai dengan poster. Tampilkan gambar mini yang ringan dan buat pemutar saat diklik—terutama jika halaman memuat beberapa video.
- Sediakan ruang. Atur
aspect-ratiopada kontainer agar halaman tidak bergeser saat pemutar dimuat (Cumulative Layout Shift). - Gunakan
preload="metadata"pada file agar browser tidak mengunduh seluruh video sekaligus. - Streaming video berdurasi panjang, alih-alih mengunggah satu file MP4 berukuran besar.
Daftar Periksa Aksesibilitas
- Teks takarir untuk setiap video yang berisi percakapan (track WebVTT).
- Kontrol keyboard penuh: putar/jeda, geser posisi, atur volume, dan layar penuh.
- Status fokus yang terlihat dan tombol berlabel untuk pembaca layar.
- Jangan putar video latar secara otomatis dengan suara; hormati pengaturan
prefers-reduced-motion.
Plyr dan Video.js sama-sama memperhatikan aksesibilitas. Namun, tetap uji dengan keyboard dan pembaca layar karena skin kustom dapat mengganggu fitur bawaan yang sudah berfungsi dengan baik.
Panduan pengambilan keputusan
| Jika Anda perlu… | Pilih |
|---|---|
| Pemutar bawaan yang rapi untuk MP4, YouTube, dan Vimeo | Plyr |
| Plugin, skin, hook analitik, HLS, dan DASH tersedia langsung | Video.js |
| Berbagai jenis URL di aplikasi React dengan kode minimal | react-player |
| HLS di Chrome, Firefox, dan Edge dengan UI Anda sendiri | hls.js |
| Pemutaran dan analitik untuk video yang dihosting di Mux | Mux Player |
| Galeri video YouTube, TikTok, Instagram, atau Vimeo di halaman pemasaran | Widget galeri (lihat di bawah) |
Saat pustaka terlalu berlebihan
Pustaka pemutar memberi Anda sebuah pemutar. Jika yang sebenarnya Anda butuhkan adalah bagian video—seperti kanal YouTube, daftar putar tutorial, atau testimoni pelanggan dari TikTok dan Instagram—Anda tetap harus membuat tata letak galeri, mengambil video dari API tiap platform (beserta kunci dan kuotanya), memperbarui umpan, serta menyediakan cara bagi tim Anda untuk mengelolanya.
Galeri Video Elfsight mengurus semuanya untuk Anda: hubungkan YouTube, Vimeo, TikTok, Instagram Reels, Twitch, atau tautan video apa pun, pilih salah satu dari tujuh tata letak, lalu tambahkan ke website mana pun—atau ke aplikasi React dengan komponen resmi react-elfsight-widget. Video baru akan muncul otomatis, video terbuka dalam popup di halaman Anda, dan Anda bisa menampilkan kartu ajakan bertindak setelah setiap video.
Buat galeri video Anda di sini ↓
Lihat cara kerjanya di React dan Next.js.

