Información general

Este documento proporciona información general sobre la API de vídeo en directo para realizar transmisiones en directo en Facebook.

Funcionamiento

Las transmisiones de vídeo en directo se representan mediante objetos LiveVideo en la API Graph. Para transmitir un vídeo en directo, primero debes usar la API para crear un objeto LiveVideo en un usuario, página o evento. Una vez creado, la API devolverá un identificador de objeto LiveVideo y una URL de transmisión de ingesta. A continuación, puedes usar la URL de transmisión para transmitir datos de vídeo en directo desde el codificador al objeto LiveVideo y usar el objeto para manipular la visibilidad de la transmisión.

Componentes

Transmisiones

Las transmisiones de vídeo en directo se representan mediante objetos LiveVideo. Al manipular las propiedades de un objeto LiveVideo, puedes controlar la transmisión del vídeo en directo. Por ejemplo, puedes cambiar la visibilidad de la transmisión del vídeo en directo, actualizar su descripción o título, añadir etiquetas, definir audiencias, añadir encuestas y muchas cosas más.

Los objetos LiveVideo están asociados a objetos LiveVideoInputStream, que representan los datos de transmisión de ingesta de la transmisión. Los objetos LiveVideoInputStream se crean y administran automáticamente.

Las transmisiones se pueden crear en objetos de usuario, página o evento mediante su perímetro /live_videos.

URL de transmisión

Las URL de transmisión son URL de ingesta que puedes usar para transmitir datos de vídeo en directo desde el codificador a un objeto LiveVideo. Cuando uses la API para crear un objeto LiveVideo, la API responderá con un identificador de objeto LiveVideo y una URL de transmisión única. La URL de transmisión debe utilizarse en un plazo de 24 horas. De lo contrario, caducará. Una vez utilizada, una URL de transmisión se puede transmitir durante un máximo de 8 horas.

RTMPS

Las transmisiones de vídeo en directo se deben cifrar con el protocolo de transferencia de datos RTMPS. Al iniciar una transmisión, la API devolverá una URL de transmisión segura RTMPS que deberás utilizar al realizar la transmisión en nuestros servidores.

Votaciones

Puedes utilizar la API para crear votaciones en transmisiones de vídeo en directo y obtener respuestas en tiempo real de los espectadores. Las votaciones se representan mediante objetos VideoPoll en la API Graph y se pueden crear con el extremo POST /LIVE_VIDEO_ID/polls en un objeto LiveVideo. Una vez creadas, la API devolverá un identificador de objeto VideoPoll que podrás usar para manipular la votación y consultar las interacciones de los espectadores.

Herramientas

Editor de vídeo en directo

Si utilizas un software de transmisión que no se integra con la API de vídeo en directo, puedes utilizar nuestra herramienta Editor de vídeo en directo para obtener las URL de transmisión y conectarlas con tu software de transmisión preferido manualmente. El Editor de vídeo en directo te permite crear transmisiones en tu propio perfil de usuario o en las páginas o eventos que administras.

Ingestas en directo

La calidad de la transmisión de vídeo en directo empieza por una conexión fiable con nuestros servidores. Las conexiones de mala calidad pueden provocar una calidad de vídeo deficiente, interrupciones en la reproducción y errores de transmisión. La herramienta Ingestas en directo te permite probar la calidad de la ingesta para que puedas diagnosticar problemas de conexión, identificar el mejor servidor de ingesta de vídeo para la transmisión y proporcionar transmisiones de alta calidad con menos problemas de reproducción.

Siguientes pasos

• Obtén más información sobre las especificaciones de audio y vídeo necesarias para transmitir un vídeo en directo.
• Introducción a la API de vídeo en directo para transmitir un vídeo en directo.