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: 17 jun.

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

ExtremoDescripció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

ExtremoDescripció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

ExtremoDescripció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_subcodeResumen del errorDescripció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.