Información general

Las transmisiones de video en vivo se representan mediante objetos LiveVideo en la API Graph. Si quieres transmitir un video en vivo, primero debes usar la API para crear un objeto LiveVideo en un usuario, una página, un grupo o un evento. Después de la creación, la API devuelve un identificador de objeto LiveVideo y una URL de introducción de streaming. Luego, puedes usar la URL de streaming para realizar stream de datos de video en vivo desde el codificador hacia el objeto LiveVideo y usar ese objeto para manipular la visibilidad de la transmisión.

Componentes

Transmisiones

Las transmisiones de video en vivo se representan mediante objetos LiveVideo. Al manipular las propiedades del objeto LiveVideo, puedes controlar la transmisión de video en vivo. Por ejemplo, puedes cambiar la visibilidad de la transmisión del video en vivo, actualizar la descripción o el título, agregar etiquetas, definir públicos, agregar encuestas y realizar muchas otras acciones.

Los objetos LiveVideo se asocian con objetos LiveVideoInputStream, que representan los datos de streaming de introducción de la transmisión. Los objetos LiveVideoInputStream se crean y administran automáticamente.

Las transmisiones se pueden crear en objetos User, Page, Group o Event mediante sus correspondientes perímetros /live_videos.

URL de stream

Las URL de stream son URL de introducción que puedes usar para realizar stream de datos de video en vivo desde un codificador hacia un objeto LiveVideo. Cuando usas la API para crear un objeto LiveVideo, la API responde con un identificador de objeto LiveVideo y una URL de stream única. La URL de stream se debe usar dentro de las 24 horas de haber sido generada; después de ese período, caduca. Una vez utilizada, la URL de stream puede recibir datos de stream durante un máximo de 8 horas.

Protocolos de introducción

La API de video en vivo admite el protocolo RTMPS.

RTMPS

Los datos transmitidos hacia una URL de introducción de stream se deben cifrar mediante el protocolo de transferencia de datos RTMPS. Cuando creas un objeto LiveVideo, la API devuelve una URL de stream RTMPS segura que puedes usar al realizar streaming en nuestros servidores.

Estos son ejemplos de proveedores de software y de hardware que admiten RTMPS:

Encuestas

Puedes usar la API para crear encuestas en transmisiones de video en vivo y recibir respuestas en tiempo real de tus espectadores. Las encuestas se representan mediante objetos VideoPoll en la API Graph y se pueden crear con el punto de conexión POST /{live-video-id}/polls en un objeto LiveVideo. Al crearlas, la API devuelve un identificador de objeto VideoPoll que puedes usar para manipular la encuesta y consultar las interacciones de los espectadores.

Herramientas

Live Video Composer

Si usas software de streaming que no se integra con la API de video en vivo, puedes usar nuestra herramienta Live Video Composer para obtener URL de stream y conectarlas manualmente a tu software de streaming preferido (por ejemplo, OBS, XSplit, etc.). Live Video Composer te permite crear transmisiones en tu propio perfil de usuario o en páginas, grupos o eventos que administres.

Live Ingests

La calidad de una transmisión de video en vivo comienza con una conexión confiable a nuestros servidores. Si la conexión es mala, el video resultante puede ser de mala calidad; además, es posible que haya interrupciones en la reproducción y que la transmisión falle. La herramienta Live Ingests te permite probar la calidad de introducción de tu video para que puedas diagnosticar problemas de conexión, identificar el servidor de introducción de video óptimo para tu transmisión y proporcionar transmisiones de alta calidad con menos problemas de reproducción.

Especificaciones de video

Consulta nuestra referencia para obtener una lista completa de las especificaciones de audio y video.