P2P Live — Manuel de l’utilisateur
Ce manuel explique tout ce dont ont besoin les diffuseurs et les spectateurs : comment le service fonctionne, comment s’inscrire, à quoi votre flux doit ressembler, comment intégrer le lecteur, comment vérifier que la diffusion pair-à-pair (P2P) fonctionne, quelles sont les limites et comment résoudre les problèmes les plus courants.
En bref : inscrivez-vous, collez l’adresse de votre flux HLS (une URL
.m3u8) et vous obtenez une page publique à l’adressehttps://p2p.gia.tv/votre_nomainsi qu’un code d’intégration. Les spectateurs de cette page partagent la vidéo entre eux via leurs navigateurs : votre serveur de streaming ou votre CDN délivre le flux une fois au lieu d’une fois par spectateur.
Fonctionnement
Chaque page de chaîne contient un lecteur HLS standard (hls.js) auquel est attaché un moteur P2P.
- Le premier spectateur d’une chaîne télécharge la playlist et les segments vidéo depuis votre serveur d’origine (l’adresse
.m3u8que vous avez saisie), exactement comme n’importe quel autre lecteur. - Chaque spectateur supplémentaire ouvre la même page. Les lecteurs se trouvent via le serveur de signalisation de ce site (un petit service WebSocket) et se connectent directement, de navigateur à navigateur, par des canaux de données WebRTC.
- Chaque segment vidéo est téléchargé depuis l’origine par un seul spectateur (le leader de l’essaim), puis transmis aux autres par les connexions P2P. Si un segment n’arrive pas à temps d’un pair, le lecteur le récupère lui-même auprès de l’origine : la lecture ne dépend jamais des pairs.
- Chaque segment est vérifié (empreinte et analyse du contenu) avant d’être remis au lecteur. Un pair ne peut pas injecter de données erronées dans la lecture d’un autre spectateur.
- Les lecteurs envoient des statistiques anonymes (octets venant de l’origine, octets venant des pairs, interruptions, pairs connectés) pour que vous voyiez le taux de délestage dans votre tableau de bord.
Ce que cela signifie pour vous :
- Bande passante : avec 50 spectateurs, votre origine supporte environ la charge de 1 à 3 spectateurs. Plus une chaîne a de spectateurs, plus le délestage est élevé (généralement 80–97 %).
- Qualité : les spectateurs regardent le même flux HLS, avec la même qualité. Le P2P ne change que la provenance des octets.
- Fiabilité : si les pairs sont lents ou disparaissent, le lecteur revient discrètement à l’origine. L’origine doit donc toujours être joignable ; le P2P réduit sa charge, il ne la remplace pas.
- Confidentialité : les pairs n’échangent que des segments vidéo et de petits messages de contrôle. Aucune donnée personnelle n’est échangée entre spectateurs. Via WebRTC, les spectateurs peuvent voir leurs adresses IP respectives, comme avec tout service vidéo P2P.
Prérequis
Votre flux doit remplir ces conditions. Le bouton Vérifier le flux maintenant du tableau de bord en teste la plupart pour vous.
| Prérequis | Pourquoi | Comment vérifier |
|---|---|---|
HLS (playlist .m3u8) en http:// ou https:// | Le lecteur est un lecteur HLS. RTMP, RTSP, DASH, l’ingestion WebRTC et les simples fichiers MP4 ne sont pas pris en charge directement. | Ouvrez l’URL dans un navigateur : un petit fichier texte commençant par #EXTM3U doit se télécharger. |
En-tête CORS Access-Control-Allow-Origin: * (ou exactement https://p2p.gia.tv) sur les playlists et les segments, depuis chaque serveur périphérique de votre CDN | Sans lui, les navigateurs refusent les requêtes inter-sites. Sans CORS, le flux ne se lit pas du tout, avec ou sans P2P. Un en-tête qui nomme un autre site ne compte pas. | Tableau de bord → Vérifier le flux maintenant → « CORS ». Ou curl -sI -H 'Origin: https://p2p.gia.tv' VOTRE_URL et cherchez l’en-tête. |
| https:// si vos spectateurs utilisent https (ce site utilise https) | Les navigateurs bloquent les médias http:// sur les pages https:// (contenu mixte). | Vérifiez que l’URL commence par https://. |
| URL de segments stables | Les pairs s’échangent les segments par leur nom. Si chaque spectateur reçoit une URL nommée différemment pour le même segment (jetons par spectateur, indications du répartiteur comme lb_backend_hint, URL absolues sur des serveurs qui changent), les pairs ne peuvent pas partager. | Tableau de bord → Vérifier le flux maintenant → « Partage ». Ou ouvrez deux fois la playlist média : les noms des segments doivent être identiques. Les URL signées identiques pour tous les spectateurs ne posent pas de problème. |
| Durée des segments de 2 à 10 s | Les segments très courts (< 1 s) alourdissent la signalisation ; les très longs (> 10 s) retardent le partage entre pairs. | #EXT-X-TARGETDURATION dans la playlist média. |
| Codecs : vidéo H.264, audio AAC ou MP3 (segments TS ou fMP4) ; H.265/HEVC seulement là où le navigateur le prend en charge | Les décodeurs du navigateur. | Avec la vue de diagnostic ou la vérification du tableau de bord. |
Exigences pour l’origine
La vérification teste la playlist depuis ce serveur. Un CDN ou une origine qui traite les spectateurs différemment selon le pays ou le réseau (blocage géographique, protection contre le hotlinking, serveurs régionaux sans en-têtes CORS) peut sembler correct ici et pourtant échouer pour certains spectateurs. Ces spectateurs voient sous le lecteur Erreur de flux — l’origine a refusé ce spectateur : HTTP 403 …, et la même raison vous apparaît sous Administration → Analyse en direct (si vous administrez le site) : demandez au spectateur la raison affichée, ou le journal des événements de la vue de diagnostic.
CORS
C’est de loin le problème le plus fréquent. Votre origine doit envoyer Access-Control-Allow-Origin: * (ou exactement l’origine du site, https://p2p.gia.tv) dans chaque réponse : la playlist maître, les playlists média et les segments. Exemples :
nginx
location /live/ {
add_header Access-Control-Allow-Origin * always;
add_header Access-Control-Allow-Headers Range always;
add_header Access-Control-Expose-Headers Content-Length always;
types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; video/mp4 m4s mp4; }
}
Apache (.htaccess dans le répertoire HLS)
Header always set Access-Control-Allow-Origin "*"
Header always set Access-Control-Allow-Headers "Range"
Wowza Streaming Engine : Application → Properties → Custom → ajoutez cupertinoUserHTTPHeaders = Access-Control-Allow-Origin: * (module cupertinostreaming), ou utilisez le réglage CORS de l’origine HTTP.
CDN (Cloudflare, Akamai, CloudFront, Bunny…) : activez CORS dans les réglages de l’origine ou de la zone de récupération, avec * comme origine autorisée. Chez Cloudflare, « Transform Rules → Response headers » peut ajouter l’en-tête.
Test en ligne de commande (l’en-tête doit figurer dans la sortie) :
curl -sI -H "Origin: https://p2p.gia.tv" https://your-server.example.com/live/stream/playlist.m3u8 | grep -i access-control
Sources qui fonctionnent bien
- Wowza, nginx-rtmp / nginx avec le module HLS, Ant Media, Red5, MistServer, SRS, OvenMediaEngine (sortie HLS), Unified Streaming, Flussonic.
- OBS / vMix / encodeurs matériels → RTMP → l’un des précédents → HLS.
- Tout CDN qui s’alimente auprès des précédents, y compris le réseau Tulix / SSH101.
- FFmpeg écrivant du HLS sur un serveur web :
ffmpeg -re -i input -c:v libx264 -preset veryfast -g 60 -c:a aac -f hls -hls_time 4 -hls_list_size 10 -hls_flags delete_segments /var/www/live/stream.m3u8. - Le HLS à la demande (une playlist avec
#EXT-X-ENDLIST) fonctionne aussi ; le P2P y est même plus efficace, car les spectateurs sont à des positions différentes et peuvent partager davantage.
Inscription
- Rendez-vous sur https://p2p.gia.tv/signup.
- Choisissez un nom d’utilisateur : 3 à 20 caractères, lettres minuscules, chiffres et tiret bas. Il devient votre adresse publique
https://p2p.gia.tv/nom_utilisateuret ne pourra plus être modifié. - Saisissez votre adresse e-mail et un mot de passe (8 caractères minimum).
- Collez, si vous le souhaitez, votre adresse
.m3u8et un titre de chaîne dès maintenant, ou ajoutez-les plus tard dans le tableau de bord. - Acceptez les Conditions d’utilisation et la Politique d’utilisation acceptable. Vous devez détenir les droits sur tout ce que vous diffusez.
- Cliquez sur Créer la chaîne. Vous êtes connecté immédiatement et arrivez sur votre tableau de bord.
Sur certains sites, les inscriptions sont fermées ; utilisez alors la page de contact.
Votre tableau de bord
https://p2p.gia.tv/dashboard affiche :
- l’état du flux (en ligne/hors ligne), la date de la dernière vérification et l’erreur en cas d’échec ;
- les spectateurs actuels et le pic de spectateurs simultanés ;
- le délestage P2P : la part des octets vidéo que les spectateurs ont reçue d’autres spectateurs plutôt que de votre origine, et les totaux ;
- la qualité : résolution, débit, nombre de variantes, codecs et résultat de la vérification CORS, tels que détectés dans votre playlist ;
- le formulaire des réglages du flux : adresse, titre, description, URL de la vignette, indicateur 18+, indicateur « non répertoriée » ;
- Partager et intégrer : l’URL de votre page, le code d’intégration, l’URL d’intégration et un lien vers la vue de diagnostic ;
- un graphique des spectateurs sur 24 heures (dès que quelqu’un a regardé).
Vérifier le flux maintenant télécharge votre playlist côté serveur et affiche : en ligne/hors ligne, direct ou VOD, durée cible, variantes, meilleure résolution/débit, codecs et présence de l’en-tête CORS. Les flux sont aussi vérifiés automatiquement toutes les quelques minutes ; la page d’accueil n’affiche que les chaînes en ligne.
Lorsque le site envoie des e-mails, votre tableau de bord vous demande après l’inscription de confirmer votre adresse e-mail (voir Questions fréquentes).
Options de la chaîne
- Titre / description / vignette s’affichent sur votre page et dans la grille des chaînes de la page d’accueil. La vignette doit être une URL d’image https (JPEG/PNG/WebP, 16:9 recommandé).
- Contenu pour adultes (18+) marque votre chaîne d’un badge. Les chaînes pour adultes sont masquées de la page d’accueil sauf autorisation de l’administrateur ; la page et l’intégration fonctionnent toujours. Diffuser du contenu pour adultes sans cet indicateur enfreint la Politique d’utilisation acceptable.
- Non répertoriée retire la chaîne de la page d’accueil et du sitemap. La page et l’intégration continuent de fonctionner. Pratique pour des événements privés ou pendant les essais.
Votre page de chaîne
https://p2p.gia.tv/nom_utilisateur affiche le lecteur, le titre, la description, le nombre actuel de spectateurs, le lien de partage, le code d’intégration et un petit encadré de diagnostic.
Sous la vidéo se trouve une ligne d’état P2P :
| État | Signification |
|---|---|
| P2P fonctionne | Ce spectateur reçoit des segments de pairs (ou il est le leader de l’essaim et en sert d’autres). |
| P2P : démarrage | Connecté à la signalisation, en attente de pairs ou du premier segment partagé. Normal pour le premier spectateur et pendant les 10 à 20 premières secondes. |
| P2P ne fonctionne pas | Voir le texte à côté : WebRTC indisponible, lecture native (Safari sur iOS), signalisation injoignable ou échec de tous les pairs. La vidéo continue d’être lue depuis l’origine. |
La page ne bloque jamais la lecture à cause du P2P. En cas de problème, le spectateur regarde simplement depuis l’origine.
Mobile : Chrome et Firefox sur Android prennent en charge le P2P. Safari sur iOS lit le HLS nativement (sans Media Source Extensions) : les iPhone et iPad lisent donc toujours depuis l’origine et ne participent pas au P2P. Safari sur ordinateur y participe.
Intégration
Copiez le code d’intégration depuis votre tableau de bord ou votre page de chaîne :
<iframe src="https://p2p.gia.tv/embed/user_name" width="854" height="480" frameborder="0" scrolling="no"
allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>
Options :
- Adaptatif : placez l’iframe dans un conteneur et faites-lui occuper tout l’espace :
<div style="position:relative;aspect-ratio:16/9;max-width:960px">
<iframe src="https://p2p.gia.tv/embed/user_name" style="position:absolute;inset:0;width:100%;height:100%;border:0"
allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>
</div>
- Sans lecture automatique :
https://p2p.gia.tv/embed/user_name?autoplay=0affiche un bouton de lecture. - La lecture automatique démarre sans le son (les navigateurs l’exigent) ; un appui sur « Activer le son » active l’audio.
- WordPress : collez l’iframe dans un bloc « HTML personnalisé ». Wix/Squarespace/Webflow : utilisez leur élément « code intégré ».
- L’attribut
allow="autoplay …"compte : sans lui, beaucoup de navigateurs refusent la lecture automatique dans un iframe. - Les spectateurs de votre lecteur intégré et ceux de votre page de chaîne sont dans le même essaim ; ils partagent des segments entre eux.
Un lecteur brut, sans habillage du site, existe à https://p2p.gia.tv/?src=VOTRE_M3U8 (production) et https://p2p.gia.tv/debug.html?src=VOTRE_M3U8 (diagnostic). Ils utilisent le même moteur P2P et le même essaim que votre page de chaîne, car l’essaim est déduit de l’URL du flux.
Tester
Il faut deux lecteurs pour voir le P2P ; un spectateur seul télécharge toujours depuis l’origine.
- Ouvrez votre page de chaîne dans un navigateur (par exemple Chrome). Attendez que la vidéo soit lue.
- Ouvrez la même page dans un second navigateur (Firefox, Edge, un autre profil Chrome, une fenêtre de navigation privée, ou un autre ordinateur/téléphone sur n’importe quel réseau).
- En 10 à 20 secondes environ, la ligne d’état du second lecteur devrait indiquer P2P fonctionne. Le premier devient le leader et indique qu’il sert des pairs.
- Pour les détails, ouvrez le lien Vue de diagnostic (aussi
https://p2p.gia.tv/debug.html?src=VOTRE_M3U8). Elle affiche chaque segment avec sa source (ORIGIN ou PEER), les pairs connectés, les octets dans chaque sens, l’état de la signalisation, un bloc de diagnostic qui dit exactement pourquoi le P2P fonctionne ou non, et une procédure de test intégrée.
Remarques :
- Deux onglets du même navigateur fonctionnent aussi, mais les navigateurs ralentissent les onglets en arrière-plan ; gardez-les tous deux visibles.
- Les réseaux d’entreprise et certains opérateurs mobiles bloquent WebRTC (UDP). Un serveur TURN (configuré par l’administrateur du site) aide dans la plupart de ces cas.
- Le premier spectateur affiche toujours des téléchargements depuis l’origine ; c’est normal. Regardez le second spectateur.
- La lecture depuis l’origine pendant que l’état indique « P2P : démarrage » est normale pour les premiers segments.
Limites
| Élément | Valeur | Remarques |
|---|---|---|
| Chaînes par compte | 1 | Créez d’autres comptes pour d’autres flux. |
| Spectateurs par chaîne (essaim) | jusqu’à 500 par défaut | Fixé par l’administrateur. Au-delà, les nouveaux spectateurs regardent toujours depuis l’origine, mais sans P2P. |
| Pairs par spectateur | jusqu’à 12 | Géré automatiquement (le site peut modifier ce nombre). |
| Longueur de l’adresse du flux | 1024 caractères | |
| Titre / description | 120 / 600 caractères | |
| Charge sur l’origine | 1 à quelques téléchargements complets par essaim | Le leader, plus les spectateurs dont les pairs sont trop lents. |
| Envoi du lecteur | limité par pair et au total | Les spectateurs dont l’envoi est lent en servent automatiquement moins. |
Dépannage
« Flux hors ligne » dans le tableau de bord / aucune vidéo
- Ouvrez votre
.m3u8dans un navigateur : un fichier texte contenant#EXTM3Udoit se télécharger. Sinon, votre origine est hors service ou l’URL est fausse. - Lancez Vérifier le flux maintenant et lisez l’erreur.
403/404signifient que l’URL est fausse ou protégée ;timeout, que le serveur ne répond pas depuis Internet ;no segments, que la playlist est vide (l’encodeur ne tourne pas). - L’adresse doit commencer par
https://lorsque les spectateurs utilisent ce site en https (les navigateurs bloquent le contenu mixte).
Ça fonctionne pour moi, mais pas pour un spectateur dans un autre pays
- Demandez au spectateur ce qu’indique la ligne d’état sous le lecteur. Erreur de flux — HTTP 403 ou impossible d’atteindre le flux signifie que votre origine ou votre CDN traite cette région différemment (restriction géographique, protection contre le hotlinking, un serveur sans en-têtes CORS) ; la vérification depuis ce serveur ne peut pas le voir. Ce navigateur ne peut pas décoder le flux est un problème de codec sur son appareil. P2P : démarrage ou P2P ne fonctionne pas alors que la vidéo est lue n’est pas grave : le P2P est facultatif.
- L’administrateur du site voit les mêmes raisons par spectateur dans Analyse en direct.
- Depuis la 2.1.0, la bibliothèque du lecteur est servie par ce site lui-même (pas de CDN tiers) ; un CDN de scripts bloqué n’est donc plus une cause.
Ça marche dans VLC mais pas dans le navigateur
- Presque toujours CORS. Voir CORS. VLC n’a pas besoin de CORS, les navigateurs si.
- Ou le codec : les navigateurs ne savent généralement pas lire la vidéo MPEG-2, le HEVC sans accélération matérielle ni l’audio AC-3/E-AC-3. Utilisez H.264 + AAC.
« P2P ne fonctionne pas : signalisation injoignable »
- Le réseau du spectateur bloque les connexions WebSocket, ou une extension du navigateur interfère. La vidéo continue d’être lue depuis l’origine.
- Si cela arrive à tout le monde, le site redémarre ou un proxy placé devant lui ne laisse pas passer les connexions WebSocket (question pour l’administrateur).
« P2P ne fonctionne pas : pas de WebRTC » / « lecture native »
- Navigateurs très anciens, certains navigateurs axés sur la confidentialité avec WebRTC désactivé, et Safari sur iOS. Rien à faire de votre côté.
« P2P : démarrage » indéfiniment avec deux spectateurs
- Les deux spectateurs sont derrière des NAT/pare-feu restrictifs et il n’y a pas de serveur TURN. Demandez à l’administrateur de configurer TURN.
- Les noms de segments diffèrent selon le spectateur (jetons de session dans les URL). Les pairs annoncent les segments par leur nom ; si les noms diffèrent, ils ne se trouvent pas. Utilisez une URL identique pour tous les spectateurs.
- Les deux lecteurs ne sont pas dans le même essaim : ils doivent utiliser exactement la même URL de flux (l’identifiant de l’essaim en est déduit). Un
?token=différent, ouhttpau lieu dehttps, crée des essaims différents.
La vidéo saccade / se remet en mémoire tampon
- Vérifiez d’abord l’origine : si le flux saccade déjà pour le premier spectateur, l’origine ou l’encodeur est trop lent. Réduisez le débit ou corrigez l’encodeur.
- Gardez des segments courts (2–4 s) et une fenêtre de playlist d’au moins 6 segments ; avec une fenêtre de 3 segments, il n’y a pas de marge pour rattraper le retard.
- Les pairs trop lents sont ignorés automatiquement ; le lecteur télécharge depuis l’origine dans les délais.
La page d’accueil n’affiche pas ma chaîne
- La chaîne doit être en ligne (vérifiée toutes les quelques minutes ; utilisez Vérifier le flux maintenant), ne pas être « non répertoriée », ne pas être 18+ (sauf autorisation de l’administrateur), ne pas être bloquée, et le compte ne doit pas être désactivé. Certains sites n’affichent une chaîne qu’une fois son adresse e-mail confirmée.
L’intégration affiche un cadre noir
- Utilisez exactement le code de l’iframe, y compris
allow="autoplay; …". Cherchez dans la console du navigateur des erreurs de contenu mixte ou de CORS. Essayez?autoplay=0.
J’ai oublié mon mot de passe
- https://p2p.gia.tv/reset si le site a configuré l’envoi d’e-mails ; sinon contactez l’administrateur.
J’ai changé mon adresse e-mail, mais les Réglages affichent toujours l’ancienne
- C’est voulu : lorsque le site envoie des e-mails, une nouvelle adresse ne s’applique qu’une fois que vous avez ouvert le lien de confirmation que nous lui avons envoyé (sous 24 heures) et appuyé sur Confirmer. D’ici là, les Réglages affichent l’adresse comme en attente et votre compte garde l’ancienne. Votre ancienne adresse reçoit aussi un avis. Pour annuler un changement, enregistrez le formulaire avec votre adresse actuelle.
Questions fréquentes
Ma vidéo est-elle enregistrée ou rediffusée ? Non. Le site se contente de mettre les lecteurs en relation. La vidéo est récupérée sur votre origine par les navigateurs des spectateurs et transmise entre eux. Rien n’est stocké sur le serveur.
Puis-je utiliser le flux d’un autre fournisseur (par exemple ma chaîne Tulix/SSH101) ? Oui, si vous avez le droit de le diffuser et que l’origine envoie des en-têtes CORS. La page de l’annuaire SSH101 montre un exemple d’intégration.
Est-ce gratuit ? Oui. Le service est fourni tel quel, selon les Conditions d’utilisation. Les abus (violation du droit d’auteur, contenu illégal) entraînent un blocage ; voir la Politique d’utilisation acceptable.
Combien de spectateurs puis-je avoir ? Autant que votre origine pourrait en servir sans P2P avec environ 5 à 20 % de la charge. En pratique, la limite d’essaim fixée par l’administrateur (500 par défaut) s’applique par chaîne.
Les spectateurs peuvent-ils se voir ? Seulement techniquement (adresses IP au sein de WebRTC, comme avec tout service vidéo P2P). Pas de noms, pas de discussion, pas d’historique.
Quels navigateurs ? Chrome, Edge, Firefox, Opera, Brave (avec WebRTC autorisé), Safari sur ordinateur, Chrome/Firefox sur Android. Safari sur iOS lit sans P2P.
Cela fonctionne-t-il avec les DRM / le HLS chiffré ? Les playlists chiffrées en AES-128 fonctionnent (les segments sont partagés chiffrés ; chaque spectateur récupère la clé sur votre serveur de clés). Les DRM FairPlay/Widevine ne sont pas pris en charge.
Puis-je changer mon nom d’utilisateur ? Non, c’est l’adresse permanente de votre page. Créez un nouveau compte pour un nouveau nom.
Puis-je supprimer mon compte ? Oui : Réglages → Supprimer le compte, avec votre mot de passe actuel. Le compte et la page de la chaîne sont supprimés immédiatement, les spectateurs en cours sont déconnectés et un avis est envoyé à votre adresse e-mail. C’est irréversible. (Les comptes administrateur sont supprimés par un autre administrateur.)
Pourquoi mon tableau de bord me demande-t-il de confirmer mon adresse e-mail ? Lorsque le site envoie des e-mails, les nouveaux comptes reçoivent un lien de confirmation (valable 7 jours). Ouvrez-le et appuyez sur Confirmer ; Renvoyer le lien dans le tableau de bord en envoie un nouveau (jusqu’à 3 par heure). Certains sites n’affichent une chaîne sur la page d’accueil qu’une fois son adresse confirmée.
Contact
Questions et signalements d’abus : page de contact · e-mail : info@tulix.com · abus/DMCA : https://p2p.gia.tv/report.