API de Vídeo ao Vivo

Referência

Em 10 de junho de 2024, a Meta lançará novos requisitos que precisarão ser atendidos antes que uma conta possa iniciar uma live no Facebook. Estes são os novos requisitos:

  • A conta do Facebook deve ter no mínimo 60 dias.
  • A Página do Facebook ou o perfil do modo profissional precisa ter pelo menos 100 seguidores.

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

Ponto de extremidadeDescrição

GET /{live-video-input-stream-id}

Obtém campos e bordas em um LiveVideoInputStream.

POST /{live_video_id}/input_streams

Cria um LiveVideoInputStream em um LiveVideo.

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.

Códigos de erro de permissão

CodeSubcodeMessageTypeMitigation messaging

200

1363120

Permissions error

OAuthException

You’re not eligible to go live

Your profile needs to be at least 60 days old before you can go live on Facebook. Learn more at https://www.facebook.com/business/help/167417030499767?id=1123223941353904

200

1363144

Permissions error

OAuthException

You’re not eligible to go live

You need at least 100 followers before you can go live from your profile. Learn more at https://www.facebook.com/business/help/167417030499767?id=1123223941353904

Obter suporte

Visit Meta for Developers Support to get help with a variety of issues, report a bug, view bug reports, and more.