Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.

Actualización del documento en inglés: 16 nov. 2021

Referencia

Configuración recomendada

Para garantizar una transmisión correcta, el vídeo en directo debe cumplir los requisitos siguientes:

Incluir datos de audio y vídeo
No durar más de 8 horas
Utilizar la configuración recomendada, como se especifica a continuación (ejemplo: debe ser H264/AAC)
No cambiar la configuración durante la transmisión

El incumplimiento de estos requisitos puede dar lugar a las consecuencias siguientes:

Finalización imprevista de la transmisión
Reducción de la calidad para los espectadores
Comportamiento inesperado

Configuración de vídeo

Tamaño de fotograma clave: se recomiendan dos segundos. No superes los cuatro segundos.
Resolución y velocidad de bits:
1080p @ 60 FPS
Resolución: 1920 x 1080
Intervalo de velocidad de bits de vídeo: 4500-9000 Kbps
1080p @ 30 FPS
Resolución: 1920 x 1080
Intervalo de velocidad de bits de vídeo: 3000-6000 Kbps
720p @ 60 FPS
Resolución: 1280 x 720
Intervalo de velocidad de bits de vídeo: 2250-6000 Kbps
720p @ 30 FPS
Resolución: 1280 x 720
Intervalo de velocidad de bits de vídeo: 1500-4000 Kbps
480p @ 30 FPS
Resolución: 854 x 480
Intervalo de velocidad de bits de vídeo: 600-2000 Kbps
360p
Resolución: 640 x 360
Intervalo de velocidad de bits de vídeo: 400-1000 Kbps
Protocolo: transmisión RTMPS
Relación de aspecto del píxel: el objetivo es 16:9; si estás demasiado lejos de esta relación de aspecto, es posible que no podamos admitir la transmisión.
Códec de vídeo:
- H.264, nivel 4.1 para hasta 1080p 30 FPS
- H.264, nivel 4.2 para 1080p 60 FPS

Configuración de audio

Códec de audio: AAC de baja complejidad
Frecuencia de muestreo: 44,1 kHz o 48 kHz
Velocidad de bits de audio: de 128 kbps (preferida) a 256 kbps (no se debe superar)
Diseño de canal: estéreo

Extremos

LiveVideo

Extremo	Descripción
`DELETE /{live_video_id}`	Elimina un elemento LiveVideo.
`GET /{event-id}/live_videos`	Obtiene una colección de elementos LiveVideos de un objeto Event.
`GET /{group-id}/live_videos`	Obtiene una colección de elementos LiveVideos de un objeto Group.
`GET /{live-video-id}`	Obtiene los campos y los perímetros de un elemento LiveVideo.
`GET /{live-video-id}/comments`	Obtiene una colección de elementos Comments de un objeto LiveVideo.
`GET /{live-video-id}/crosspost_shared_pages`	Obtiene una colección de elementos Pages que puede compartir un objeto LiveVideo.
`GET /{live-video-id}/likes`	Obtiene una colección de elementos Profiles a quienes gustó un elemento LiveVideo.
`GET /{live-video-id}/polls`	Obtiene una colección de elementos VideoPolls de un objeto LiveVideo.
`GET /{live-video-id}/reactions`	Obtiene una colección de elementos Profiles que han reaccionado a un objeto LiveVideo.
`GET /{page-id}/live_videos`	Obtiene una colección de elementos LiveVideos de un objeto Page.
`GET /{user-id}/live_videos`	Obtiene una colección de LiveVideos en un elemento User.
`POST /{event-id}/live_videos`	Crea un elemento LiveVideo en un objeto Event.
`POST /{group-id}/live_videos`	Crea un elemento LiveVideo en un objeto Group.
`POST /{live_video_id}`	Actualiza los campos de un elemento LiveVideo.
`POST /{live_video_id}/input_streams`	Crea un elemento LiveVideoInputStream en un objeto LiveVideo.
`POST /{live_video_id}/polls`	Crea un elemento VideoPoll en un objeto LiveVideo.
`POST /{page-id}/live_videos`	Crea un elemento LiveVideo en un objeto Page.
`POST /{user-id}/live_videos`	Crea un elemento LiveVideo en un objeto User.

LiveVideoInputStream

Extremo	Descripción
`GET /{live-video-input-stream-id}`	Obtiene los campos y perímetros de un elemento LiveVideoInputStream.
`POST /{live_video_id}/input_streams`	Crea un elemento LiveVideoInputStream en un objeto LiveVideo.

Encuestas

Extremo	Descripción
`GET /{live-video-id}/polls`	Obtiene una colección de elementos VideoPolls de un objeto LiveVideo.
`GET /{video-poll-id}`	Obtiene los campos y perímetros de un elemento VideoPoll.
`POST /{live_video_id}/polls`	Crea un elemento VideoPoll en un objeto LiveVideo.
`POST /{video_poll_id}`	Actualiza los campos de un elemento VideoPoll.

Códigos de error

Los mensajes de error se enviarán a través de RTMP y persistirán en la API Graph. Puedes utilizar el identificador del vídeo o la transmisión y consultar los errores en el explorador de la API Graph mediante una solicitud GET. Los errores devueltos incluirán el código de error, una descripción y una marca de tiempo.

error_subcode	Resumen del error	Descripción
`COPYRIGHT__LIVE_COPYRIGHT_VIOLATION`	Infracción de copyright en directo	El vídeo en directo se ha detenido porque podría incluir contenido de audio o visual que pertenece a otra página.
`VIDEO__CREATE_FAILED`	Problema de subida	Ha habido un problema y no se pudo subir el vídeo. Vuelve a intentarlo.
`LIVE_VIDEO__DELETE_FAILED`	El vídeo en directo no se eliminó	Ha habido un problema y no hemos podido eliminar el vídeo en directo. Vuelve a intentarlo.
`LIVE_VIDEO__EDIT_API_NOT_ALLOWED`	No se puede realizar la edición en directo mediante una API de vídeo	No se puede editar un vídeo en directo mediante la API de edición de vídeo. Utiliza el identificador de vídeo en directo.
`LIVE_VIDEO__LIVE_STREAM_ERROR`	Transmisión genérica	Se produjo un error durante la transmisión.
`LIVE_VIDEO__NOT_EXIST`	El vídeo en directo no existe	El vídeo en directo al que intentas acceder ya no existe en el sistema.
`LIVE_VIDEO__PRIVACY_REQUIRED`	Se necesita la configuración de privacidad	Antes de la publicación, es necesario definir la privacidad.