Introducción

En este documento se explica cómo usar la API de vídeo en directo para transmitir un vídeo en directo con tu aplicación. Si no tienes ninguna aplicación, puedes usar el explorador de la API Graph y el software de transmisión que prefieras.

Antes de empezar

Si tienes una aplicación, necesitarás lo siguiente:

• Un identificador de aplicación de Meta con el caso de uso del inicio de sesión con Facebook
• El inicio de sesión con Facebook implementado en la aplicación

  • Si la aplicación se encuentra en un dispositivo que no tiene una interfaz que permita a los usuarios iniciar sesión en Facebook, implementa el inicio de sesión con Facebook para dispositivos en su lugar.
• Los siguientes permisos: publish_video
• Un identificador de acceso

Si no tienes ninguna aplicación, también necesitarás lo siguiente:

• El explorador de la API Graph
• Software de transmisión de vídeo

Iniciar la transmisión

Para crear un objeto LiveVideo, envía una solicitud POST al extremo /me/live_videos?status=LIVE_NOW en la que me sea el identificador del usuario o la página.

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

Esto devolverá una respuesta similar a esta:

{ 
  "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": []
}

Registra los valores de id y secure_stream_url que se te han devuelto. id es el identificador del objeto LiveVideo, que puedes usar para modificar la transmisión. secure_stream_url es la URL de ingesta que usarás para transmitir datos de vídeo en directo desde el codificador al objeto LiveVideo.

Realizar la transmisión

Pasa el valor de secure_stream_url que registraste en el paso anterior al dispositivo de codificación y transmite datos de vídeo en directo. Cuando el objeto LiveVideo detecte los datos de la transmisión, se transmitirán en directo en tu perfil de usuario.

Visualiza el perfil y comprueba que se haya creado una nueva publicación con vídeo en directo y que se estén transmitiendo los datos de la transmisión.

Si usas software de transmisión en lugar de desarrollar tu propia aplicación, debes añadir el valor de secure_stream_url al software manualmente. En función del software de transmisión que uses, es posible que debas dividir la URL de transmisión entre el servidor (rtmps://rtmp-api.facebook.com/rtmp/) y los componentes clave (los elementos que siguen a /rtmp/).

Finalizar la transmisión

Para finalizar la transmisión, envía una solicitud POST al extremo /<LIVE_VIDEO_ID>?end_live_video=true.

Ejemplo de solicitud de finalización de la transmisión

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

Esto finalizará la transmisión y la guardará como vídeo bajo demanda (VOD). Si quieres eliminar el vídeo a petición, envía una solicitud al extremo DELETE /<LIVE_VIDEO_ID>.

Códigos de error de permisos denegados

Siguientes pasos

• Usa la API de vídeo en directo para programar un vídeo en directo para una futura transmisión.