Primi passi
Questo documento spiega come utilizzare l'API Live Video per trasmettere un video in diretta con la tua app. Se non hai un'app, puoi usare il Tool di esplorazione per la API Graph e un software di streaming di tua scelta.
Il 10 giugno 2024, Meta lancerà nuovi requisiti che dovranno essere soddisfatti prima che un account possa trasmettere in diretta su Facebook. I nuovi requisiti sono i seguenti:
- L'account Facebook deve essere attivo da almeno 60 giorni
- La Pagina Facebook o il profilo in modalità professionale deve avere almeno 100 follower
Prima di iniziare
Se possiedi un'app, avrai bisogno di:
- Facebook Login implementato nella tua 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.
- Le seguenti autorizzazioni:
publish_video
Se non possiedi un'app, avrai bisogno anche di:
- un software di streaming video.
Avviare la trasmissione in diretta
Per creare un oggetto LiveVideo, invia una richiesta POST all'endpoint /me/live_videos?status=LIVE_NOW in cui me è l'ID per l'utente o la Pagina.
Quando esegui il test di una chiamata API puoi includere il parametro access_token impostato sul tuo token d'accesso. Quando invece effettui chiamate protette dalla tua app, usa la classe del token d'accesso.
curl -i -X POST \
"https://graph.facebook.com/v21.0/me/live_videos?status=LIVE_NOW"
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.
Trasmettere in streaming
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/).
Terminare la trasmissione in diretta
Per terminare la trasmissione, invia una richiesta POST all'endpoint /<LIVE_VIDEO_ID>?end_live_video=true.
Esempio di richiesta di fine trasmissione
curl -i -X POST \
"https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?end_live_video=true"
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>.
Codici di errore autorizzazione negata
| Code | Subcode | Message | Type | Mitigation messaging |
|---|---|---|---|---|
200 | 1363120 | Permissions error | OAuthException | You’re not eligible to go live Your profile needs to be at least 60 days old before you can go live on Facebook. Learn more at https://www.facebook.com/business/help/167417030499767?id=1123223941353904 |
200 | 1363144 | Permissions error | OAuthException | You’re not eligible to go live You need at least 100 followers before you can go live from your profile. Learn more at https://www.facebook.com/business/help/167417030499767?id=1123223941353904 |
Passaggi successivi
- Usa l'API Live Video per programmare un video in diretta per una trasmissione futura.