Começar

Este documento explica como usar a API de Vídeo ao Vivo para fazer uma transmissão ao vivo usando seu app. É possível usar o Explorador da Graph API e o software de streaming de sua escolha caso você não tenha um app.

Antes de começar

Se você tiver um app, precisará do seguinte:

• Um ID do app da Meta com o caso de uso do Login do Facebook
• Login do Facebook implementado no seu app

  • Se o app estiver em um dispositivo sem interface de login no Facebook, implemente o Login do Facebook para Dispositivos.
• As seguintes permissões: publish_video
• Um token de acesso

Se você não tiver um app, também precisará destes itens:

• O Explorador da Graph API
• Software de stream de vídeo

Iniciar a transmissão

Para criar um objeto LiveVideo, envie uma solicitação POST ao ponto de extremidade /me/live_videos?status=LIVE_NOW em que me é a identificação do usuário ou da Página.

curl -i -X POST \
 "https://graph.facebook.com/v25.0/me/live_videos?status=LIVE_NOW"

A resposta retornada será semelhante a esta:

{ 
  "id": "10214937378883406",  //The LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.faceboo...",
  "secure_stream_url": "rtmps://rtmp-api.faceboo...", //The stream URL
  "stream_secondary_urls": [],
  "secure_stream_secondary_urls": []
}

Capture os valores id e secure_stream_url retornados. O número id é a identificação do objeto LiveVideo que você pode usar para manipular a transmissão. O secure_stream_url é a URL de ingestão que você usará para fazer stream dos dados de vídeo ao vivo do codificador para o objeto LiveVideo.

Fazer um streaming da transmissão

Passe o valor secure_stream_url que você capturou na última etapa ao dispositivo de codificação e transmita os dados de vídeo ao vivo para ele. Quando o objeto LiveVideo detectar os dados, a transmissão entrará ao vivo no perfil de usuário.

Visualize seu perfil para verificar se um novo post de vídeo ao vivo foi criado e está transmitindo os dados de streaming.

Se você estiver usando um software de streaming em vez de desenvolver o próprio app, adicione manualmente o valor secure_stream_url ao software. Dependendo do software de streaming, pode ser necessário dividir a URL de stream no servidor dela (rtmps://rtmp-api.facebook.com/rtmp/) e nos componentes importantes (todas as informações depois de /rtmp/).

Finalizar a transmissão

Para encerrar a transmissão, envie uma solicitação POST ao ponto de extremidade /<LIVE_VIDEO_ID>?end_live_video=true.

Exemplo de solicitação para encerrar a transmissão

curl -i -X POST \
  "https://graph.facebook.com/v25.0/<LIVE_VIDEO_ID>?end_live_video=true"

Com isso, a transmissão será encerrada e salva como um vídeo sob demanda (VOD, pelas iniciais em inglês). Para excluir o VOD, envie uma solicitação ao ponto de extremidade DELETE /<LIVE_VIDEO_ID>.

Códigos de erro de permissão negada

Próximas etapas

• Use a API de Vídeo ao vivo para agendar um vídeo ao vivo em uma transmissão futura.