Guia de integração do player

Reprodutor

Abra o player de outro site ou aplicativo com uma URL de vídeo e configure a reprodução com parâmetros opcionais.

Use #url= nos links de reprodução. Coloque o URL do vídeo e todas as opções depois de #.

Criar um link de reprodução

URL
https://m3u8-player.com/pt/#url=https://example.com/video.m3u8
JavaScript
const videoUrl = 'https://example.com/video.m3u8';
const params = new URLSearchParams({
  url: videoUrl, autoplay: '1', muted: '1'
});
const playerUrl = 'https://m3u8-player.com/pt/#' + params;
window.open(playerUrl, '_blank', 'noopener');

Codifique o URL completo do vídeo uma única vez como valor de url. Separe as opções com &. Use encodeURIComponent ou URLSearchParams para criar o link.

Parâmetros do link de reprodução

ParâmetroValoresPadrãoDescrição
urlHTTPS URLObrigatórioURL do vídeo
title≤ 120autoNome do vídeo
typeauto / hls / videoautoFormato
autoplay0 / 11Reprodução automática
muted0 / 10Silenciar
volume0–1Configuração localVolume
rate0.25–4Configuração localVelocidade de reprodução
start90 / 01:30 / 00:01:30Progresso salvoPosição inicial (sob demanda)
loop0 / 1Configuração localRepetir
posterHTTPS URL—Imagem de capa
subtitleHTTPS SRT / VTT URL—Legendas
langar / de / en / es / fr / hi / id / it / ja / ko / pt / ru / th / tr / vi / zh-CN / zh-TWautoAlterar idioma
history0 / 1Configuração localHistórico
resume0 / 11Progresso salvo
theater0 / 10Modo cinema
lights0 / 10Apagar luzes
qualityauto / 720 / 1080 / …autoQualidade
audio0 / 1 / …autoÁudio
aspectauto / 16:9 / 4:3 / 1:1autoProporção da tela

Notas de uso

  • autoplay=0 carrega o player pausado. muted=1 ajuda na reprodução automática, mas o navegador ainda pode exigir um clique. Tela cheia e picture-in-picture exigem ação do usuário.
  • As opções afetam apenas esta reprodução. Valores omitidos usam configurações locais. history=0 não registra; history=1 respeita a opção local. start tem prioridade sobre o progresso salvo; resume=0 desativa a retomada.
  • As opções de qualidade e áudio dependem da fonte do vídeo e do navegador. start se aplica a vídeos sob demanda; as faixas de audio são numeradas a partir de 0.
  • Legendas remotas aceitam arquivos SRT e VTT em UTF-8 de até 5 MiB. O URL da legenda deve permitir acesso entre origens.