Démarrer

Ce document explique comment utiliser l’API Live Video pour diffuser une vidéo en direct à l’aide de votre application. Si vous n’avez pas encore d’application, vous pouvez utiliser l’Explorateur de l’API Graph et le logiciel de streaming de votre choix.

Avant de commencer

Si vous n’avez pas d’application, vous aurez également besoin des éléments suivants :

• Un ID d’application Meta associé au cas d’utilisation Facebook Login
• Facebook Login implémenté dans votre application

  • Si votre application se trouve sur un appareil qui ne dispose pas d’une interface permettant aux utilisateur·ices de se connecter à Facebook, implémentez plutôt Facebook Login pour les appareils .
• Les autorisations suivantes : publish_video
• Un token d’accès

Si vous n’avez pas d’application, vous aurez également besoin des éléments suivants :

• L’ Explorateur de l’API Graph
• Logiciel de streaming vidéo

Démarrer la diffusion

Pour créer un objet LiveVideo, envoyez une requête POST au point de terminaison /me/live_videos?status=LIVE_NOWme est l’ID de l’utilisateur·ice ou de la Page.

curl -i -X POST \
 "https://graph.facebook.com/v21.0/me/live_videos?status=LIVE_NOW"

Une réponse similaire à celle-ci est renvoyée :

{ 
  "id": "10214937378883406",  //The LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.faceboo...",
  "secure_stream_url": "rtmps://rtmp-api.faceboo...", //The stream URL
  "stream_secondary_urls": [],
  "secure_stream_secondary_urls": []
}

Enregistrez les valeurs id et secure_stream_url qui ont été renvoyées. L’id est l’ID de l’objet LiveVideo que vous pouvez utiliser pour modifier votre diffusion. Le secure_stream_url est l’URL de réception que vous utiliserez pour streamer des données vidéo en direct depuis votre encodeur vers l’objet LiveVideo.

Streamer la diffusion

Transmettez à votre appareil d’encodage la valeur secure_stream_url que vous avez enregistrée lors de la dernière étape et diffusez les données vidéo en direct sur celui-ci. Une fois que l’objet LiveVideo détecte des données de streaming, la diffusion de la vidéo en direct commence sur votre profil d’utilisateur·ice.

Sur votre profil, vérifiez que la publication vidéo en direct a bien été créée et que vos données sont streamées.

Si vous utilisez un logiciel de streaming au lieu de votre propre application, ajoutez manuellement la valeur secure_stream_url dans votre logiciel. En fonction du logiciel de streaming que vous utilisez, vous devrez peut-être décomposer l’URL de streaming en deux : son serveur (rtmps://rtmp-api.facebook.com/rtmp/) et ses composants clés (tout ce qui se trouve après /rtmp/).

Mettre fin à la diffusion

Pour mettre fin à la diffusion, envoyez une requête POST au point de terminaison /<LIVE_VIDEO_ID>?end_live_video=true.

Exemple de requête d’arrêt de la diffusion

curl -i -X POST \
  "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?end_live_video=true"

Ceci met fin à votre diffusion et la sauvegarde la vidéo afin qu’elle puisse être rejouée à la demande (VOD). Pour supprimer la VOD, envoyez une requête au point de terminaison DELETE /<LIVE_VIDEO_ID>.

Codes d’erreur liés aux autorisations refusées

Étapes suivantes

• Programmez une vidéo en direct avec l’API Live Video pour une future diffusion.