Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.
Aggiornamento inglese: 3 gen 2022

Riferimento

Impostazioni raccomandate

Affinché la trasmissione sia eseguita con successo, il video in diretta deve:

  • Includere dati audio e video
  • Non superare 8 ore
  • Utilizzare le impostazioni raccomandate indicate di seguito (esempio: deve essere H264/AAC)
  • Inoltre, le impostazioni non devono essere modificate durante la trasmissione

Il mancato rispetto di questi requisiti potrebbe determinare:

  • Interruzione imprevista dello streaming
  • Minore qualità della trasmissione
  • Comportamenti inattesi

Impostazioni video

  • Dimensione dei fotogrammi chiave: 2 secondi consigliati. Non superare 4 secondi.
  • Risoluzione e bitrate:

    1080p a 60 FPS
    Risoluzione: 1920x1080
    Intervallo bitrate video: 4500-9000 Kbps

    1080p a 30 FPS
    Risoluzione: 1920x1080
    Intervallo bitrate video: 3000-6000 Kbps

    720p a 60 FPS
    Risoluzione: 1280x720
    Intervallo bitrate video: 2250-6000 Kbps

    720p a 30 FPS
    Risoluzione: 1280x720
    Intervallo bitrate video: 1500-4000 Kbps

    480p a 30 FPS
    Risoluzione: 854x480
    Intervallo bitrate video: 600-2000 Kbps

    360p
    Risoluzione: 640x360
    Intervallo bitrate video: 400-1000 Kbps

  • Protocollo: streaming RTMPS
  • Proporzioni pixel: l'ideale sarebbe 16:9; se sei troppo lontano da questo rapporto potremmo non essere in grado di supportare il tuo streaming
  • Codec video:
    • H.264, Livello 4.1 per valori fino a 1080p 30 FPS
    • H.264, Livello 4.2 per 1080p 60 FPS

Impostazioni audio

  • Codec audio: complessità ridotta AAC
  • Frequenza di campionamento: 44,1 kHz o 48 kHz
  • Bitrate audio: da 128 kbps (preferito) a 256 kbps (da non superare)
  • Layout canale: stereo

Endpoint

LiveVideo

EndpointDescrizione

DELETE /{live_video_id}

Eliminare un LiveVideo.

GET /{event-id}/live_videos

Ottenere una raccolta di LiveVideo su un Event.

GET /{group-id}/live_videos

Ottenere una raccolta di LiveVideo su un Group.

GET /{live-video-id}

Ottenere campi e segmenti di un LiveVideo.

GET /{live-video-id}/comments

Ottenere una raccolta di Comment su un LiveVideo.

GET /{live-video-id}/crosspost_shared_pages

Ottenere una raccolta di Page in grado di condividere un LiveVideo.

GET /{live-video-id}/likes

Ottenere una raccolta di Profile che hanno messo "Mi piace" a un LiveVideo.

GET /{live-video-id}/polls

Ottenere una raccolta di VideoPoll di un LiveVideo.

GET /{live-video-id}/reactions

Ottenere una raccolta di Profile che hanno aggiunto una reazione a un LiveVideo.

GET /{page-id}/live_videos

Ottenere una raccolta di LiveVideo su una Page.

GET /{user-id}/live_videos

Ottenere una raccolta di LiveVideo su un User.

POST /{event-id}/live_videos

Creare un LiveVideo su un Event.

POST /{group-id}/live_videos

Creare un LiveVideo su un Group.

POST /{live_video_id}

Aggiornare i campi di un LiveVideo.

POST /{live_video_id}/input_streams

Creare un LiveVideoInputStream su un LiveVideo.

POST /{live_video_id}/polls

Creare un VideoPoll su un LiveVideo.

POST /{page-id}/live_videos

Creare un LiveVideo su una Page.

POST /{user-id}/live_videos

Creare un LiveVideo su un User.

LiveVideoInputStream

Poll

EndpointDescrizione

GET /{live-video-id}/polls

Ottenere una raccolta di VideoPoll di un LiveVideo.

GET /{video-poll-id}

Ottenere campi e segmenti di un VideoPoll.

POST /{live_video_id}/polls

Creare un VideoPoll su un LiveVideo.

POST /{video_poll_id}

Aggiornare i campi di un VideoPoll.

Codici di errore

I messaggi di errore saranno inviati tramite RTMP all'API Graph. Puoi utilizzare l'ID trasmissione/video ed effettuare query per gli errori nel Tool di esplorazione per la API Graph tramite una richiesta GET. Gli errori restituiti conterranno il codice di errore, la descrizione e una marca temporale.

error_subcodeRiepilogo erroreDescrizione
COPYRIGHT__LIVE_COPYRIGHT_VIOLATION

Violazione copyright video in diretta

Il video in diretta è stato interrotto perché potrebbe includere contenuto audio o video appartenente a un'altra Pagina.

VIDEO__CREATE_FAILED

Problema di caricamento

Si è verificato un problema e il tuo video non è stato caricato. Riprova.

LIVE_VIDEO__DELETE_FAILED

Video in diretta non eliminato

Si è verificato un problema e non è stato possibile eliminare il video in diretta. Riprova.

LIVE_VIDEO__EDIT_API_NOT_ALLOWED

La modifica mediante API Video non è consentita mentre il video è in diretta

Non è consentito modificare un video in diretta attraverso l'API Video Edit. Utilizza l'ID del video in diretta.

LIVE_VIDEO__LIVE_STREAM_ERROR

Errore generico relativo allo streaming

Si è verificato un errore durante lo streaming

LIVE_VIDEO__NOT_EXIST

Il video in diretta non esiste

Il video in diretta a cui stai provando ad accedere non è più presente nel sistema.

LIVE_VIDEO__PRIVACY_REQUIRED

Impostazione privacy obbligatoria

Devi impostare la privacy prima della trasmissione in diretta.