Présentation

Ce document est une présentation de l’API Live Video qui permet de streamer une diffusion en direct sur Facebook.

Fonctionnement

Les diffusions de vidéo en direct sont représentées par des objets LiveVideo dans l’API Graph. Pour diffuser une vidéo en direct, vous devez d’abord utiliser l’API pour créer un objet LiveVideo sur un utilisateur ou une utilisatrice, une Page ou un évènement. Une fois l’objet créé, l’API renvoie un ID d’objet LiveVideo et une URL de streaming. Cette URL vous permet de streamer des données de vidéo en direct depuis votre encodeur vers l’objet LiveVideo, objet qui vous permet de modifier la visibilité de la diffusion.

Composants

Diffusions

Les diffusions de vidéo en direct sont représentées par des objets LiveVideo. En manipulant les propriétés de l’objet LiveVideo, vous pouvez contrôler la diffusion de la vidéo en direct. Vous pouvez par exemple modifier la visibilité de la vidéo en direct, changer sa description ou son titre, ajouter des étiquettes, définir les audiences, ajouter des sondages et bien d’autres choses.

Les objets LiveVideo sont associés à des objets LiveVideoInputStream, qui représentent les données du streaming d’entrée de la diffusion. Les objets LiveVideoInputStream sont créés et gérés automatiquement pour vous.

Les diffusions peuvent être créées sur des objets User, Page ou Event via leur arête /live_videos.

URL de streaming

Les URL de streaming sont des URL d’entrée que vous pouvez utiliser pour streamer les données de vidéo en direct depuis votre encodeur vers un objet LiveVideo. Lorsque vous créez un objet LiveVideo avec l’API, cette dernière vous renvoie un ID d’objet LiveVideo et une URL de streaming unique. Vous devez utiliser l’URL de streaming dans les 24 heures, avant son expiration. Vous disposez d’un maximum de huit heures à compter de sa première utilisation pour streamer avec cette URL.

RTMPS

Les diffusions de vidéo en direct doivent être chiffrées à l’aide du protocole de transfert de données RTMPS. Lorsque vous démarrez une diffusion, l’API renvoie une URL de streaming RTMPS sécurisée que vous devez utiliser pour streamer sur nos serveurs.

Sondages

Vous pouvez utiliser l’API pour créer des sondages pendant la diffusion d’une vidéo en direct et obtenir des réponses en temps réel de la part de vos spectateurs et spectatrices. Les sondages sont représentés par des objets VideoPoll dans l’API Graph, et peuvent être créés avec le point de terminaison POST /LIVE_VIDEO_ID/polls sur un objet LiveVideo. Une fois le sondage créé, l’API renvoie un ID d’objet VideoPoll qui vous permet de manipuler le sondage et d’envoyer des requêtes concernant les interactions des spectateurs et spectatrices.

Outils

Live Video Composer

Si vous utilisez un logiciel de streaming qui n’intègre pas l’API Live Video, vous pouvez utiliser notre outil Live Video Composer pour obtenir des URL de streaming et les ajouter manuellement au logiciel de streaming de votre choix. Live Video Composer vous permet de créer des diffusions sur votre propre profil d’utilisateur·ice, ou sur les Pages ou évènements que vous gérez.

Live Ingests

Pour diffuser des vidéos en direct de bonne qualité, il est nécessaire d’avoir une connexion fiable à nos serveurs. Les mauvaises connexions peuvent être la cause d’une piètre qualité, d’interruptions de lecture et d’échecs de diffusion. L’outil Live Ingests vous permet de tester votre qualité de réception afin que vous puissiez diagnostiquer les éventuels problèmes de connexion, identifier le meilleur serveur de réception pour votre diffusion et bénéficier de diffusions de très bonne qualité avec moins de problèmes de lecture.

Étapes suivantes

• Découvrez les caractéristiques audio et vidéo requises pour diffuser une vidéo en direct.
• Démarrez du bon pied avec l’API Live Video pour diffuser une vidéo en direct.