Présentation

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

Composants

Diffusions

Les diffusions de vidéos en direct sont représentées par des objets vidéo en direct. En manipulant les propriétés de l’objet vidéo en direct, 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 vidéo en direct sont associés aux objets streaming d’entrée vidéo en direct, qui représentent les données de diffusion. Les objets streaming d’entrée vidéo en direct sont créés et gérés automatiquement pour vous.

Les diffusions peuvent être créées sur les objets utilisateur, page, groupe ou évènement à l’aide de leur arête /live_videos.

URL de streaming

Les URL de streaming sont des URL de réception que vous pouvez utiliser pour streamer les données de vidéos en direct depuis votre encodeur vers un objet vidéo en direct. Lorsque vous utilisez l’API pour créer un objet vidéo en direct, l’API renvoie un ID d’objet vidéo en direct 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.

Protocoles de réception

L'API Video Live prend en charge le protocole RTMPS.

RTMPS

Les données diffusées sur une URL de réception doivent être chiffrées à l’aide du protocole de transfert de données RTMPS. Lorsque vous créez un objet vidéo en direct, l’API renvoie une URL de streaming RTMPS sécurisée que vous pouvez utiliser pour faire du streaming sur nos serveurs.

Voici des exemples de fournisseurs de logiciels et de matériel qui prennent en charge RTMPS :

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 les objets sondage vidéo dans l’API Graph et peuvent être créés avec le point de terminaison POST /{live-video-id}/polls sur un objet vidéo en direct. Une fois créé, l’API renvoie l’ID de l’objet sondage vidéo, que vous pouvez utiliser pour modifier le sondage et envoyer des requêtes concernant les interactions des spectateurs et spectatrices.

Outils

Éditeur de vidéo en direct

Si vous utilisez un logiciel de streaming qui n’intègre pas l’API Live Video, vous pouvez utiliser notre éditeur de vidéo en direct pour obtenir des URL de streaming et les ajouter manuellement au logiciel de streaming de votre choix (OBS, XSplit, etc.). L’éditeur de vidéo en direct vous permet de créer des diffusions sur votre propre profil d’utilisateur·ice ou des pages, des groupes ou des é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.

Caractéristiques vidéo

Pour obtenir une liste exhaustive des caractéristiques audio et vidéo, veuillez consulter les références.