Guida all’integrazione del lettore

Lettore online

Apri il lettore da un sito o un’app con un URL video e configura la riproduzione con parametri facoltativi.

Usa #url= per i link di riproduzione. Inserisci l’URL del video e tutte le opzioni dopo #.

Crea un link di riproduzione

URL
https://m3u8-player.com/it/#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/it/#' + params;
window.open(playerUrl, '_blank', 'noopener');

Codifica una sola volta l’URL completo del video come valore di url. Separa le opzioni con &. Usa encodeURIComponent o URLSearchParams per creare il link.

Parametri del link di riproduzione

ParametroValoriPredefinitoDescrizione
urlHTTPS URLObbligatorioURL del video
title≤ 120autoNome del video
typeauto / hls / videoautoFormato
autoplay0 / 11Riproduzione automatica
muted0 / 10Disattiva audio
volume0–1Impostazione localeVolume
rate0.25–4Impostazione localeVelocità di riproduzione
start90 / 01:30 / 00:01:30Posizione salvataPosizione iniziale (su richiesta)
loop0 / 1Impostazione localeRipeti
posterHTTPS URL—Immagine di copertina
subtitleHTTPS SRT / VTT URL—Sottotitoli
langar / de / en / es / fr / hi / id / it / ja / ko / pt / ru / th / tr / vi / zh-CN / zh-TWautoCambia lingua
history0 / 1Impostazione localeCronologia
resume0 / 11Posizione salvata
theater0 / 10Modalità cinema
lights0 / 10Spegni le luci
qualityauto / 720 / 1080 / …autoQualità
audio0 / 1 / …autoAudio
aspectauto / 16:9 / 4:3 / 1:1autoProporzioni

Note sull’utilizzo

  • autoplay=0 carica il lettore in pausa. muted=1 favorisce la riproduzione automatica, ma il browser può richiedere un clic. Schermo intero e picture-in-picture richiedono un’azione dell’utente.
  • Le opzioni valgono solo per questa riproduzione. I valori omessi seguono le impostazioni locali. history=0 non registra; history=1 rispetta l’opzione locale. start prevale sulla posizione salvata; resume=0 disattiva la ripresa.
  • Qualità e tracce audio dipendono dalla sorgente video e dal browser. start si applica ai video on demand; le tracce audio sono numerate da 0.
  • I sottotitoli remoti supportano file SRT e VTT in UTF-8 fino a 5 MiB. L’URL dei sottotitoli deve consentire l’accesso tra origini.