Panoramica

Le trasmissioni di video in diretta sono rappresentate da oggetti LiveVideo nell'API Graph. Per trasmettere un video in diretta, utilizza innanzitutto l'API per creare un oggetto LiveVideo su un oggetto User, Page, Group o Event. Al termine della creazione, l'API restituirà un ID oggetto LiveVideo e un URL di streaming di inserimento. A questo punto puoi usare l'URL di streaming per trasmettere in streaming i dati del video in diretta dal codificatore all'oggetto LiveVideo e usare l'oggetto per manipolare la visibilità della trasmissione.

Componenti

Trasmissioni in diretta

Le trasmissioni di video in diretta sono rappresentate da oggetti LiveVideo. Manipolando le proprietà di un oggetto LiveVideo, puoi controllare la trasmissione in diretta del video. Ad esempio, puoi modificare la visibilità della trasmissione in diretta del video, aggiornare la descrizione o il titolo, aggiungere etichette, definire i gruppi di pubblico, aggiungere sondaggi o eseguire molte altre azioni.

Gli oggetti LiveVideo sono associati agli oggetti LiveVideoInputStream, i quali rappresentano i dati di streaming di inserimento della trasmissione. Gli oggetti LiveVideoInputStream vengono creati e gestiti automaticamente.

È possibile creare trasmissioni in diretta su oggetti User, Page, Group o Event usando il relativo segmento /live_videos.

URL di streaming

Gli URL di streaming sono URL di inserimento che puoi usare per trasmettere in streaming i dati del video in diretta dal codificatore a un oggetto LiveVideo. Quando usi l'API per creare un oggetto LiveVideo, l'API risponde con un ID oggetto LiveVideo e un URL di streaming unico. L'URL di streaming deve essere utilizzato entro 24 ore, trascorse le quali scade. Dopo l'uso, un URL di streaming può essere trasmesso per un massimo di 8 ore.

Protocolli di inserimento

L'API Live Video supporta il protocollo RTMPS.

RTMPS

I dati trasmessi in streaming a un URL di streaming di inserimento devono essere crittografati con il protocollo di trasferimento dei dati RTMPS. Quando crei un oggetto LiveVideo, l'API restituisce un URL di streaming sicuro RTMPS che puoi usare quando trasmetti in streaming sui nostri server.

Ecco alcuni esempi di fornitori di software e hardware che supportano RTMPS:

Sondaggi

Puoi usare l'API per creare sondaggi sulle trasmissioni di video in diretta e ottenere risposte in tempo reale dai tuoi spettatori. I sondaggi sono rappresentati da oggetti VideoPoll nell'API Graph e possono essere creati con l'endpoint POST /{live-video-id}/polls su un oggetto LiveVideo. Dopo la creazione, l'API restituisce un ID oggetto VideoPoll che puoi usare per manipolare il sondaggio ed effettuare una query per le interazioni degli spettatori.

Strumenti

Live Video Composer

Se utilizzi un software di streaming che non può essere integrato con l'API Live Video, puoi usare il nostro strumento Live Video Composer per ottenere URL di streaming e aggiungerli manualmente al tuo software di streaming preferito (ad esempio, OBS, XSplit, ecc.). Live Video Composer consente di creare trasmissioni in diretta sul tuo profilo utente oppure sulle pagine, sui gruppi o sugli eventi che gestisci.

Live Ingests

La qualità delle tue trasmissioni di video in diretta inizia con una connessione affidabile ai nostri server. Una connessione non ottimale può determinare video di bassa qualità, interruzioni della riproduzione e trasmissioni non riuscite. Lo strumento Live Ingests consente di testare la qualità degli inserimenti così da poter diagnosticare problemi di connessione, identificare il miglior server di inserimento video per la trasmissione e garantire trasmissioni di alta qualità con meno problemi di riproduzione.

Specifiche video

Consulta il nostro riferimento per una lista completa delle specifiche audio e video.