Versão Graph API

Vídeos ao vivo de Grupo

Para mais informações sobre a API de Vídeo ao vivo, acesse nossa documentação sobre Vídeo ao vivo.

Criação

Você pode fazer uma solicitação POST para a borda live_videos a partir dos seguintes caminhos:

/{group-id}/live_videos

Ao publicar nessa borda, será criado um Vídeo ao vivo.

Parâmetros

Nome	Descrição
`app_attribution_tag` string numérica ou número inteiro	Uma tag de atribuição para vídeos ao vivo que será mostrada no feed.
`attribution_app_id` string numérica ou número inteiro	Identificação do app de atribuição.
`content_tags` list<numberic string>	Tags que descrevem o conteúdo do vídeo. Use o ponto de extremidade de pesquisa com o `type=adinterest` para obter as identificações possíveis. Exemplo de consulta: /search?type=adinterest&q=sunsets
`description` string em UTF-8	A descrição do vídeo ao vivo. Aceita emojis.
`encoding_settings` string	Identificador do grupo de configurações de decodificação que o transmissor está usando para a transmissão. Esse parâmetro atualmente só está em uso para transmissões 360 ao vivo. O valor a ser passado para esse parâmetro é o da chave `identifier` das configurações de decodificação predefinidas. As predefinições de decodificação podem ser encontradas com uma consulta ao ponto de extremidade da API Graph `/broadcaster_encoding_settings` (consulta `GET`).
`event_params` número inteiro	Registro de data e hora Unix de quando o transmissor planeja entrar ao vivo.
`fisheye_video_cropped` booleano	Indica se o vídeo em formato olho de peixe será cortado ou não.
`front_z_rotation` float	A rotação z frontal em graus no vídeo em formato olho de peixe.
`game_id` string numérica ou número inteiro	Defina sobre que jogo é o vídeo. Use o ponto de extremidade de pesquisa com o `type=game` para obter as identificações possíveis. Exemplo de consulta: /search?type=game&=pubg
`game_specs` Parâmetro de especificações do jogo	Defina os metadados que representam qual jogo deve ser atribuído.
`is_spherical` booleano	Sinalização que denota que a transmissão é 360 ao vivo.
`live_encoders` list<numberic string or integer>	Decodificadores ao vivo que transmitirão esse vídeo ao vivo.
`original_fov` int64	Campo original de visualização da câmera.
`post_surfaces_blacklist` list<enum{1, 2, 3, 4, 5}>	Uma lista de proibição sobre onde a publicação não aparecerá, para uma experiência somente no feed.
`privacy` Parâmetro de privacidade	Privacidade desse vídeo ao vivo.
`projection` enum{EQUIRECTANGULAR, CUBEMAP}	Sinalização que denota a projeção esperada de transmissões 360 ao vivo. O valor padrão é EQUIRECTANGULAR.
`save_vod` booleano	Se os dados do vídeo deverão ser salvos para consumo posterior no formato VOD ou não. O valor padrão é "true". (Observação: só pode ser definido no momento da criação)
`schedule_custom_profile_image` imagem	Imagem personalizada que aparecerá no story e lobby da live agendada.
`spatial_audio_format` enum{ambiX_4}	Denota o formato da transmissão de áudio espacial. Quando não especificado, presume-se que o áudio será mono ou estéreo.
`status` enum {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}	O status da transmissão. Uma transmissão `LIVE_NOW` está atualmente ao vivo e visível para os usuários. Uma transmissão `UNPUBLISHED` está em preparo e não está visível para os outros usuários. Uma transmissão não publicada poderá ser automaticamente excluída após muitas horas nesse estado. Considere usar os estados agendados para criar uma transmissão futura planejada.
`stereoscopic_mode` enum {MONO, LEFT_RIGHT, TOP_BOTTOM}	Defina essa sinalização no modo estereoscópico para o vídeo.
`stop_on_delete_stream`	Defina isso como `true` se a transmissão precisar ser interrompida quando o comando RTMP `deleteStream` for recebido.
`title` string em UTF-8	O título do vídeo ao vivo. Aceita emojis.

Tipo de retorno

Esse ponto de extremidade aceita leitura após gravação e lê o nó representado por id no tipo de retorno.

Struct { id: numeric string, stream_url: string, secure_stream_url: string, stream_secondary_urls: List [ string ], secure_stream_secondary_urls: List [ string ], dash_ingest_url: string, }

Regras para validação

Erro	Descrição
100	Parâmetro inválido
200	Erro de permissões

Leitura

Recursos

Nome	Descrição
API de Grupos	Esse é um recurso que exige análise do app.

Exemplo

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}/live_videos",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

GET /v7.0/{group-id}/live_videos HTTP/1.1
Host: graph.facebook.com

// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}/live_videos"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

/* make the API call */
FB.api(
    "/{group-id}/live_videos",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{group-id}/live_videos',
    'your-access-token'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

Saiba mais sobre a Graph API no guia sobre como usar a Graph API.

Parâmetros

Nome Descrição

Nome	Descrição
`broadcast_status` list<enum {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>	Permite que você especifique o tipo dos vídeos ao vivo que serão retornados. Se não houver nenhum valor, todos os tipos de status serão retornados.
`source` enum{target, owner}	Valor padrão: `target` A origem onde os vídeos devem ser consultados. Por exemplo, `target` obtém transmissões de vídeo em um grupo. Vídeos ao vivo de Grupo aceitam SOMENTE `target`.

broadcast_status

list<enum {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>

Permite que você especifique o tipo dos vídeos ao vivo que serão retornados. Se não houver nenhum valor, todos os tipos de status serão retornados.

source

enum{target, owner}

Valor padrão: target

A origem onde os vídeos devem ser consultados. Por exemplo, target obtém transmissões de vídeo em um grupo. Vídeos ao vivo de Grupo aceitam SOMENTE target.

Campos

A leitura a partir dessa borda retornará um resultado no formato JSON:

{ "data": [], "paging": {} }

data

Uma lista de campos de Vídeo ao vivo.

paging

Para mais detalhes sobre paginação, consulte o guia da Graph API.

Regras para validação

Erro	Descrição
200	Erro de permissões

Atualização

Não é possível executar essa operação no ponto de extremidade.

Exclusão

Não é possível executar essa operação no ponto de extremidade.