Primi passi

Questo documento spiega come utilizzare l'API Live Video per creare una trasmissione video in diretta sul tuo profilo utente tramite la tua app. Se non possiedi un'app, puoi usare il Tool di esplorazione per la API Graph e un software di streaming gratuito come OBS o Player.me.

Prima di iniziare

Devi avere accesso a:

un account sviluppatore di Facebook;
un'app Facebook registrata con le impostazioni di base configurate.

Se non possiedi un'app, avrai bisogno anche di:

un software di streaming video;
conoscenza di base del Tool di esplorazione per la API Graph.

1. Configurazione di Facebook Login

Aggiungi il prodotto Facebook Login all'app nella Dashboard gestione app.

Puoi lasciare tutte le impostazioni predefinite. Se decidi di implementare Facebook Login manualmente (opzione che sconsigliamo), immetti il tuo redirect_uri nel campo URI di reindirizzamento OAuth validi. Se intendi usare uno dei nostri SDK, puoi lasciare vuoto questo campo.

2. Implementazione di Facebook Login

Segui la nostra documentazione su Facebook Login per la tua piattaforma e implementa Facebook Login nell'app. Se l'interfaccia del dispositivo che ospita l'app non consente agli utenti di accedere a Facebook, implementa allora Facebook Login per i dispositivi.

La tua app avrà bisogno delle seguenti autorizzazioni:

publish_video

Se la tua app non è ancora pronta e stai utilizzando il Tool di esplorazione per la API Graph e il software di streaming, puoi saltare questo passaggio.

3. Acquisizione di un token d'accesso

Dopo aver implementato Facebook Login, assicurati di aver effettuato l'accesso al tuo account sviluppatore di Facebook, quindi accedi all'app e attiva la finestra modale di Facebook Login. Se stai utilizzando il Tool di esplorazione per la API Graph, seleziona l'app dal menu a discesa App Facebook e clicca sul pulsante Genera token d'accesso.

Una volta attivata la finestra modale, clicca sul menu a discesa e seleziona Solo io, in questo modo sarai l'unica persona a visualizzare la trasmissione in diretta. Clicca su OK e, nella finestra modale seguente, clicca ancora su OK per concedere alla tua app l'autorizzazione publish_video. L'API restituisce un token d'accesso dell'utente. Acquisisci il token in modo che la tua app possa usarlo nelle query successive.

Se stai utilizzando il Tool di esplorazione per la API Graph, il token verrà acquisito automaticamente e visualizzato nel campo Token d'accesso come riferimento:

4. Creazione di un oggetto LiveVideo

Ora che disponi di un token d'accesso con l'autorizzazione publish_video, puoi usarlo per creare un oggetto LiveVideo sul tuo profilo utente.

Invia una richiesta all'endpoint POST /me/live_videos?status=LIVE_NOW. Ad esempio:

curl -i -X POST \
 "https://graph.facebook.com/v3.3/me/live_videos?status=LIVE_NOW&access_token={access-token}"

Questo restituirà una risposta simile alla seguente:

{ 
  "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": []
}

Acquisisci i valori id e secure_stream_url restituiti. Il valore id indica l'ID dell'oggetto LiveVideo, che ti consente di manipolare la trasmissione in diretta. Il valore secure_stream_url indica l'URL inserito che userai per trasmettere in streaming i dati del video in diretta dal codificatore all'oggetto LiveVideo.

5. Trasmissione in streaming all'URL di streaming sicuro

Passa il valore secure_stream_url acquisito nel passaggio precedente al dispositivo di codifica e trasmetti in streaming i dati del video in diretta al dispositivo. Quando l'oggetto LiveVideo avrà rilevato i dati di streaming, la diretta sarà trasmessa sul tuo profilo utente.

Vai sul tuo profilo e verifica che sia stato creato un nuovo post con video in diretta e che stia trasmettendo i tuoi dati di streaming.

Se hai deciso di utilizzare un software di streaming invece di sviluppare la tua app, aggiungi manualmente il valore secure_stream_url al software. A seconda del software di streaming che utilizzi, potresti dover suddividere l'URL di streaming nei componenti di server (rtmps://rtmp-api.facebook.com/rtmp/) e chiave (la parte che segue /rtmp/).

Ad esempio, in OBS, scegli OBS > Preferenze. Questa operazione apre la schermata Impostazioni. Imposta il Servizio su Facebook Live, aggiungi l'URL di streaming in Impostazioni > Streaming > Chiave per lo streaming, quindi avvia lo streaming.

6. Conclusione della trasmissione in diretta

Dopo aver verificato che il video in diretta viene trasmesso sul profilo, termina la trasmissione inviando una richiesta all'endpoint POST /{live-video-id}?end_live_video=true. Ad esempio:

curl -i -X POST \
  "https://graph.facebook.com/v3.3/{live-video-id}?end_live_video=true&access_token={access-token}"

Questa azione arresta la trasmissione e la salva come video on demand (VOD). Se desideri eliminare il VOD, invia una richiesta all'endpoint DELETE /{live-video-id}.

Passaggi successivi

Trovi altri esempi di utilizzo dell'API Live Video per pianificare un video in diretta, pubblicare su una Pagina o un gruppo e ottenere reazioni e commenti degli utenti negli Utilizzi comuni.