Guide d’intégration du lecteur

Lecture en ligne

Ouvrez le lecteur depuis un autre site ou une application avec une URL vidéo et des paramètres de lecture facultatifs.

Utilisez #url= pour les liens de lecture. Placez l’URL de la vidéo et toutes les options après #.

Créer un lien de lecture

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

Encodez une seule fois l’URL complète de la vidéo comme valeur de url. Séparez les options par &. Utilisez encodeURIComponent ou URLSearchParams pour créer le lien.

Paramètres du lien de lecture

ParamètreValeursPar défautDescription
urlHTTPS URLObligatoireURL de la vidéo
title≤ 120autoNom de la vidéo
typeauto / hls / videoautoFormat
autoplay0 / 11Lecture automatique
muted0 / 10Muet
volume0–1Réglage localVolume
rate0.25–4Réglage localVitesse de lecture
start90 / 01:30 / 00:01:30Position enregistréePosition initiale (à la demande)
loop0 / 1Réglage localBoucle
posterHTTPS URL—Image d’affiche
subtitleHTTPS SRT / VTT URL—Sous-titres
langar / de / en / es / fr / hi / id / it / ja / ko / pt / ru / th / tr / vi / zh-CN / zh-TWautoChanger de langue
history0 / 1Réglage localHistorique
resume0 / 11Position enregistrée
theater0 / 10Mode cinéma
lights0 / 10Éteindre les lumières
qualityauto / 720 / 1080 / …autoQualité
audio0 / 1 / …autoAudio
aspectauto / 16:9 / 4:3 / 1:1autoRapport d'aspect

Conseils d’utilisation

  • autoplay=0 charge le lecteur en pause. muted=1 facilite la lecture automatique, mais le navigateur peut exiger un clic. Le plein écran et l’incrustation nécessitent une action de l’utilisateur.
  • Les options ne concernent que cette lecture. Les valeurs omises suivent les réglages locaux. history=0 ne conserve rien ; history=1 respecte l’option locale. start prime sur la position enregistrée ; resume=0 désactive la reprise.
  • La qualité et les pistes audio dépendent de la source vidéo et du navigateur. start concerne les vidéos à la demande ; les pistes audio sont numérotées à partir de 0.
  • Les sous-titres distants acceptent les fichiers SRT et VTT en UTF-8 jusqu’à 5 MiB. Leur URL doit autoriser l’accès entre origines.