Primeros pasos

En este documento, se explica cómo usar la API de video en vivo para transmitir video en vivo con tu app. Si no tienes una app, puedes usar el explorador de la API Graph y el software de streaming que prefieras.

Antes de empezar

Si tienes una app, necesitarás lo siguiente:

• Un identificador de la app de Meta con el caso de uso de inicio de sesión con Facebook
• Inicio de sesión con Facebook implementado en tu app

  • Si tu app está en un dispositivo que no tiene una interfaz que permita a los usuarios iniciar sesión con Facebook, implementa el inicio de sesión con Facebook para dispositivos
• Los siguientes permisos: publish_video
• Un token de acceso

Si no tienes una app, también necesitarás lo siguiente:

• El explorador de la API Graph
• Software de streaming de video

Iniciar la transmisión

Para crear un objeto LiveVideo, envía una solicitud POST al punto de conexión /me/live_videos?status=LIVE_NOW donde 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"

Recibirás 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": []
}

Captura los valores de id y secure_stream_url incluidos en la respuesta. id es el identificador del objeto LiveVideo que puedes usar para manipular la transmisión. secure_stream_url es la URL de introducción que usarás para transmitir datos de video en vivo desde un codificador hacia el objeto LiveVideo.

Transmitir

Transmite el valor de secure_stream_url que capturaste en el paso anterior al dispositivo de codificación que estés usando y realiza stream de datos de video en vivo a este dispositivo. Cuando el objeto LiveVideo detecte los datos de streaming, la transmisión aparecerá en tu perfil de usuario.

Mira tu perfil y verifica que se haya creado una nueva publicación con video en vivo y que se estén transmitiendo tus datos de streaming.

Si estás usando software de streaming en lugar de desarrollar tu propia app, agrega manualmente el valor de secure_stream_url en el software. En función del software de streaming que uses, tal vez tengas que separar la URL del stream en el componente de servidor (rtmps://rtmp-api.facebook.com/rtmp/) y el componente de clave (todo lo que aparece después de /rtmp/).

Finalizar la transmisión

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

Ejemplo de solicitud de fin de transmisión

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

De esta manera, se finaliza la transmisión y se guarda como video a petición. Si deseas eliminar el video a petición, envía una solicitud al punto de conexión DELETE /<LIVE_VIDEO_ID>.

Códigos de error de permiso denegado

Próximos pasos

• Usa la API de video en vivo para programar un video en vivo para una transmisión futura.