Démarrer

Ce document explique comment utiliser l’API Live Video pour créer une diffusion vidéo en direct sur votre propre profil d’utilisateur·trice à l’aide de votre application. Si vous ne disposez d’aucune application, vous pouvez utiliser l’Explorateur de l’API Graph et un logiciel de streaming gratuit, comme OBS ou Player.me.

Avant de commencer

Vous devrez avoir accès aux éléments suivants :

Un compte de développeur Facebook
Une application Facebook enregistrée dont les paramètres de base sont configurés

Si vous ne disposez pas d’app, vous aurez également besoin :

D’un logiciel de streaming vidéo
De connaître les bases de l’Explorateur de l’API Graph

1. Configurer Facebook Login

Ajoutez le produit Facebook Login à votre app dans l’espace app.

Vous pouvez conserver tous les paramètres par défaut. Si vous implémentez manuellement Facebook Login (ce que nous ne recommandons pas), saisissez votre redirect_uri dans le champ URI de redirection OAuth valide. Si vous utilisez l’un de nos SDK, vous pouvez laisser ce champ vide.

2. Implémenter Facebook Login

Suivez les instructions de notre documentation Facebook Login concernant votre plateforme et implémentez Facebook Login dans votre application. Si votre application se trouve sur un appareil qui ne dispose pas d’une interface permettant aux utilisateurs et utilisatrices de se connecter à Facebook, implémentez plutôt Facebook Login pour les appareils.

Votre app aura besoin des autorisations suivantes :

publish_video

Si votre application n’est pas encore prête et si vous utilisez l’Explorateur de l’API Graph et un logiciel de streaming, vous pouvez ignorer cette étape.

3. Obtenir un token d’accès

Une fois que vous avez implémenté Facebook Login, assurez-vous d’être connecté·e à votre compte de développeur·euse Facebook, puis accédez à votre application et lancez la fenêtre modale Facebook Login. Si vous utilisez l’Explorateur de l’API Graph, sélectionnez votre application dans le menu déroulant App Facebook et cliquez sur le bouton Générer un token d’accès.

Une fois que vous avez lancé la fenêtre modale, cliquez sur le menu déroulant et sélectionnez Moi uniquement pour être le ou la seul·e à pouvoir voir la diffusion. Cliquez sur OK, puis cliquez de nouveau sur OK dans la fenêtre modale suivante pour accorder l’autorisation publish_video à votre application. L’API doit renvoyer un token d’accès utilisateur. Enregistrez ce token pour que votre application puisse l’utiliser pour les prochaines requêtes.

Si vous utilisez l’Explorateur de l’API Graph, il sera enregistré automatiquement et affiché dans le champ Token d’accès pour information :

4. Créer un objet vidéo en direct

Maintenant que vous avez un token d’accès avec l’autorisation publish_video, vous pouvez l’utiliser pour créer un objet vidéo en direct sur votre profil d’utilisateur·trice.

Envoyez une demande au point de terminaison POST /me/live_videos?status=LIVE_NOW. Par exemple :

curl -i -X POST \
 "https://graph.facebook.com/v3.3/me/live_videos?status=LIVE_NOW&access_token={access-token}"

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 vidéo en direct 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 de vidéos en direct depuis votre encodeur vers l’objet vidéo en direct.

5. Streamer sur une URL de streaming sécurisée

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 de vidéos en direct sur celui-ci. Une fois que l’objet vidéo en direct détecte des données de streaming, la diffusion de la vidéo en direct commence sur votre profil d’utilisateur·trice.

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/).

Par exemple, dans OBS, cliquez sur OBS > Préférences pour ouvrir l’écran des paramètres. pour ouvrir l’écran des paramètres. Définissez le Service sur Facebook Live, ajoutez l’URL de streaming dans Paramètres > Streaming > Clé de stream, et démarrez votre stream.

6. Mettre fin à la diffusion

Une fois que vous avez vérifié que votre vidéo en direct est bien diffusée sur votre profil, mettez fin à la diffusion en envoyant une demande au point de terminaison POST /{live-video-id}?end_live_video=true. Par exemple :

curl -i -X POST \
  "https://graph.facebook.com/v3.3/{live-video-id}?end_live_video=true&access_token={access-token}"

Ceci met fin à la vidéo et la sauvegarde afin qu’elle puisse être rejouée à la demande (VOD). Pour supprimer la VOD, envoyez une demande au point de terminaison DELETE /{live-video-id}.

Étapes suivantes

Pour plus d’exemples d’utilisation de l’API Live Video pour programmer une vidéo en direct, publier sur une Page ou un Groupe et obtenir les réactions et commentaires des utilisateurs et utilisatrices, veuillez consulter les usages courants.