Información general
Las transmisiones de vídeo en directo se representan mediante objetos LiveVideo en la API Graph. Para transmitir un vídeo en directo, en primer lugar, usa la API para crear un objeto LiveVideo en un usuario, página, grupo 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 con 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 los objetos de usuario, página, grupo 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 usas la API para crear un objeto LiveVideo, esta responderá con un identificador de objeto LiveVideo y una URL de transmisión única. La URL de transmisión debe utilizarse en un período 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.
Protocolos de ingesta
La API de vídeo en directo admite el protocolo RTMPS.
RTMPS
Los datos transmitidos a una URL de transmisión de ingesta se deben cifrar con el protocolo de transferencia de datos RTMPS. Al crear un objeto LiveVideo, la API devolverá una URL de transmisión segura RTMPS que podrás utilizar al realizar la transmisión en nuestros servidores.
A continuación, se muestran algunos ejemplos de proveedores de software y hardware que admiten RTMPS:
|
|
|
|
Las transmisiones de vídeo en directo en páginas y Workplace pueden utilizar el protocolo RTMP estándar sin cifrar hasta el 1 de noviembre de 2019. Después de esa fecha, RTMP ya no se admitirá. Al iniciar una transmisión en directo, la respuesta de la API incluirá una URL de transmisión RTMP que se puede utilizar para realizar transmisiones sin cifrar en nuestros servidores. Ten en cuenta que si usas RTMP y una clave de transmisión persistente, debes restablecer la clave y actualizar todos los dispositivos que la utilicen. De lo contrario, las transmisiones que inicies devolverán un error.
Encuestas
Puedes utilizar la API para crear encuestas en transmisiones de vídeo en directo y obtener respuestas en tiempo real de los espectadores. Las encuestas 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 utilizar para manipular la encuesta 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 (p. ej., OBS, XSplit, etc.) manualmente. El Editor de vídeo en directo te permite crear transmisiones en tu perfil de usuario o en páginas, grupos o eventos que administres.
Editor de vídeo en directoIngestas 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.
Ingestas en directoEspecificaciones de vídeo
Consulta esta referencia para obtener una lista completa de especificaciones de vídeo y audio.