Sitenizde veya uygulamanızda videoya ihtiyacınız var ve sürekli karşınıza dört isim çıkıyor: Video.js, Plyr, react-player ve hls.js. Mux üzerinden yayın yapıyorsanız listeye Mux Player da ekleniyor. Hepsi popüler ve açık kaynaklı olsa da farklı ihtiyaçlara çözüm sunuyor.
Bu rehber, her birinin ne olduğunu açıklar, gerekli temel kurulum kodunu gösterir, seçenekleri yan yana karşılaştırır ve size en uygun olanı seçmenize, hatta bir kütüphaneye hiç ihtiyacınız olmadığına karar vermenize yardımcı olur.
- Video.js; geniş eklenti ekosistemi, temaları ve yerleşik HLS/DASH oynatma desteğiyle kapsamlı bir oynatıcı altyapısıdır. Kontrol ve esneklik arıyorsanız ideal seçimdir.
- Plyr; HTML5 videoları, YouTube ve Vimeo için hafif, şık ve erişilebilir bir varsayılan arayüze sahip oynatıcıdır. Hızlıca şık görünen bir oynatıcı eklemek istediğinizde idealdir.
- react-player — dosyalar, YouTube, Vimeo ve daha fazlası gibi farklı URL türlerini tek bir API üzerinden oynatan bir React bileşenidir. Farklı kaynakları kullanan React uygulamaları için idealdir.
- hls.js, bir oynatıcı arayüzü değil, yerel HLS desteği olmayan tarayıcılarda HLS oynatmayı sağlayan bir akış motorudur. HLS desteği için video etiketiyle veya bir oynatıcıyla birlikte kullanın.
- Mux Player — Mux’ta barındırılan videolar için geliştirilmiş, yerleşik analiz özelliklerine sahip bir oynatıcı. Video platformunuz Mux ise sizin için ideal.
- Pazarlama sayfalarınızda YouTube, TikTok veya Instagram videolarından oluşan bir galeri sunmak istiyorsanız, hazır bir widget genellikle herhangi bir kütüphaneden daha hızlı bir çözümdür.
Hangi sorunu çözüyorsunuz?
Özellikleri karşılaştırmadan önce neye ihtiyacınız olduğunu netleştirin. Ekiplerin çoğu şu dört durumdan birinde olur:
- Kendi MP4 dosyalarınızı tarayıcının varsayılan oynatıcısından daha şık bir arayüzle oynatın — Plyr veya Video.js kullanın.
- Uzun videoları veya canlı yayınları uyarlanabilir kaliteyle (HLS/DASH) izletin: Video.js, kendi arayüzünüzle hls.js ya da video platformunuzun oynatıcısı (ör. Mux Player).
- React uygulamasında farklı hizmetlerden video URL’leri oynatın — bugün YouTube, yarın bir Vimeo bağlantısı, gelecek hafta bir MP4 — react-player.
- YouTube, TikTok veya Instagram’daki çok sayıda videoyu web sitenizde galeri olarak sergilemek, oynatıcıyla değil içerik ve düzenle ilgili bir konudur (son bölüme göz atın).
Kütüphanelere genel bakış
| Video.js | Plyr | react-player | hls.js | Mux Player | |
|---|---|---|---|---|---|
| Nedir? | Eksiksiz oynatıcı altyapısı | Hafif oynatıcı arayüzü | Birçok kaynak için React sarmalayıcısı | HLS yayın akışı motoru (arayüzsüz) | Mux’ta barındırılan videolar için oynatıcı |
| Lisans | Apache 2.0 | MIT | MIT | Apache 2.0 | MIT |
| HTML5 video dosyaları | Evet | Evet | Evet | Video öğesi üzerinden | Mux varlıkları |
| YouTube / Vimeo | Eklentilerle | Dahili | Dahili | Hayır | Hayır |
| HLS | Dahili (VHS) | hls.js ile | .m3u8 için hls.js kullanır | Evet — amacı bu | Evet |
| DASH | Dahili (VHS) | DASH kütüphanesiyle | Dosya oynatıcı eklentisiyle | Hayır | — |
| Altyazılar | Evet | Evet | Kaynağa bağlıdır | Bunları oynatıcınız halleder | Evet |
| Görünüm / tema | CSS görünümleri, temalar, eklentiler | CSS değişkenleri | Source’un kendi arayüzü | — | CSS değişkenleri, temalar |
| React desteği | Bir sarmalayıcı bileşen aracılığıyla | Bir sarmalayıcı üzerinden | Yerel | Herhangi bir framework | @mux/mux-player-react |
| En İyisi İçin | Kontrol, eklentiler, yayın akışı | Hızlı ve sade varsayılan arayüz | React’te Karışık URL’ler | Chrome/Firefox/Edge’de HLS | Mux’taki Ekipler |
Video.js
Video.js, açık kaynaklı video oynatıcıların en köklülerinden biridir. HTML5 video öğesini tutarlı ve özelleştirilebilir bir arayüzle sunar; kalite seçicilerden analiz ve reklamlara kadar pek çok özelliği kapsayan bir eklenti sistemi ekler. Yerleşik yayın motoru (VHS) hem HLS hem de DASH’i oynatır. Bu sayede uyarlanabilir yayın için nadiren ek kütüphanelere ihtiyaç duyarsınız; Video.js ile HLS oynatma, ek ayar gerektirmeden çalışır.
Yükleyin ve kurulumu tamamlayın
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>
React ile Video.js
Bu, Video.js’in React’teki standart kullanım biçimidir. Oynatıcıyı bir effect içinde oluşturun ve bileşen kaldırıldığında dispose edin — aksi halde sayfalar arasında geçiş yaptığınızda oynatıcılar bellekte çalışmaya devam eder.
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" />;
}
Görünümler ve temalar
Video.js, CSS ile görünümünü özelleştirebileceğiniz varsayılan bir temayla gelir. Resmî ve topluluk tarafından geliştirilen temalar ile oynatma listeleri veya kalite menüleri gibi özellikler sunan eklentiler, kontrolleri baştan oluşturmadan oynatıcının görünümünü değiştirmenizi sağlar. Markanıza özel bir oynatıcı istiyorsanız CSS üzerinde çalışmak için zaman ayırın. Video.js özelleştirme için gereken tüm araçları sunar; son dokunuşlar ise size kalır.
Video.js’i Ne Zaman Tercih Etmeli?
- Hem HLS hem de DASH yayınlıyor, ikisini de destekleyen tek bir kütüphane mi arıyorsunuz?
- Analiz, reklam, kalite seçimi ve oynatma listeleri için eklentilere ihtiyacınız var.
- Uzun süredir faaliyet gösteren ve geniş bir topluluğa sahip, köklü bir proje arıyorsunuz.
Plyr
Plyr video oynatıcı (genellikle “Plyr JS” adıyla aranır), tek bir şeye odaklanır: kutudan çıktığı gibi çalışan, şık ve erişilebilir bir oynatıcı sunmaya. Aynı arayüz üzerinden HTML5 video ve sesin yanı sıra YouTube ve Vimeo gömülü videolarını da destekler. CSS özel özellikleri sayesinde marka renklerinizi eşleştirmek yalnızca birkaç dakikanızı alır. Plyr, HLS yayınını tek başına desteklemez; bunun için hls.js ile birlikte kullanabilirsiniz.
Yükleyin ve kurulumu tamamlayın
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>
HLS ile Plyr
const video = document.querySelector("video");
const hls = new Hls();
hls.loadSource("https://example.com/stream.m3u8");
hls.attachMedia(video);
const player = new Plyr(video);
Plyr’ı ne zaman tercih etmeli?
- Klavye ve ekran okuyucu desteği güçlü, kurulumu kolay, sade ve modern bir oynatıcı arıyorsunuz.
- Kendi dosyalarınızın yanı sıra YouTube veya Vimeo videoları kullanıyor ve hepsinde tutarlı bir arayüz sunmak istiyorsunuz.
- Geniş bir eklenti ekosistemine ihtiyacınız yok.
react-player
react-player (pek çok kişinin yalnızca “react player” diye aradığı npm paketi), bir URL alıp içeriğin nasıl oynatılacağını belirleyen bir React bileşenidir: MP4 dosyası, HLS yayını, YouTube veya Vimeo bağlantısı ve diğer birçok hizmet. Her hizmetin oynatıcısının yerini almaz; onu sayfanıza gömer. Böylece oynatma, duraklatma, ileri-geri sarma ve etkinlikleri dinleme için tek ve tutarlı bir React API’si sunar.
Yükleyin ve kullanın
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%"
/>
);
}
Not: Yüklediğiniz ana sürümün belgelerini inceleyin; son sürümlerde bazı prop adları değişti. Temel mantık aynı: Tek bileşen, birçok kaynak.
react-player’ı ne zaman tercih etmeli?
- React uygulamanız, farklı hizmetlerdeki URL’leri oynatır.
- Bir oynatıcı oluşturmak yerine hızlı ve bildirimsel bir API kullanmak istiyorsunuz.
- Bileşen içinde her hizmetin kendi oynatıcı arayüzünü kullanması sizin için sorun değil.
hls.js
hls.js, yerel olarak HLS’yi (HTTP Canlı Yayın) desteklemeyen tarayıcılarda Media Source Extensions kullanarak HLS oynatan bir JavaScript kütüphanesidir. Kullanıcı arayüzü yoktur; kütüphaneyi bir <video> öğesine veya Plyr gibi bir oynatıcıya bağlamanız gerekir. Safari HLS’yi yerel olarak oynattığından hls.js’yi yalnızca Chrome, Firefox ve Edge için kullanmanız gerekir.
Yükleyin ve kurulumu tamamlayın
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
}
Dokümantasyon ve demo
hls.js projesinde API belgeleri ve canlı bir hls.js demo sayfası bulunur. Bu sayfada bir yayın URL’si girerek kalite düzeylerini, arabelleğe almayı ve hataları inceleyebilirsiniz. Böylece yayınınızı, üzerine herhangi bir şey kurmadan önce hata ayıklamak kolaylaşır.
hls.js ne zaman tercih edilmeli?
- HLS yayınlarınız var ve bunların her yerde oynatılmasını istiyorsunuz.
- Zaten bir arayüzünüz var (veya Plyr kullanıyorsunuz) ve yalnızca yayın akışı motoruna ihtiyacınız var.
- Ön yükleme ve kalite geçişleri üzerinde hassas kontrol istiyorsunuz.
Mux Player
Videolarınızı Mux’ta barındırıyorsanız Mux Player doğal bir seçimdir: Mux yayınlarını uyarlanabilir kaliteyle oynatan ve izlenme verilerini Mux analizlerine gönderen bir web bileşenidir (React sürümü de bulunur). Temasını özelleştirebilir; altyazıları, küçük resimleri ve zaman çizelgelerini sizin için yönetir. Videolarınız başka bir yerde barındırılıyorsa o kadar kullanışlı olmayabilir.
npm install @mux/mux-player-react
import MuxPlayer from "@mux/mux-player-react";
<MuxPlayer playbackId="YOUR_PLAYBACK_ID" metadata={{ video_title: "Product demo" }} />
HLS ve DASH iki paragrafta
HLS ve DASH, videoyu farklı kalite düzeylerinde kısa parçalara böler ve bu parçaları bir manifest dosyasında tanımlar (HLS için .m3u8, DASH için .mpd). Oynatıcı parçaları sırayla indirir ve izleyicinin bağlantı hızına uygun kaliteyi seçer. Uyarlanabilir yayın olarak bilinen bu yöntem, uzun videoların hızla başlamasını ve takılmadan oynatılmasını sağlar.
Yalnızca kısa MP4 dosyalarınız varsa bunların hiçbirine ihtiyacınız yok: HTML5 video öğesi bu dosyaları her yerde oynatır. Uzun videolar, canlı yayınlar ve geniş kitleler söz konusu olduğunda ise akış teknolojisi önem kazanır. Bu durumlarda çoğu ekip, akışları kendi adına kodlayan bir video platformu kullanır.
Performans: Sitenizi yavaşlatmamak için ipuçları
- Oynatıcıları yalnızca gerektiğinde yükleyin. Kitaplığı yalnızca video içeren sayfalara ekleyin. İdeal olarak, oynatıcı ekranda görünür hâle geldiğinde dinamik olarak yükleyin.
- Önce bir poster görseli kullanın. Hafif bir küçük resim gösterin ve oynatıcıyı tıklamayla oluşturun. Bu, özellikle sayfada birden fazla video varsa performansı artırır.
- Yer ayırın. Oynatıcı yüklenirken sayfanın kaymasını önlemek (Kümülatif Düzen Kayması) için kapsayıcıya
aspect-ratioekleyin. - Dosyalar için
preload="metadata"kullanın; böylece tarayıcı videonun tamamını baştan indirmez. - Tek bir büyük MP4 sunmak yerine uzun videoları akış üzerinden yayınlayın.
Erişilebilirlik kontrol listesi
- Konuşma içeren her video için altyazı (WebVTT izleri).
- Tam klavye kontrolü: oynat/duraklat, ileri-geri sarma, ses ve tam ekran.
- Ekran okuyucular için görünür odak durumları ve etiketli butonlar.
- Sesli otomatik oynatma kullanmayın; arka plan videosunda
prefers-reduced-motionayarını dikkate alın.
Plyr ve Video.js, erişilebilirliği önemsiyor. Yine de her iki oynatıcıyı da klavye ve ekran okuyucuyla test edin; özel görünümler, varsayılan ayarların sağladığı erişilebilirliği bozabilir.
Karar rehberi
| İhtiyacınız varsa… | Seçin |
|---|---|
| MP4, YouTube ve Vimeo için şık bir varsayılan oynatıcı | Plyr |
| Eklentiler, temalar, analiz araçları ve HLS ile DASH desteği standart olarak sunulur | Video.js |
| React uygulamasında minimum kodla birçok URL türü | react-player |
| Kendi arayüzünüzle Chrome, Firefox ve Edge’de HLS | hls.js |
| Mux’ta barındırılan videolar için oynatma ve analiz | Mux Player |
| Pazarlama sayfasında YouTube, TikTok, Instagram veya Vimeo videolarından oluşan bir galeri | Bir galeri widget’ı (aşağıya bakın) |
Bir kütüphanenin gereğinden fazla olduğu durumlar
Oynatıcı kütüphaneleri size bir oynatıcı sunar. Ancak ihtiyacınız olan şey bir video bölümü ise — YouTube kanalınız, eğitim videolarından oluşan bir oynatma listesi ya da TikTok ve Instagram’daki müşteri yorumları gibi — galeri düzenlerini yine kendiniz oluşturmanız, her platformun API’sinden videoları (anahtarlar ve kullanım kotalarıyla) almanız, akışı güncel tutmanız ve ekibinize içerikleri yönetme olanağı sunmanız gerekir.
Elfsight Video Galerisi tüm işi sizin yerinize yapar: YouTube, Vimeo, TikTok, Instagram Reels, Twitch veya herhangi bir video bağlantısını ekleyin, yedi düzenden birini seçin ve istediğiniz web sitesine ya da resmi react-elfsight-widget bileşeniyle bir React uygulamasına ekleyin. Yeni videolar otomatik olarak görünür, sayfanızda açılır pencerede oynatılır ve her videonun ardından harekete geçirici mesaj kartı gösterebilirsiniz.
Video galeriniz hemen aşağıda ↓
React ve Next.js ile nasıl çalıştığını görün.

