Dil:

Video.js, Plyr, react-player ve hls.js karşılaştırması: Hangi video oynatıcı kütüphanesini seçmelisiniz?

Video.js, Plyr, react-player, hls.js veya Mux Player mı? Her bir kütüphanenin ne işe yaradığını görün, kurulum kodlarını ve özelliklerini yan yana karşılaştırın; siteniz veya uygulamanız için doğru olanı seçin ya da hiç kütüphane kullanmayın.
ChatGPT’nin değerlendirmesini görün

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.

Öne çıkanlar



  • 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:

  1. 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.
  2. 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).
  3. 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.
  4. 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.jsPlyrreact-playerhls.jsMux 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ı
LisansApache 2.0MITMITApache 2.0MIT
HTML5 video dosyalarıEvetEvetEvetVideo öğesi üzerindenMux varlıkları
YouTube / VimeoEklentilerleDahiliDahiliHayırHayır
HLSDahili (VHS)hls.js ile.m3u8 için hls.js kullanırEvet — amacı buEvet
DASHDahili (VHS)DASH kütüphanesiyleDosya oynatıcı eklentisiyleHayır—
AltyazılarEvetEvetKaynağa bağlıdırBunları oynatıcınız hallederEvet
Görünüm / temaCSS görünümleri, temalar, eklentilerCSS değişkenleriSource’un kendi arayüzü—CSS değişkenleri, temalar
React desteğiBir sarmalayıcı bileşen aracılığıylaBir sarmalayıcı üzerindenYerelHerhangi bir framework@mux/mux-player-react
En İyisi İçinKontrol, eklentiler, yayın akışıHızlı ve sade varsayılan arayüzReact’te Karışık URL’lerChrome/Firefox/Edge’de HLSMux’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-ratio ekleyin.
  • 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-motion ayarı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 sunulurVideo.js
React uygulamasında minimum kodla birçok URL türüreact-player
Kendi arayüzünüzle Chrome, Firefox ve Edge’de HLShls.js
Mux’ta barındırılan videolar için oynatma ve analizMux Player
Pazarlama sayfasında YouTube, TikTok, Instagram veya Vimeo videolarından oluşan bir galeriBir 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.

Sık Sorulan Sorular

En iyi açık kaynaklı video oynatıcı hangisi?

Çoğu web sitesi için Video.js (kapsamlı özellikler, eklentiler ve yayın akışı) veya Plyr (hafif ve şık arayüz) uygundur. HLS/DASH yayını yapıyor ya da eklentilere ihtiyaç duyuyorsanız Video.js’i; kurulumu kolay, varsayılan görünümüyle etkileyici bir seçenek arıyorsanız Plyr’ı tercih edin.

Video.js ücretsiz mi?

Evet. Video.js, Apache 2.0 lisansı kapsamında açık kaynaklıdır.

Plyr, YouTube ve Vimeo videolarını oynatabilir mi?

Evet. Plyr, YouTube ve Vimeo yerleştirmelerinin yanı sıra HTML5 video ve ses dosyalarını da aynı arayüz üzerinden destekler.

Video.js ile birlikte hls.js kullanmam gerekir mi?

Genellikle gerekmez. Video.js, HLS ve DASH için kendi yayın motorunu (VHS) içerir.

Safari’de hls.js kullanmam gerekir mi?

Hayır. Safari, HLS’i yerel olarak oynatır. hls.js, yerel HLS desteği olmayan tarayıcılar içindir.

react-player HLS’yi destekliyor mu?

Evet. .m3u8 URL’leri için arka planda hls.js kullanılır.

En iyi React video oynatıcı hangisi?

Farklı hizmetlerden URL oynatıyorsanız react-player’ı; tam kontrol ve yayın akışı gerekiyorsa React sarmalayıcısıyla Video.js’i; videonuz Mux’taysa Mux Player React’i kullanın.

Video oynatıcı ile video oynatıcı SDK’sı veya API’si arasındaki fark nedir?

Oynatıcı kütüphanesi, kullanıcı arayüzünü ve oynatma özelliklerini sunar. Video platformunun SDK’sı veya API’si ise yükleme, kodlama, yayın akışı ve analiz işlemlerini de yönetir. Yalnızca barındırdığınız dosyaları oynatmanız gerekiyorsa bir kütüphane yeterlidir.

En hafif video oynatıcı hangisi?

Tam özellikli oynatıcı arayüzleri arasında en hafifi Plyr’dır. hls.js daha da küçüktür; ancak yalnızca bir yayın motorudur ve üzerinde çalışması için bir video öğesi ya da oynatıcı gerekir.

Oynatıcı kütüphanesi kullanmadan React uygulamama YouTube video galerisi nasıl eklerim?

Bir widget kullanın: Elfsight’ta bir video galerisi oluşturun, kanalınızı veya oynatma listenizi bağlayın ve react-elfsight-widget ile sitenizde yayınlayın. API anahtarı veya oynatıcı kodu gerekmez.
Makale yazarı
Pazarlama Adayı
Ben Andrei Kozinskiy, Elfsight’ta Pazarlama Lideriyim. İçerik ve çeşitli trafik kanallarıyla kullanıcı tabanını büyütmekten sorumluyum. Başkalarının başarısı için görüşlerimi ve deneyimlerimi paylaşmaktan hoşlanıyorum.