Risolvere i problemi

Questa pagina mostra come risolvere i problemi relativi all'API Live Stream. Gli errori mostrati in questa pagina riguardano esclusivamente l'API Live Stream. Per informazioni sugli errori generici nelle API di Google, consulta la pagina Errori delle API Cloud.

Stream di input rifiutato

Se il tuo codificatore invia un flusso di input a un endpoint di input, ma la connessione continua a essere rifiutata, verifica questi possibili problemi:

URI dell'endpoint di input non valido

Si verifica un errore se il codificatore invia uno stream di input a un URI dell'endpoint di input non valido.

Per risolvere il problema, controlla se il codificatore è configurato per inviare il flusso di input a un URI dell'endpoint di input con l'indirizzo IP corretto e STREAM-ID.

L'ingresso non è collegato a un canale

Si verifica un errore se il codificatore invia uno stream di input a un URI dell'endpoint di input non collegato a un canale.

Per risolvere il problema, crea un nuovo canale con l'endpoint di input. Per verificare se un endpoint di input è stato collegato al canale, recupera i dettagli del canale e cerca il nome dell'endpoint di input nel campo inputAttachments.

Canale non attivo

Si verifica un errore se il tuo codificatore invia uno stream di input a un canale non in esecuzione.

Per risolvere il problema, controlla lo stato del canale per assicurarti che il suo streamingState sia AWAITING_INPUT. Se il streamingState del canale è STOPPED, avvia il canale.

Un altro codificatore già collegato con lo stesso endpoint di input

Si verifica un errore se più codificatori tentano di inviare flussi di input allo stesso endpoint di input. È accettata una sola connessione alla volta per ogni URI dell'endpoint di input.

Per risolvere il problema, controlla se il canale è già nello stato STREAMING. In questo caso, hai a disposizione le seguenti opzioni:

  • Crea un endpoint di input e un canale separati per il secondo flusso di input.

  • Arresta il primo flusso di input prima di inviarne un altro allo stesso endpoint di input.

L'indirizzo IP del codificatore non è compreso negli intervalli IP consentiti

Si verifica un errore se il tuo codificatore invia un flusso di input da un indirizzo IP al di fuori degli intervalli IP specificati configurati per un endpoint di input.

Per risolvere il problema, recupera i dettagli di un endpoint di input e controlla il campo securityRules. Se sono specificati ipRanges, assicurati che il codificatore abbia un indirizzo IP valido in questi intervalli IP.

File di output mancanti nel bucket Cloud Storage

Se il tuo codificatore invia correttamente un flusso di input all'endpoint di input, ma non viene visualizzato alcun file di output nel bucket Cloud Storage, verifica la presenza di questi possibili problemi:

Bucket Cloud Storage errato

Se stai controllando il bucket Cloud Storage errato, potrebbero mancare file di output.

Per risolvere il problema, recupera i dettagli del canale relativi al tuo live streaming. Verifica nel campo output.uri l'URI del bucket Cloud Storage corretto.

Codec video/audio con input non validi

I file di output potrebbero non essere disponibili se il tuo codificatore invia codec video o audio non validi.

Per risolvere il problema, assicurati che il codificatore stia inviando solo codec video H264 e AAC.

Autorizzazione Cloud Storage negata

Per impostazione predefinita, l'API Live Stream crea un account di servizio che può accedere ai bucket Cloud Storage nello stesso progetto Google Cloud che ospita le risorse dell'API Live Stream. I file di output potrebbero non essere disponibili se questo account di servizio perde l'autorizzazione ad accedere al bucket Cloud Storage.

Per risolvere il problema, assicurati che l'account di servizio disponga di autorizzazioni sufficienti. La creazione dei file di output potrebbe non riuscire per i seguenti motivi:

  • Il bucket Cloud Storage di output si trova in un progetto Google Cloud diverso dalle risorse dell'API Live Stream, come il canale e l'endpoint di input.

  • Le autorizzazioni predefinite vengono revocate dall'account di servizio.

Per ulteriori informazioni, vedi Accesso a Cloud Storage.

Tracce audio mancanti

Potrebbero mancare file di output se il codificatore invia uno stream di input con tracce audio mancanti. La pipeline video attende l'arrivo di tutte le tracce audio prima che inizi l'elaborazione.

Per risolvere il problema, recupera i dettagli del canale relativi al tuo live streaming. Assicurati che il codificatore stia inviando tutte le tracce audio configurate nel campo ElementaryStream.audioStream.mapping (AudioMapping).