Este documento foi atualizado.
A tradução para Português (Brasil) não foi concluída ainda.
Atualização em inglês: 27 de dez de 2021

Referência

Configurações recomendadas

Para garantir uma transmissão bem-sucedida, é necessário que os vídeos ao vivo sigam estes requisitos:

  • Incluir dados de áudio e vídeo
  • Não exceder 8 horas
  • Usar as configurações recomendadas especificadas abaixo (por exemplo, deve ser H264/AAC)
  • Não alterar as configurações durante a transmissão

O não cumprimento dos requisitos pode resultar no seguinte:

  • Interrupção inesperada do stream
  • Baixa qualidade para os espectadores
  • Comportamento inesperado

Configurações de vídeo

  • Duração do quadro-chave: recomendamos 2 segundos. Não ultrapasse 4 segundos.
  • Resolução e taxa de bits:

    1080p @ 60 FPS
    Resolução – 1920 x 1080
    Faixa da taxa de bits do vídeo – 4.500 a 9.000 Kbps

    1080p @ 30 FPS
    Resolução – 1920 x 1080
    Faixa da taxa de bits do vídeo – 3.000 a 6.000 Kbps

    720p @ 60 FPS
    Resolução – 1280 x 720
    Faixa da taxa de bits do vídeo – 2.250 a 6.000 Kbps

    720p @ 30 FPS
    Resolução – 1280 x 720
    Faixa da taxa de bits do vídeo – 1.500 a 4.000 Kbps

    480p @ 30 FPS
    Resolução – 854 x 480
    Faixa da taxa de bits do vídeo – 600 a 2.000 Kbps

    360p
    Resolução – 640 x 360
    Faixa da taxa de bits do vídeo – 400 a 1.000 Kbps

  • Protocolo: streaming RTMPS
  • Taxa de proporção de pixels: 16:9 é a proporção recomendada. Se o seu stream estiver muito longe desse valor, talvez ele não seja compatível.
  • Codec de vídeo:
    • H.264 nível 4.1 para no máximo 1080p a 30 FPS
    • H.264 nível 4.2 para 1080p a 60 FPS

Configurações de áudio

  • Codec de áudio: AAC de baixa complexidade
  • Taxa de amostragem: 44.1 kHz a 48 kHz
  • Taxa de bits de áudio: 128 kbps (preferencial) a 256 kbps (não ultrapassar)
  • Layout de canal: estéreo

Pontos de extremidade

LiveVideo

Ponto de extremidadeDescrição

DELETE /{live_video_id}

Exclui um LiveVideo.

GET /{event-id}/live_videos

Obtém uma coleção de LiveVideos em um evento.

GET /{group-id}/live_videos

Obtém uma coleção de LiveVideos em um grupo.

GET /{live-video-id}

Obtém campos e bordas em um LiveVideo.

GET /{live-video-id}/comments

Obtém uma coleção de comentários em um LiveVideo.

GET /{live-video-id}/crosspost_shared_pages

Obtém uma coleção de Páginas que podem compartilhar um LiveVideo.

GET /{live-video-id}/likes

Obtém uma coleção de perfis que curtiram um LiveVideo.

GET /{live-video-id}/polls

Obtém uma coleção de VideoPolls em um LiveVideo.

GET /{live-video-id}/reactions

Obtém uma coleção de perfis que reagiram a um LiveVideo.

GET /{page-id}/live_videos

Obtém uma coleção de LiveVideos em uma Página.

GET /{user-id}/live_videos

Obtém uma coleção de LiveVideos em um usuário.

POST /{event-id}/live_videos

Cria um LiveVideo em um evento.

POST /{group-id}/live_videos

Cria um LiveVideo em um grupo.

POST /{live_video_id}

Atualiza campos em um LiveVideo.

POST /{live_video_id}/input_streams

Cria um LiveVideoInputStream em um LiveVideo.

POST /{live_video_id}/polls

Cria uma VideoPoll em um LiveVideo.

POST /{page-id}/live_videos

Cria um LiveVideo em uma Página.

POST /{user-id}/live_videos

Cria um LiveVideo em um usuário.

LiveVideoInputStream

Polls

Ponto de extremidadeDescrição

GET /{live-video-id}/polls

Obtém uma coleção de VideoPolls em um LiveVideo.

GET /{video-poll-id}

Obtém campos e bordas em uma VideoPoll.

POST /{live_video_id}/polls

Cria uma VideoPoll em um LiveVideo.

POST /{video_poll_id}

Atualiza campos em uma VideoPoll.

Códigos de erro

As mensagens de erro serão enviadas via RTMP e aparecerão na Graph API. Você pode usar a identificação da transmissão ou do vídeo e consultar os erros na ferramenta Graph Explorer por meio de uma solicitação GET. Os erros retornados trarão o código de erro, a descrição e um registro de data e hora.

error_subcodeResumo do erroDescrição
COPYRIGHT__LIVE_COPYRIGHT_VIOLATION

Violação de direitos autorais em vídeo ao vivo

O vídeo ao vivo foi interrompido porque pode ter conteúdo visual ou de áudio pertencente a outra Página.

VIDEO__CREATE_FAILED

Problema ao carregar

Ocorreu um problema e o vídeo não foi carregado. Tente novamente.

LIVE_VIDEO__DELETE_FAILED

Vídeo ao vivo não excluído

Ocorreu um problema e não foi possível excluir o vídeo ao vivo. Tente novamente.

LIVE_VIDEO__EDIT_API_NOT_ALLOWED

Edição por API de vídeo não permitida para vídeos ao vivo

Não é permitida a edição de um vídeo ao vivo usando a API de edição de vídeo. Use a identificação de vídeo ao vivo.

LIVE_VIDEO__LIVE_STREAM_ERROR

Stream genérico

Houve um erro durante o stream.

LIVE_VIDEO__NOT_EXIST

O vídeo ao vivo não existe

O vídeo ao vivo que você está tentando acessar não existe mais no sistema.

LIVE_VIDEO__PRIVACY_REQUIRED

Configuração de privacidade exigida

Você precisa definir a privacidade antes de transmitir ao vivo.