Primeros pasos

En este documento, se explica cómo puedes usar la API de video en vivo para crear una transmisión de video en vivo en tu perfil de usuario mediante tu app. Si no tienes una app, puedes usar el explorador de la API Graph y software de streaming gratuito, como OBS o Player.me.

Antes de empezar

Necesitarás acceso a lo siguiente:

Una cuenta de desarrollador de Facebook
Una app de Facebook registrada con la configuración básica lista

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

Software de streaming de video
Conocimientos básicos del explorador de la API Graph

1. Configurar el inicio de sesión con Facebook

En el panel de apps, agrega el producto Inicio de sesión con Facebook a tu app.

Puedes dejar todos los ajustes con los valores predeterminados. Si estás implementando el inicio de sesión con Facebook de manera manual (no recomendado), ingresa tu redirect_uri en el campo "URI de redireccionamiento de OAuth válidos". Si deseas usar uno de nuestros SDK, puedes dejar el campo en blanco.

2. Implementar el inicio de sesión con Facebook

Sigue las indicaciones de nuestra documentación sobre el inicio de sesión con Facebook correspondiente a tu plataforma e implementa esta función 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.

Tu app debe tener los siguientes permisos:

publish_video

Si tu app no está lista aún y usas el explorador de la API Graph y software de streaming, puedes omitir este paso.

3. Obtener un token de acceso

Después de implementar el inicio de sesión con Facebook, asegúrate de haber iniciado sesión en tu cuenta de desarrollador de Facebook y, luego, accede a tu app y activa el cuadro de diálogo de inicio de sesión con Facebook. Si usas el explorador de la API Graph, selecciona tu app en el menú desplegable de la app de Facebook y haz clic en el botón Generar token de acceso.

Después activar el cuadro de diálogo, haz clic en el menú desplegable y selecciona Solo yo para ser la única persona que puede ver la transmisión. Haz clic en Aceptar y, en el siguiente cuadro de diálogo, haz nuevamente clic en Aceptar para otorgar a tu app el permiso publish_video. La API devolverá un token de acceso de usuario. Captura el token para que tu app pueda usarlo en las siguientes consultas.

Si estás usando el explorador de la API Graph, el token se captura automáticamente y se muestra en el campo Token de acceso para referencia:

4. Crear un objeto LiveVideo

Ahora que tienes un token de acceso con el permiso publish_video, puedes usarlo para crear un objeto LiveVideo en tu perfil de usuario.

Envía una solicitud al punto de conexión POST /me/live_videos?status=LIVE_NOW. Por ejemplo:

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

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.

5. Realizar el stream a la URL de stream segura

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

Por ejemplo, en OBS, elige OBS > Preferencias. Se abre la pantalla de configuración. Configura el Servicio como Facebook Live, agrega la URL del stream en Configuración > Stream > Clave de stream y, luego, inicia el stream.

6. Finalizar la transmisión

Después de haber verificado que estés transmitiendo video en vivo en el perfil, finaliza la transmisión. Para hacerlo, envía la solicitud correspondiente al punto de conexión POST /{live-video-id}?end_live_video=true. Por ejemplo:

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

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}.

Próximos pasos

Busca más ejemplos de uso de la API de video en vivo para programar un video en vivo, publicar en una página o un grupo y recibir reacciones y comentarios de los usuarios en Usos comunes.