Versione API Graph

Video in diretta nei gruppi

Per maggiori informazioni sull'API Live Video, visita la nostra documentazione dedicata all'argomento.

Creazione

Puoi effettuare una richiesta POST al segmento live_videos dai seguenti percorsi:

/{group-id}/live_videos

Quando pubblichi su questo segmento, viene creato un video in diretta.

Parametri

Nome	Descrizione
`app_attribution_tag` stringa numerica o intero	Un tag di attribuzione per i video in diretta che sarà mostrato nel feed.
`attribution_app_id` stringa numerica o intero	ID dell'app di attribuzione.
`content_tags` lista<stringa numerica>	Tag che descrivono il contenuto del video. Usa l'endpoint di ricerca con `type=adinterest` per ottenere possibili ID. Esempio di query: /search?type=adinterest&q=sunsets
`description` stringa UTF-8	Descrizione del video in diretta. Supporta le emoji.
`encoding_settings` stringa	Identificativo del gruppo di impostazioni di codifica utilizzato per questo streaming dalla persona che trasmette. Questo parametro è attualmente in uso solo per trasmissioni in diretta a 360°. Il valore da passare a questo parametro corrisponde alla chiave `identifier` del valore predefinito delle impostazioni di codifica. I valori predefiniti di codifica possono essere recuperati interrogando l'endpoint dell'API Graph `/broadcaster_encoding_settings` (query `GET`).
`event_params` intero	Indicazione temporale Unix dell'inizio della trasmissione in diretta impostato dalla persona che trasmette.
`fisheye_video_cropped` booleano	Se il video in formato singolo fisheye è tagliato o no.
`front_z_rotation` float	Rotazione dell'asse z frontale in gradi sul video in formato singolo fisheye.
`game_id` stringa numerica o intero	Definisce il gioco oggetto di questo video. Usa l'endpoint di ricerca con `type=game` per ottenere possibili ID. Esempio di query: /search?type=game&=pubg
`game_specs` Parametro delle specifiche di gioco	Definisce i metadati che rappresentano il gioco da attribuire.
`is_spherical` booleano	Contrassegna la trasmissione come trasmissione in diretta a 360°.
`live_encoders` lista<stringa numerica o intero>	Codificatori per la diretta che trasmetteranno questo video in diretta.
`original_fov` int64	Campo visivo originale della videocamera.
`post_surfaces_blacklist` lista<enum{1, 2, 3, 4, 5}>	Una blacklist dei punti in cui il post non sarà visualizzato, per un'esperienza solo nel feed.
`privacy` Parametro della privacy	Privacy per questo video in diretta.
`projection` enum{EQUIRECTANGULAR, CUBEMAP}	Contrassegna la proiezione prevista per le dirette streaming a 360°. Il valore predefinito è EQUIRECTANGULAR.
`save_vod` booleano	Attivazione o disattivazione del salvataggio dei dati video per un consumo futuro in formato VOD. Il valore predefinito è true. Nota: può essere impostato solo al momento della creazione.
`schedule_custom_profile_image` immagine	Immagine personalizzata che sarà visualizzata nella sala d'attesa e nella storia in diretta programmata.
`spatial_audio_format` enum{ambiX_4}	Denota il formato dello streaming audio spaziale. Quando si presume che un audio non specificato sia mono o stereo.
`status` enum {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}	Lo stato della trasmissione in diretta. Una trasmissione `LIVE_NOW` è al momento in diretta e visibile agli utenti. Una trasmissione `UNPUBLISHED` è in preparazione e non visibile agli altri utenti. Una trasmissione non pubblicata potrebbe essere eliminata dopo diverse ore in questo stato. Considera la possibilità di usare gli stati programmati per creare una trasmissione in diretta pianificata per il futuro.
`stereoscopic_mode` enum {MONO, LEFT_RIGHT, TOP_BOTTOM}	Imposta questo contrassegno sulla modalità stereoscopica per questo video.
`stop_on_delete_stream`	Imposta questo valore su `true` se lo streaming deve essere interrotto alla ricezione di un comando RTMP `deleteStream`.
`title` stringa UTF-8	Il titolo del video in diretta. Supporta le emoji.

Tipo di valore restituito

Questo endpoint supporta la modalità read-after-write e leggerà il nodo rappresentato dall'id nel tipo di valore restituito.

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, }

Regole di convalida

Errore	Descrizione
100	Parametro non valido
200	Errore di autorizzazione

Lettura

Funzioni

Nome	Descrizione
API Groups	Questa funzione richiede l'analisi dell'app.

Esempio

/* 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 */

Scopri di più sull'API Graph nella nostra guida all'uso dell'API Graph.

Parametri

Nome Descrizione

Nome	Descrizione
`broadcast_status` lista<enum {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>	Ti consente di specificare il tipo di video in diretta da restituire. Nessun valore restituisce tutti i tipi di stato.
`source` enum{target, owner}	Valore predefinito: `target` L'origine da cui i video devono essere interrogati. Ad es., `target` determina la trasmissione dei video in un gruppo. I video in diretta nei gruppi supportano SOLO il valore `target`.

broadcast_status

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

Ti consente di specificare il tipo di video in diretta da restituire. Nessun valore restituisce tutti i tipi di stato.

source

enum{target, owner}

Valore predefinito: target

L'origine da cui i video devono essere interrogati. Ad es., target determina la trasmissione dei video in un gruppo. I video in diretta nei gruppi supportano SOLO il valore target.

Campi

La lettura da questo segmento restituirà un risultato in formato JSON:

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

data

Una lista di campi relativi ai video in diretta.

paging

Per maggiori informazioni sulla paginazione, consulta la guida all'API Graph.

Regole di convalida

Errore	Descrizione
200	Errore di autorizzazione

Aggiornamento

Non puoi eseguire questa operazione su questo endpoint.

Eliminazione

Non puoi eseguire questa operazione su questo endpoint.