Visão geral

As transmissões de vídeo ao vivo são representadas por objetos LiveVideo na Graph API. Para transmitir um vídeo ao vivo, primeiro use a API para criar um objeto LiveVideo em um Usuário, Página, Grupo ou Evento. Após a criação, a API retornará um ID do objeto LiveVideo e uma URL de streaming de ingestão. Depois, é possível transmitir dados de vídeo ao vivo do seu codificador para o objeto LiveVideo por meio da URL de stream e usar o objeto para manipular a visibilidade da transmissão.

Componentes

Transmissões

As transmissões de vídeo ao vivo são representadas por objetos LiveVideo. Ao manipular as propriedades de um objeto LiveVideo, é possível controlar a transmissão do vídeo ao vivo. Por exemplo, você pode alterar a visibilidade da transmissão do vídeo ao vivo, atualizar a descrição ou o título dele, adicionar rótulos, definir públicos, adicionar enquetes ou executar muitas outras ações.

Os objetos LiveVideo são associados a objetos LiveVideoInputStream, que representam os dados de streaming de ingestão da transmissão. Os objetos LiveVideoInputStream são criados e gerenciados automaticamente para você.

As transmissões podem ser criadas em objetos Usuário, Página, Grupo ou Evento usando a borda /live_videos deles.

URLs de stream

As URLs de stream são URLs de ingestão que podem ser usadas para transmitir os dados de vídeo ao vivo do seu codificador para o objeto LiveVideo. Quando você usa a API para criar um objeto LiveVideo, ela responderá com um ID de objeto LiveVideo e uma URL de stream exclusiva. A URL de stream precisa ser usada em até 24 horas antes de expirar. Após usada, a URL de stream pode ser transmitida por até 8 horas.

Protocolos de ingestão

A API de Vídeo ao vivo é compatível com o protocolo RTMPS.

RTMPS

Os dados transmitidos para uma URL de stream de ingestão devem ser criptografados por meio do protocolo de transferência de dados RTMPS. Quando você cria um objeto LiveVideo, a API retorna uma URL de stream RTMPS segura que será usada na transmissão para nossos servidores.

Veja aqui exemplos de provedores de software e hardware compatíveis com RTMPS:

Enquetes

É possível usar a API para criar enquetes em transmissões de vídeo ao vivo e receber respostas em tempo real dos visualizadores. As enquetes são representadas por objetos VideoPoll na Graph API e podem ser criadas com o ponto de extremidade POST /{live-video-id}/polls em um objeto LiveVideo. Após a criação, a API retornará um ID do objeto VideoPoll, que pode ser usado para manipular a enquete e a consulta para interações com os visualizadores.

Ferramentas

Live Video Composer

Se você estiver usando um software de streaming que não se integra à API de Vídeo ao vivo, use nossa ferramenta Live Video Composer para obter URLs de stream e conectá-las manualmente ao seu software de streaming preferido (por exemplo, OBS, XSplit etc.). Com o Live Video Composer, é possível criar transmissões no seu próprio perfil de Usuário ou em Páginas, Grupos ou Eventos gerenciados por você.

Live Ingests

A qualidade da sua transmissão de vídeo ao vivo começa com uma conexão confiável aos nossos servidores. Conexões fracas podem resultar em vídeos de baixa qualidade, interrupções na reprodução e falhas nas transmissões. Com a ferramenta Live Ingests, é possível testar a qualidade de ingestão. Assim, você pode diagnosticar problemas de conexão, identificar o melhor servidor de ingestão de vídeo para a transmissão e fornecer transmissões de alta qualidade com menos problemas de reprodução.

Especificações de vídeo

Consulte nossa referência para ver uma lista completa de especificações de áudio e vídeo.