Idioma:

Video.js vs. Plyr vs. react-player vs. hls.js: ¿qué biblioteca de reproductor de video elegir?

¿Video.js, Plyr, react-player, hls.js o Mux Player? Descubre qué hace realmente cada biblioteca, compara su código de configuración y sus funciones, y elige la más adecuada para tu sitio web o aplicación. O prescinde de las bibliotecas por completo.
Descubre qué opina ChatGPT

Necesitas añadir vídeo a tu sitio web o aplicación, y hay cuatro nombres que aparecen una y otra vez: Video.js, Plyr, react-player y hls.js. Si transmites desde Mux, también se suma Mux Player. Todos son populares y de código abierto, pero cada uno resuelve problemas diferentes.

Esta guía explica en qué consiste cada opción, muestra el código mínimo para configurarla, las compara y te ayuda a elegir la más adecuada o a decidir si realmente necesitas una biblioteca.

Puntos clave



  • Video.js: un framework completo para reproductores, con un amplio ecosistema de plugins, skins y reproducción HLS/DASH integrada. Ideal si necesitas control y flexibilidad.
  • Plyr: un reproductor ligero con una interfaz predeterminada accesible y cuidada para vídeos HTML5, YouTube y Vimeo. Ideal si quieres un reproductor atractivo en poco tiempo.
  • react-player: un componente de React que reproduce muchos tipos de URL (archivos, YouTube, Vimeo y más) con una sola API. Ideal para aplicaciones de React con distintas fuentes.
  • hls.js no es una interfaz de reproductor, sino un motor de streaming que permite reproducir HLS en navegadores sin compatibilidad nativa. Combínalo con la etiqueta de video o con un reproductor.
  • Mux Player: un reproductor para vídeos alojados en Mux, con analíticas integradas. Ideal si Mux es tu plataforma de vídeo.
  • Si buscas mostrar videos de YouTube, TikTok o Instagram en las páginas de marketing de tu sitio, un widget listo para usar suele ser más rápido que cualquier biblioteca.

¿Qué problema estás resolviendo?

Antes de comparar funciones, define qué necesitas. La mayoría de los equipos se encuentra en una de estas cuatro situaciones:

  1. Reproduce tus propios archivos MP4 con una interfaz más atractiva que la predeterminada del navegador: Plyr o Video.js.
  2. Transmite vídeos largos o en directo con calidad adaptativa (HLS/DASH): usa Video.js, hls.js con tu propia interfaz o el reproductor de tu plataforma de vídeo (por ejemplo, Mux Player).
  3. Reproduce URL de distintos servicios en una app de React: YouTube hoy, un enlace de Vimeo mañana, un MP4 la semana que viene… con react-player.
  4. Mostrar muchos videos de YouTube, TikTok o Instagram en una galería dentro de un sitio web no es realmente un problema del reproductor, sino del contenido y el diseño (consulta la última sección).

Las bibliotecas de un vistazo

 Video.jsPlyrreact-playerhls.jsMux Player
Qué esEstructura completa del reproductorInterfaz ligera del reproductorIntegración de React para múltiples fuentesMotor de streaming HLS (sin interfaz de usuario)Reproductor para vídeos alojados en Mux
LicenciaApache 2.0MITMITApache 2.0MIT
Archivos de video HTML5SíSíSíMediante el elemento de vídeoRecursos de Mux
YouTube / VimeoMediante pluginsIntegradoIntegradoNoNo
HLSIncluido (VHS)Con hls.jsUsa hls.js para .m3u8Sí: ese es su propósitoSí
DASHIncluido (VHS)Con una biblioteca DASHMediante un plugin de reproducción de archivosNo—
SubtítulosSíSíDepende de la fuenteTu reproductor se encarga de todoSí
Diseño y temasTemas, estilos CSS y pluginsVariables CSSInterfaz propia de Source—Variables CSS, temas
Compatibilidad con ReactMediante un componente envolventeMediante un wrapperNativoCualquier framework@mux/mux-player-react
Ideal paraControl, plugins, streamingInterfaz predeterminada rápida y limpiaURL mixtas en ReactHLS en Chrome/Firefox/EdgeTeams en Mux

Video.js

Video.js es uno de los reproductores de vídeo de código abierto con más trayectoria. Envuelve el elemento de vídeo HTML5 en una interfaz uniforme y personalizable, y añade un sistema de complementos que abarca desde selectores de calidad hasta analíticas y anuncios. Su motor de streaming integrado (VHS) reproduce HLS y DASH, así que rara vez necesitas bibliotecas adicionales para el streaming adaptativo: la reproducción de HLS con Video.js funciona desde el primer momento.

Instalar y configurar

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 con React

Este es el patrón habitual de Video.js en React. Crea el reproductor dentro de un efecto y destrúyelo al desmontar el componente; de lo contrario, los cambios de ruta dejarán reproductores en ejecución y ocupando memoria.

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" />;
}

Estilos y temas

Video.js incluye un tema predeterminado que puedes personalizar con CSS. Los temas oficiales y de la comunidad, junto con plugins para funciones como listas de reproducción o menús de calidad, te permiten cambiar el aspecto sin tener que crear los controles de nuevo. Si quieres un reproductor con una identidad de marca bien definida, reserva tiempo para trabajar con CSS: Video.js te ofrece todas las herramientas, pero el acabado depende de ti.

Cuándo elegir Video.js

  • Transmites en HLS o DASH y buscas una sola biblioteca que admita ambos formatos.
  • Necesitas plugins para analíticas, anuncios, cambiar la calidad y crear listas de reproducción.
  • Buscas un proyecto consolidado, con una larga trayectoria y una gran comunidad.

Plyr

El reproductor de vídeo Plyr (a menudo buscado como «Plyr JS») se centra en una sola cosa: ofrecer un reproductor atractivo y accesible, listo para usar. Es compatible con vídeo y audio HTML5, además de vídeos insertados de YouTube y Vimeo, todo con la misma interfaz. Su estilo se personaliza mediante propiedades CSS, así que adaptar los colores a tu marca solo te llevará unos minutos. Plyr no transmite contenido HLS por sí solo: para ello, combínalo con hls.js.

Instalar y configurar

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 con 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);

Cuándo elegir Plyr

  • Buscas un reproductor moderno y sencillo, compatible con teclados y lectores de pantalla, que requiera poca configuración.
  • Combina tus propios archivos con YouTube o Vimeo y consigue una interfaz coherente.
  • No necesitas un gran ecosistema de plugins.

react-player

react-player (el paquete npm que muchas personas buscan simplemente como «react player») es un componente de React que acepta una URL y determina cómo reproducir su contenido: un archivo MP4, una transmisión HLS, un enlace de YouTube o Vimeo y otros servicios. No reemplaza el reproductor de cada servicio, sino que lo integra. Así, ofrece una API de React uniforme para reproducir, pausar, avanzar y escuchar eventos.

Instalar y usar

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%"
    />
  );
}

Nota: consulta la documentación de la versión principal que instales; en las versiones recientes se han cambiado algunos nombres de propiedades. La idea sigue siendo la misma: un componente, muchas fuentes.

Cuándo elegir react-player

  • Tu aplicación de React reproduce URL de distintos servicios.
  • Buscas una API rápida y declarativa, en lugar de crear un reproductor desde cero.
  • Te parece bien que cada servicio muestre su propia interfaz de reproductor dentro del componente.

hls.js

hls.js es una biblioteca de JavaScript que reproduce HLS (HTTP Live Streaming) en navegadores que no son compatibles de forma nativa, mediante Media Source Extensions. No tiene interfaz de usuario: se conecta a un elemento <video> o a un reproductor como Plyr. Safari reproduce HLS de forma nativa, así que solo necesitas hls.js para Chrome, Firefox y Edge.

Instalar y configurar

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
}

Documentación y demo

El proyecto hls.js ofrece documentación de la API y una página de demostración en vivo donde puedes pegar la URL de una transmisión y consultar los niveles de calidad, el almacenamiento en búfer y los errores. Es muy útil para depurar una transmisión antes de crear nada a su alrededor.

Cuándo elegir hls.js

  • Tienes streams HLS y quieres que se reproduzcan en todas partes.
  • Ya tienes una interfaz de usuario (o usas Plyr) y solo necesitas el motor de streaming.
  • Quieres tener un control preciso sobre el almacenamiento en búfer y el cambio de calidad.

Mux Player

Si alojas tus videos en Mux, Mux Player es la opción ideal: un componente web (con una versión para React) que reproduce transmisiones de Mux con calidad adaptable y envía datos de visualización a las analíticas de Mux. Puedes personalizar su tema y gestionar los subtítulos, las miniaturas y la línea de tiempo fácilmente. Es menos útil si alojas tus videos en otra plataforma.

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

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

HLS y DASH en dos párrafos

HLS y DASH dividen el video en segmentos cortos con distintos niveles de calidad y los describen en un archivo de manifiesto (.m3u8 para HLS y .mpd para DASH). El reproductor descarga los segmentos uno por uno y elige la calidad que mejor se adapta a la conexión de cada usuario. Así funciona la transmisión adaptativa: los videos largos empiezan a reproducirse rápido y no se quedan cargando.

Si solo tienes archivos MP4 cortos, no necesitas nada de esto: el elemento de video HTML5 los reproduce en cualquier lugar. El streaming es importante para videos largos, transmisiones en vivo y audiencias numerosas. En esos casos, la mayoría de los equipos utiliza una plataforma de video que codifica las transmisiones por ellos.

Rendimiento: cómo evitar que tu sitio web se ralentice

  • Carga los reproductores solo cuando los necesites. Importa la biblioteca únicamente en las páginas que tengan vídeo; lo ideal es usar una importación dinámica cuando el reproductor aparezca en pantalla.
  • Empieza con una imagen de portada. Muestra una miniatura ligera y crea el reproductor al hacer clic, especialmente si la página tiene varios videos.
  • Reserva espacio. Define aspect-ratio en el contenedor para evitar que la página dé saltos al cargar el reproductor (desplazamiento acumulado del diseño).
  • Usa preload="metadata" en los archivos para que el navegador no descargue el video completo de antemano.
  • Transmite videos largos en lugar de ofrecer un único archivo MP4 grande.

Lista de verificación de accesibilidad

  • Subtítulos para cada vídeo hablado (pistas WebVTT).
  • Control total con el teclado: reproducir/pausar, avanzar, ajustar el volumen y activar la pantalla completa.
  • Estados de foco visibles y botones con etiquetas para lectores de pantalla.
  • No reproduzcas automáticamente con sonido y respeta prefers-reduced-motion en los vídeos de fondo.

Tanto Plyr como Video.js se toman muy en serio la accesibilidad. Aun así, prueba el reproductor con el teclado y un lector de pantalla: los diseños personalizados pueden afectar funciones que sí funcionan con la configuración predeterminada.

Guía para elegir

Si necesitas…Elegir
Un reproductor predeterminado y elegante para MP4, YouTube y VimeoPlyr
Plugins, skins, analíticas, HLS y DASH incluidos de serieVideo.js
Muchos tipos de URL en una app de React con muy poco códigoreact-player
HLS en Chrome, Firefox y Edge con tu propia interfazhls.js
Reproducción y analíticas para vídeos alojados en MuxMux Player
Una galería de videos de YouTube, TikTok, Instagram o Vimeo para tu página de marketingUn widget de galería (ver abajo)

Cuando una biblioteca es innecesaria

Las bibliotecas de reproductores te dan un reproductor. Pero si lo que necesitas es una sección de videos —con tu canal de YouTube, una lista de tutoriales o testimonios de clientes de TikTok e Instagram—, aún tendrías que diseñar las galerías, obtener los videos de la API de cada plataforma (con sus claves y límites de uso), mantener el feed actualizado y ofrecer a tu equipo una forma de gestionarlo.

Galería de Videos de Elfsight se encarga de todo eso por ti: conecta YouTube, Vimeo, TikTok, Instagram Reels, Twitch o cualquier enlace de video, elige uno de los siete diseños y añádela a cualquier sitio web o a una aplicación de React con el componente oficial react-elfsight-widget. Los videos nuevos aparecen automáticamente, se abren en una ventana emergente en tu página y puedes mostrar una tarjeta con una llamada a la acción después de cada video.

Crea tu galería de videos aquí ↓

Descubre cómo funciona con React y Next.js.

Preguntas frecuentes

¿Cuál es el mejor reproductor de vídeo de código abierto?

Para la mayoría de los sitios web, Video.js (completo, con plugins y streaming) o Plyr (ligero y con una interfaz cuidada) son buenas opciones. Elige Video.js si transmites contenido en HLS/DASH o necesitas plugins; elige Plyr si buscas una buena apariencia desde el primer momento y una configuración mínima.

¿Video.js es gratis?

Sí. Video.js es de código abierto y está disponible bajo la licencia Apache 2.0.

¿Plyr puede reproducir videos de YouTube y Vimeo?

Sí. Plyr admite vídeos de YouTube y Vimeo incrustados, además de vídeo y audio HTML5, todo desde la misma interfaz.

¿Necesito hls.js para usar Video.js?

Normalmente, no. Video.js incluye su propio motor de streaming (VHS) para HLS y DASH.

¿Necesito hls.js en Safari?

No. Safari reproduce HLS de forma nativa. hls.js está pensado para navegadores que no son compatibles con HLS de forma nativa.

¿react-player es compatible con HLS?

Sí. Para las URL .m3u8, utiliza hls.js internamente.

¿Cuál es el mejor reproductor de video para React?

Usa react-player para reproducir URL de distintos servicios; Video.js con un wrapper de React si necesitas control total y streaming; o Mux Player React si tu vídeo está en Mux.

¿Qué diferencia hay entre un reproductor de vídeo y un SDK o una API de reproducción de vídeo?

Una biblioteca de reproducción te ofrece la interfaz y la reproducción de vídeo. El SDK o la API de una plataforma de vídeo también se encargan de la carga, la codificación, el streaming y las analíticas. Si solo necesitas reproducir archivos que ya alojas, basta con una biblioteca.

¿Qué reproductor de video es más ligero?

Entre los reproductores con interfaz completa, Plyr es el más ligero. hls.js pesa aún menos, pero solo es un motor de streaming y necesita un elemento de vídeo o un reproductor adicional.

¿Cómo puedo añadir a una aplicación de React una galería de vídeos de YouTube sin usar una biblioteca de reproductores?

Usa un widget: crea una galería de videos en Elfsight, conecta tu canal o lista de reproducción y muéstrala con react-elfsight-widget. Sin claves de API ni código del reproductor.
Artículo de
Lead de Marketing
Soy Andrei Kozinskiy, Líder de Marketing en Elfsight. Me ocupo de impulsar el crecimiento de usuarios mediante contenido y diversos canales de tráfico. Me encanta compartir ideas y experiencias para ayudar a otros a triunfar.