P2P LiveFree live streaming · peer-to-peer delivery

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’adresse https://p2p.gia.tv/votre_nom ainsi 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.

  1. Le premier spectateur d’une chaîne télécharge la playlist et les segments vidéo depuis votre serveur d’origine (l’adresse .m3u8 que vous avez saisie), exactement comme n’importe quel autre lecteur.
  2. 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.
  3. 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.
  4. 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.
  5. 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 :

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érequisPourquoiComment 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 CDNSans 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 stablesLes 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 sLes 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 chargeLes 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

Inscription

  1. Rendez-vous sur https://p2p.gia.tv/signup.
  2. 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_utilisateur et ne pourra plus être modifié.
  3. Saisissez votre adresse e-mail et un mot de passe (8 caractères minimum).
  4. Collez, si vous le souhaitez, votre adresse .m3u8 et un titre de chaîne dès maintenant, ou ajoutez-les plus tard dans le tableau de bord.
  5. Acceptez les Conditions d’utilisation et la Politique d’utilisation acceptable. Vous devez détenir les droits sur tout ce que vous diffusez.
  6. 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 :

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

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 :

ÉtatSignification
P2P fonctionneCe spectateur reçoit des segments de pairs (ou il est le leader de l’essaim et en sert d’autres).
P2P : démarrageConnecté à 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 pasVoir 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 :

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

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.

  1. Ouvrez votre page de chaîne dans un navigateur (par exemple Chrome). Attendez que la vidéo soit lue.
  2. 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).
  3. 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.
  4. 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 :

Limites

ÉlémentValeurRemarques
Chaînes par compte1Créez d’autres comptes pour d’autres flux.
Spectateurs par chaîne (essaim)jusqu’à 500 par défautFixé par l’administrateur. Au-delà, les nouveaux spectateurs regardent toujours depuis l’origine, mais sans P2P.
Pairs par spectateurjusqu’à 12Géré automatiquement (le site peut modifier ce nombre).
Longueur de l’adresse du flux1024 caractères
Titre / description120 / 600 caractères
Charge sur l’origine1 à quelques téléchargements complets par essaimLe leader, plus les spectateurs dont les pairs sont trop lents.
Envoi du lecteurlimité par pair et au totalLes spectateurs dont l’envoi est lent en servent automatiquement moins.

Dépannage

« Flux hors ligne » dans le tableau de bord / aucune vidéo

Ça fonctionne pour moi, mais pas pour un spectateur dans un autre pays

Ça marche dans VLC mais pas dans le navigateur

« P2P ne fonctionne pas : signalisation injoignable »

« P2P ne fonctionne pas : pas de WebRTC » / « lecture native »

« P2P : démarrage » indéfiniment avec deux spectateurs

La vidéo saccade / se remet en mémoire tampon

La page d’accueil n’affiche pas ma chaîne

L’intégration affiche un cadre noir

J’ai oublié mon mot de passe

J’ai changé mon adresse e-mail, mais les Réglages affichent toujours l’ancienne

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.