Idioma:

Video.js vs Plyr vs react-player vs hls.js: qual biblioteca de player de vídeo usar?

Video.js, Plyr, react-player, hls.js ou Mux Player? Veja o que cada biblioteca faz, compare o código de configuração e os recursos lado a lado e escolha a ideal para seu site ou app — ou use uma solução sem bibliotecas.
Veja o que o ChatGPT pensa

Você precisa de vídeo no seu site ou app e quatro nomes aparecem sempre: Video.js, Plyr, react-player e hls.js — com o Mux Player entrando na lista se você transmite pela Mux. Todos são populares, de código aberto e resolvem problemas diferentes.

Este guia explica o que cada opção realmente é, mostra o código mínimo para configurá-la, compara todas lado a lado e ajuda você a escolher a mais adequada — ou a decidir que não precisa de uma biblioteca.

Principais conclusões



  • Video.js — uma estrutura completa para players, com um amplo ecossistema de plugins, skins e reprodução de HLS/DASH integrada. Ideal para quem precisa de controle e flexibilidade.
  • Plyr — um player leve com uma interface padrão elegante e acessível para vídeos em HTML5, YouTube e Vimeo. Ideal para quem quer um player bonito sem perder tempo.
  • react-player — componente React que reproduz vários tipos de URL (arquivos, YouTube, Vimeo e outros) por meio de uma única API. Ideal para apps React que usam diferentes fontes.
  • hls.js — não é uma interface de player, mas um mecanismo de streaming que permite reproduzir HLS em navegadores sem suporte nativo. Use-o com a tag de vídeo ou um player.
  • Mux Player — player desenvolvido para vídeos hospedados no Mux, com análise de dados integrada. Ideal se o Mux é sua plataforma de vídeo.
  • Se você quer exibir uma galeria de vídeos do YouTube, TikTok ou Instagram em páginas de marketing, um widget pronto costuma ser mais rápido do que qualquer biblioteca.

Que problema você está resolvendo?

Antes de comparar recursos, defina o que você precisa fazer. A maioria das equipes se encaixa em uma destas quatro situações:

  1. Reproduza seus próprios arquivos MP4 com uma interface melhor do que a padrão do navegador — Plyr ou Video.js.
  2. Transmita vídeos longos ou ao vivo com qualidade adaptativa (HLS/DASH) — use Video.js, hls.js com sua própria interface ou o player da sua plataforma de vídeo (como o Mux Player).
  3. Reproduza URLs de vários serviços em um app React — hoje, um vídeo do YouTube; amanhã, um link do Vimeo; na próxima semana, um MP4: use o react-player.
  4. Exibir vários vídeos do YouTube, TikTok ou Instagram em uma galeria no site não é bem uma questão de player, mas de conteúdo e layout (veja a última seção).

Conheça as bibliotecas

 Video.jsPlyrreact-playerhls.jsMux Player
O que éEstrutura completa do playerInterface de player leveWrapper React para várias fontesMecanismo de streaming HLS (sem interface)Player para vídeos hospedados no Mux
LicençaApache 2.0MITMITApache 2.0MIT
arquivos de vídeo HTML5SimSimSimPelo elemento de vídeoRecursos do Mux
YouTube / VimeoPor meio de pluginsIntegradoIntegradoNãoNão
HLSIntegrado (VHS)Com hls.jsUsa hls.js para .m3u8Sim — esse é o objetivoSim
DASHIntegrado (VHS)Com uma biblioteca DASHPor meio de um plugin de reprodução de arquivosNão—
LegendasSimSimDepende da fonteSeu player cuida dissoSim
Temas e personalizaçãoTemas CSS, templates e pluginsVariáveis CSSInterface própria da fonte—Variáveis CSS, temas
Suporte a ReactCom um componente wrapperPor meio de um wrapperNativoQualquer framework@mux/mux-player-react
Melhor paraControle, plugins e streamingInterface padrão rápida e cleanURLs misturadas no ReactHLS no Chrome/Firefox/EdgeTeams on Mux

Video.js

Video.js é um veterano entre os players de vídeo de código aberto. Ele envolve o elemento de vídeo HTML5 em uma interface consistente e personalizável e oferece um sistema de plugins com recursos que vão de seletores de qualidade a ferramentas de análise e anúncios. Seu mecanismo de streaming integrado (VHS) reproduz HLS e DASH, então raramente você precisa de bibliotecas extras para streaming adaptativo — a reprodução de HLS no Video.js funciona sem configurações adicionais.

Instalar e 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 com React

Este é o padrão recomendado para usar o Video.js com React. Crie o player em um efeito e descarte-o ao desmontar o componente — caso contrário, as mudanças de rota deixam os players em execução na memória.

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 e temas

O Video.js vem com um tema padrão que você pode personalizar com CSS. Temas oficiais e da comunidade — além de plugins para recursos como playlists e menus de qualidade — permitem mudar a aparência sem precisar recriar os controles. Se você precisa de um player com uma identidade visual marcante, reserve um tempo para trabalhar no CSS: o Video.js oferece todos os recursos necessários, mas o acabamento depende de você.

Quando escolher o Video.js

  • Você transmite conteúdo em HLS ou DASH e quer uma única biblioteca que funcione com os dois formatos.
  • Você precisa de plugins para analytics, anúncios, seleção de qualidade e playlists.
  • Você busca um projeto consolidado, com uma longa trajetória e uma grande comunidade.

Plyr

O player de vídeo Plyr (muitas vezes buscado como “Plyr JS”) tem um foco: oferecer um player bonito, acessível e pronto para usar. Ele é compatível com vídeos e áudios em HTML5, além de vídeos incorporados do YouTube e Vimeo, tudo na mesma interface. Como usa propriedades personalizadas de CSS, você adapta as cores à sua marca em poucos minutos. O Plyr não transmite vídeos em HLS por conta própria — para isso, use-o com o hls.js.

Instalar e 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 com 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);

Quando escolher o Plyr

  • Você quer um player moderno e minimalista, compatível com teclado e leitores de tela, e que exija pouca configuração.
  • Você combina seus próprios arquivos com vídeos do YouTube ou Vimeo e quer manter uma interface consistente.
  • Você não precisa de um grande ecossistema de plugins.

react-player

react-player (o pacote npm que muita gente pesquisa simplesmente como “react player”) é um componente React que recebe uma URL e identifica como reproduzi-la: um arquivo MP4, uma transmissão HLS, um link do YouTube ou Vimeo e vários outros serviços. Ele não substitui o player de cada serviço — ele o incorpora —, mas oferece uma API React consistente para reproduzir, pausar, avançar e acompanhar eventos.

Instale e use

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

Observação: consulte a documentação da versão principal que você instalar — versões recentes renomearam algumas propriedades. A ideia continua a mesma: um componente, várias fontes.

Quando escolher o react-player

  • Seu app React reproduz URLs de diferentes serviços.
  • Você precisa de uma API declarativa e rápida, em vez de criar um player.
  • Tudo bem para você usar a interface própria de cada serviço no componente.

hls.js

hls.js é uma biblioteca JavaScript que reproduz HLS (HTTP Live Streaming) em navegadores sem suporte nativo, usando Media Source Extensions. Ela não tem interface própria: basta conectá-la a um elemento <video> ou a um player, como o Plyr. O Safari reproduz HLS nativamente; por isso, você só precisa do hls.js no Chrome, Firefox e Edge.

Instalar e 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
}

Documentação e demonstração

O projeto hls.js disponibiliza documentação da API e uma página de demonstração ao vivo, onde você pode inserir o URL de um stream e verificar os níveis de qualidade, o buffering e os erros. É útil para depurar um stream antes de criar qualquer coisa em torno dele.

Quando escolher o hls.js

  • Você tem transmissões HLS e quer que elas funcionem em qualquer lugar.
  • Você já tem uma interface (ou usa o Plyr) e só precisa do mecanismo de streaming.
  • Você quer ter controle preciso sobre o buffering e a alternância de qualidade.

Mux Player

Se você hospeda vídeos no Mux, o Mux Player é a escolha ideal: um componente web (com uma versão para React) que reproduz streams do Mux com qualidade adaptável e envia dados de visualização para as análises do Mux. Ele permite personalizar o tema e cuida das legendas, miniaturas e linhas do tempo. É menos útil se seus vídeos estiverem hospedados em outro lugar.

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

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

HLS e DASH em dois parágrafos

HLS e DASH dividem um vídeo em segmentos curtos com diferentes níveis de qualidade e os descrevem em um arquivo de manifesto (.m3u8 para HLS e .mpd para DASH). O player baixa os segmentos um a um e escolhe a qualidade mais adequada à conexão de quem está assistindo. Isso é streaming adaptativo — e é por isso que vídeos longos começam a reproduzir rapidamente e não travam.

Se você só tem arquivos MP4 curtos, não precisa de nada disso: o elemento de vídeo HTML5 reproduz esses arquivos em qualquer lugar. O streaming é importante para vídeos longos, transmissões ao vivo e grandes audiências — e, nesses casos, a maioria das equipes usa uma plataforma de vídeo que faz a codificação dos streams.

Desempenho: como evitar deixar seu site lento

  • Carregue os players apenas onde necessário. Importe a biblioteca somente nas páginas que realmente exibem vídeos — de preferência, dinamicamente, quando o player aparecer na tela durante a rolagem.
  • Comece com uma imagem de prévia. Exiba uma miniatura leve e crie o player só quando alguém clicar — especialmente em páginas com vários vídeos.
  • Reserve espaço. Defina aspect-ratio no contêiner para evitar que a página salte quando o player carregar (Cumulative Layout Shift).
  • Use preload="metadata" nos arquivos para que o navegador não baixe o vídeo inteiro logo de início.
  • Transmita vídeos longos em vez de disponibilizar um único arquivo MP4 grande.

Checklist de acessibilidade

  • Legendas para todo vídeo com falas (faixas WebVTT).
  • Controle total pelo teclado: reproduzir/pausar, avançar, ajustar o volume e ativar o modo tela cheia.
  • Indicadores de foco visíveis e botões com rótulos para leitores de tela.
  • Não reproduz automaticamente com som; respeita prefers-reduced-motion em vídeos de fundo.

Plyr e Video.js levam a acessibilidade a sério, mas teste com teclado e leitor de tela de qualquer forma — skins personalizadas podem comprometer o que as configurações padrão fazem certo.

Guia de decisão

Se precisar…Escolher
Um player padrão elegante para MP4, YouTube e VimeoPlyr
Plugins, skins, integrações com analytics, HLS e DASH prontos para usarVideo.js
Vários tipos de URL em um app React com o mínimo de códigoreact-player
HLS no Chrome, Firefox e Edge com sua própria interfacehls.js
Reprodução e análise de vídeos hospedados no MuxMux Player
Uma galeria de vídeos do YouTube, TikTok, Instagram ou Vimeo para uma página de marketingUm widget de galeria (veja abaixo)

Quando uma biblioteca é demais

Bibliotecas de player oferecem um player. Mas, se o que você precisa é de uma seção de vídeos — com seu canal do YouTube, uma playlist de tutoriais ou depoimentos de clientes do TikTok e do Instagram —, ainda teria que criar os layouts da galeria, buscar vídeos nas APIs de cada plataforma (com chaves e limites de uso), manter o feed atualizado e oferecer à sua equipe uma forma de gerenciá-lo.

A Galeria de Vídeos da Elfsight faz isso por você: conecte o YouTube, Vimeo, TikTok, Instagram Reels, Twitch ou qualquer link de vídeo, escolha um dos sete layouts e adicione a galeria a qualquer site — ou a um aplicativo React com o componente oficial react-elfsight-widget. Os vídeos novos aparecem automaticamente, os vídeos abrem em um popup na sua página e você pode exibir um card com chamada para ação após cada vídeo.

Crie sua galeria de vídeos aqui mesmo ↓

Veja como funciona com React e Next.js.

Perguntas frequentes

Qual é o melhor player de vídeo de código aberto?

Para a maioria dos sites, use o Video.js (completo, com plugins e suporte a streaming) ou o Plyr (leve e com uma interface refinada). Escolha o Video.js para transmitir conteúdo em HLS/DASH ou usar plugins. Prefira o Plyr se quiser uma ótima aparência desde o início e precisar de pouca configuração.

O Video.js é gratuito?

Sim. O Video.js é de código aberto, sob a licença Apache 2.0.

O Plyr reproduz vídeos do YouTube e do Vimeo?

Sim. O Plyr é compatível com vídeos incorporados do YouTube e do Vimeo, além de vídeos e áudios em HTML5, tudo com a mesma interface.

Preciso do hls.js com o Video.js?

Geralmente, não. O Video.js inclui seu próprio mecanismo de streaming (VHS) para HLS e DASH.

Preciso do hls.js no Safari?

Não. O Safari reproduz HLS nativamente. O hls.js é usado em navegadores sem suporte nativo a HLS.

O react-player é compatível com HLS?

Sim. Para URLs .m3u8, ele usa o hls.js nos bastidores.

Qual é o melhor player de vídeo para React?

react-player para reproduzir URLs de diferentes serviços; Video.js com um wrapper para React se você precisa de controle total e streaming; Mux Player React se seus vídeos estão no Mux.

Qual é a diferença entre um player de vídeo e um SDK ou uma API de player de vídeo?

Uma biblioteca de player oferece a interface e os recursos de reprodução. Já o SDK ou a API de uma plataforma de vídeo também cuidam do envio, da codificação e da transmissão dos vídeos, além de fornecer análises. Se você só precisa reproduzir arquivos que já hospeda, uma biblioteca é suficiente.

Qual player de vídeo é mais leve?

Entre os players completos, o Plyr é o mais leve. O hls.js é ainda menor, mas funciona apenas como mecanismo de streaming e precisa de um elemento de vídeo ou de outro player.

Como adicionar uma galeria de vídeos do YouTube a um app React sem usar uma biblioteca de player?

Use um widget: crie uma galeria de vídeos no Elfsight, conecte seu canal ou playlist e exiba-a com react-elfsight-widget. Sem chaves de API nem código de player.
Artigo de
Lead de Marketing
Sou Andrei Kozinskiy, Líder de Marketing na Elfsight. Sou responsável por impulsionar o crescimento de usuários por meio de conteúdo e diversos canais de tráfego. Adoro compartilhar insights e experiências para ajudar outras pessoas a terem sucesso.