Questa pagina spiega come creare una risorsa canale con due flussi di input, dove un flusso di input può essere il backup dell'altro flusso di input.
Quando il failover automatico è attivato, se il flusso di input principale viene disconnesso a causa di problemi di rete, il canale passa automaticamente all'utilizzo del flusso di input di backup come origine di input. Una volta ripristinato lo stream di input principale, il canale torna automaticamente allo stream di input principale come sorgente di input. La funzionalità di failover automatico è facoltativa.
Devi assicurarti che lo stream di input principale e lo stream di input di backup siano identici se vuoi che lo stream di input di backup sostituisca completamente lo stream di input principale.
Puoi anche cambiare manualmente il flusso di input utilizzando un evento del canale.
Configura il progetto Google Cloud e l'autenticazione
Se non hai creato un Google Cloud progetto e le credenziali, consulta la sezione Prima di iniziare.Crea l'endpoint di input principale
Per creare l'endpoint di input principale, utilizza il metodo
projects.locations.inputs.create
.
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del tuo progetto Google Cloud ; si trova nel campo Numero progetto nella pagina Impostazioni IAMLOCATION
: la località in cui creare l'endpoint di input; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-south1
asia-northeast1
asia-southeast1
australia-southeast1
europe-north1
europe-west1
europe-west2
europe-west3
europe-west4
INPUT_ID
: un identificatore definito dall'utente per il nuovo endpoint di input da creare (a cui invii il flusso di input). Questo valore deve contenere da 1 a 63 caratteri, iniziare e terminare con[a-z0-9]
e può contenere trattini (-) tra i caratteri. Ad esempio:my-input
.
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream C#.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream Go.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream Java.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream Node.js.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream PHP.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream Python.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream Ruby.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Crea l'endpoint di input di backup
Per creare l'endpoint di input di backup, utilizza di nuovo il metodo
projects.locations.inputs.create
. Assicurati di utilizzare un ID input diverso da quello dell'endpoint di input principale.
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del tuo progetto Google Cloud ; si trova nel campo Numero progetto nella pagina Impostazioni IAMLOCATION
: la località in cui creare l'endpoint di input; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-south1
asia-northeast1
asia-southeast1
australia-southeast1
europe-north1
europe-west1
europe-west2
europe-west3
europe-west4
BACKUP_INPUT_ID
: un identificatore definito dall'utente per l'endpoint di input di backup da creare (e utilizzare se il flusso di input principale viene disconnesso a causa di problemi di rete); questo valore deve contenere da 1 a 63 caratteri, iniziare e terminare con[a-z0-9]
e può contenere trattini (-) tra i caratteri
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/BACKUP_INPUT_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream C#.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream Go.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream Java.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream Node.js.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream PHP.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream Python.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream Ruby.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Crea il canale
Per creare il canale, utilizza il
metodo
projects.locations.channels.create
. Per questo esempio, automaticFailover
è configurato per il primo allegato di input.
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del tuo progetto Google Cloud ; si trova nel campo Numero progetto nella pagina Impostazioni IAMLOCATION
: la località in cui creare il canale; utilizza una delle regioni supportateMostra localitàus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-south1
asia-northeast1
asia-southeast1
australia-southeast1
europe-north1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: un identificatore definito dall'utente per il canale da creare; questo valore deve contenere da 1 a 63 caratteri, iniziare e terminare con[a-z0-9]
e può contenere trattini (-) tra i caratteriINPUT_ID
: l'identificatore definito dall'utente per l'endpoint di input principaleBACKUP_INPUT_ID
: l'identificatore definito dall'utente per l'endpoint di input di backupBUCKET_NAME
: il nome del bucket Cloud Storage che hai creato
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/channels/CHANNEL_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream C#.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream Go.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream Java.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream Node.js.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream PHP.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Live Stream Python.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per scoprire come installare e utilizzare la libreria client per l'API Live Stream, consulta Librerie client dell'API Live Stream. Per saperne di più, consulta la documentazione di riferimento dell'API Live Stream Ruby.
Per autenticarti nell'API Live Stream, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Cambiare manualmente l'ingresso
Per passare manualmente dall'input principale all'input di backup (ad esempio, da my-primary-input
a my-backup-input
), crea un evento di canale.
Dopo un cambio manuale, puoi disconnettere e riconnettere my-primary-input
come preferisci. Il
canale non passa a questo ingresso al momento della riconnessione, come farebbe con le
impostazioni di failover automatico predefinite.
Per tornare a my-primary-input
, esegui una delle seguenti operazioni:
- Crea un nuovo
inputSwitch
evento in cuiinputKey
è impostato sumy-primary-input
. Questo evento torna all'input principale senza ripristinare le impostazioni di failover automatico. - Aggiorna il canale per abilitare il failover automatico. Per ulteriori informazioni, consulta la sezione Evento di input interruttore.