Guida rapida per un live streaming MPEG-DASH
Questa pagina mostra come creare un job di live streaming MPEG-DASH di base utilizzando le impostazioni predefinite dell'API Live Stream e curl
, PowerShell o le librerie client.
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva Live Stream API.
gcloud services enable livestream.googleapis.com
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
-
Concedi i ruoli al tuo Account Google. Esegui questo comando una volta per ciascuno dei seguenti ruoli IAM:
roles/livestream.editor, roles/storage.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Sostituisci
PROJECT_ID
con l'ID progetto. - Sostituisci
EMAIL_ADDRESS
con il tuo indirizzo email. - Sostituisci
ROLE
con ogni singolo ruolo.
- Sostituisci
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva Live Stream API.
gcloud services enable livestream.googleapis.com
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
-
Concedi i ruoli al tuo Account Google. Esegui questo comando una volta per ciascuno dei seguenti ruoli IAM:
roles/livestream.editor, roles/storage.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Sostituisci
PROJECT_ID
con l'ID progetto. - Sostituisci
EMAIL_ADDRESS
con il tuo indirizzo email. - Sostituisci
ROLE
con ogni singolo ruolo.
- Sostituisci
crea un bucket Cloud Storage
Crea un bucket Cloud Storage in cui inserire i file manifest e di segmento del live streaming.
Console Google Cloud
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
- Fai clic su Crea bucket.
- Nella pagina Crea un bucket, inserisci le informazioni del bucket. Per andare al passaggio successivo, fai clic su Continua.
- In Assegna un nome al bucket, inserisci un nome che soddisfi i requisiti di denominazione dei bucket.
-
Per Scegli dove archiviare i tuoi dati, segui questi passaggi:
- Seleziona un'opzione Tipo di località.
- Seleziona un'opzione Località.
- Per Scegli una classe di archiviazione predefinita per i dati, seleziona quanto segue: Standard.
- Per Scegli come controllare l'accesso agli oggetti, seleziona un'opzione Controllo dell'accesso.
- In Impostazioni avanzate (facoltative), specifica un metodo di crittografia, un criterio di conservazione o le etichette dei bucket.
- Fai clic su Crea.
Riga di comando
-
Crea un bucket Cloud Storage:
gcloud storage buckets create gs://BUCKET_NAMESostituisci
BUCKET_NAME
con un nome di bucket che soddisfi i requisiti di denominazione dei bucket.
Installa un codificatore
Per utilizzare l'API, è necessario un codificatore per generare flussi di input elaborati dall'API.
Installa ffmpeg
. Questa pagina spiega
come utilizzare ffmpeg
per generare stream di input. Puoi installarlo in Cloud Shell utilizzando il seguente comando.
sudo apt install ffmpeg
Crea un endpoint di input
Per avviare un live streaming, devi prima utilizzare il metodo projects.locations.inputs.create
per creare un endpoint di input. Devi inviare il flusso di input a questo endpoint.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAMLOCATION
: la località in cui creare l'endpoint di input; usa una delle regioni supportateMostra localitàus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
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 un carattere e l'altro. Ad esempio:my-input
.
Per inviare la richiesta, espandi una delle seguenti 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 informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Copia il valore OPERATION_ID restituito per utilizzarlo nella sezione successiva.
Verifica il risultato
Utilizza il metodo projects.locations.operations.get
per verificare se l'endpoint di input è stato creato. Se la risposta contiene "done: false"
, ripeti il comando fino a quando la risposta non contiene "done: true"
.
La creazione del primo endpoint di input in una regione può richiedere fino a 10 minuti.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAMLOCATION
: la località in cui si trova 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-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
OPERATION_ID
: identificatore dell'operazione
Per inviare la richiesta, espandi una delle seguenti 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, "endTime": END_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.Input", "name": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "type": "RTMP_PUSH", "uri": INPUT_STREAM_URI, # For example, "rtmp://1.2.3.4/live/b8ebdd94-c8d9-4d88-a16e-b963c43a953b", "tier": "HD" } }
Trova il campo uri
e copia il INPUT_STREAM_URI restituito da utilizzare in un secondo momento nella sezione Invia lo stream di input.
Crei un canale
Per transcodificare lo stream di input in uno stream di output, devi creare una risorsa di canale.
Per creare un canale, utilizza il metodo projects.locations.channels.create
. Il seguente esempio crea un canale che genera un live streaming MPEG-DASH con una singola versione in alta definizione (1280 x 720).
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della 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-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: un identificatore definito dall'utente per il canale da creare; questo valore deve essere compreso tra 1 e 63 caratteri, iniziare e terminare con[a-z0-9]
e può contenere trattini (-) tra un carattere e un altroINPUT_ID
: l'identificatore definito dall'utente per l'endpoint di inputBUCKET_NAME
: il nome del bucket Cloud Storage creato per contenere il manifest del live streaming e i file dei segmenti
Per inviare la richiesta, espandi una delle seguenti 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 }
Scarica il canale
Puoi controllare il risultato dell'operazione di creazione del canale utilizzando il nuovo ID operazione.
Una volta creato il canale, utilizza il metodo projects.locations.channels.get
per eseguire query sullo stato del canale.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAMLOCATION
: la località in cui si trova il tuo 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-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: un identificatore del canale definito dall'utente
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/channels/CHANNEL_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "inputAttachments": [ { "key": "INPUT_ID", "input": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID" } ], "activeInput": "INPUT_ID", "output": { "uri": "gs://BUCKET_NAME" }, "elementaryStreams": [ { "videoStream": { "h264": { "widthPixels": 1280, "heightPixels": 720, "frameRate": 30, "bitrateBps": 3000000, "gopDuration": "2s", "vbvSizeBits": 3000000, "vbvFullnessBits": 2700000, "entropyCoder": "cabac", "profile": "high" } }, "key": "es_video" }, { "audioStream": { "codec": "aac", "bitrateBps": 160000, "channelCount": 2, "channelLayout": ["fl", "fr"], "sampleRateHertz": 48000 }, "key": "es_audio" } ], "muxStreams": [ { "key": "mux_video", "container": "fmp4", "elementaryStreams": ["es_video"], "segmentSettings": { "segmentDuration": "2s" } }, { "key": "mux_audio", "container": "fmp4", "elementaryStreams": ["es_audio"], "segmentSettings": { "segmentDuration": "2s" } } ], "manifests": [ { "key": "manifest_dash", "fileName": "main.mpd", "type": "DASH", "muxStreams": [ "mux_video", "mux_audio" ], "maxSegmentCount": 5, "segmentKeepDuration": "60s" } ], "streamingState": "STOPPED" }
C#
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
La risposta completa contiene il seguente campo. Alcuni esempi di codice sopra riportati restituiscono solo determinati campi nella risposta, ma possono essere modificati per restituire la risposta completa.
{
...
"streamingState": "STOPPED"
...
}
Questa risposta indica che ora puoi avviare il canale.
Avvia il canale
Usa il metodo projects.locations.channels.start
per avviare il canale. Un canale deve essere avviato prima
di poter accettare stream di input o generare uno stream di output.
L'avvio del primo canale in una regione richiede circa 10 minuti.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAMLOCATION
: la località in cui si trova il tuo 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-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: un identificatore del canale definito dall'utente
Per inviare la richiesta, espandi una delle seguenti 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": "start", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Invia il flusso di input
Per determinare se il canale è stato avviato, recupera le informazioni sul canale, come hai fatto in precedenza. La risposta deve contenere quanto segue:
{
...
"streamingState": "AWAITING_INPUT"
...
}
Ora che il canale è pronto, invia uno stream di input di prova all'endpoint di input per generare il live streaming.
Apri una nuova finestra del terminale. Esegui questo comando, utilizzando INPUT_STREAM_URI nella sezione Verifica il risultato:
ffmpeg -re -f lavfi -i "testsrc=size=1280x720 [out0]; sine=frequency=500 [out1]" \
-acodec aac -vcodec h264 -f flv INPUT_STREAM_URI
Verificare che il canale stia trasmettendo in streaming
Per controllare lo stato dell'operazione di live streaming, recupera le informazioni sul canale come hai fatto in precedenza. La risposta deve contenere quanto segue:
{
...
"streamingState": "STREAMING"
...
}
Verifica i contenuti nel bucket Cloud Storage
Apri il bucket Cloud Storage. Verifica che contenga i file e le directory seguenti:
main.mpd
mux_audio/
- Più file
segment-segment-number.m4s
- Un singolo
file
segment-initialization_segment_0000000000.m4s
- Più file
mux_video/
- Più file
segment-segment-number.m4s
- Un singolo
file
segment-initialization_segment_0000000000.m4s
- Più file
Riproduci il live streaming generato
Per riprodurre il file multimediale generato in Shaka Player, completa i seguenti passaggi:
- Rendi leggibile pubblicamente il bucket Cloud Storage che hai creato.
- Per abilitare la condivisione
delle risorse tra origini (CORS) in un bucket Cloud Storage, segui questi passaggi:
- Crea un file JSON contenente quanto segue:
[ { "origin": ["https://shaka-player-demo.appspot.com/"], "responseHeader": ["Content-Type", "Range"], "method": ["GET", "HEAD"], "maxAgeSeconds": 3600 } ]
-
Esegui questo comando dopo aver sostituito JSON_FILE_NAME con il nome del file JSON che hai creato nel passaggio precedente:
gsutil cors set JSON_FILE_NAME.json gs://BUCKET_NAME
- Crea un file JSON contenente quanto segue:
- Nel bucket Cloud Storage, trova il file
main.mpd
generato. Fai clic su Copia URL nella colonna Accesso pubblico del file. - Vai a Shaka Player, un player online per il live streaming.
- Fai clic su Custom Content (Contenuti personalizzati) nella barra di navigazione in alto.
- Fai clic sul pulsante +.
Incolla l'URL pubblico del file nella casella Manifest URL (URL del manifest).
Digita un nome nella casella Name (Nome).
Fai clic su Salva.
Fai clic su Play (Riproduci).
Dovresti vedere una sequenza di prova riprodotta come live streaming.
Aggiungere un indicatore di interruzione pubblicitaria al live streaming
Utilizza il metodo projects.locations.channels.events.create
per aggiungere un indicatore di interruzione pubblicitaria al live streaming.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAMLOCATION
: la località in cui si trova il tuo 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-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: un identificatore del canale definito dall'utenteEVENT_ID
: un identificatore dell'evento definito dall'utente.
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/channels/CHANNEL_ID/events/EVENT_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "adBreak": { "duration": "100s" }, "executeNow": true, "state": "PENDING" }
C#
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Verificare l'esistenza dell'indicatore di interruzione pubblicitaria
Quando l'indicatore dell'annuncio viene inserito nel live streaming, nel manifest DASH viene visualizzato un evento con l'etichetta<SpliceInfoSection>
per la durata dell'annuncio specificata (100 secondi).
Esegui questo comando per vedere i contenuti del manifest DASH generato:
gsutil cat gs://BUCKET_NAME/main.mpd
Potresti dover eseguire il comando gsutil cat
più volte finché non viene visualizzata la sezione <SpliceInfoSection>
:
<EventStream timescale="10000000" schemeIdUri="urn:scte:scte35:2013:xml">
<Event duration="100000000" id="809">
<SpliceInfoSection xmlns="urn:scte:scte35:2013:xml">
<SpliceInsert outOfNetworkIndicator="true" spliceImmediateFlag="true">
<BreakDuration autoReturn="true" duration="100000000"/>
</SpliceInsert>
</SpliceInfoSection>
</Event>
</EventStream>
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.
Interrompere il canale
Usa il metodo projects.locations.channels.stop
per interrompere il canale. Devi interrompere il canale prima di poterlo eliminare.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAMLOCATION
: la località in cui si trova il tuo 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-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: un identificatore del canale definito dall'utente
Per inviare la richiesta, espandi una delle seguenti 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": "stop", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Utilizza OPERATION_ID per controllare lo stato dell'operazione fino a quando non ottieni "done":true
nel risultato.
Arresta il flusso di input
Se hai utilizzato ffmpeg
per inviare lo stream in ingresso, la connessione si interrompe automaticamente dopo l'interruzione del canale.
Se hai utilizzato altri codificatori con meccanismi di ripetizione, potrebbe essere necessario arrestare manualmente il flusso di input.
Eliminare l'evento
Utilizza il metodo projects.locations.channels.events.delete
per eliminare l'evento di interruzione pubblicitaria. Devi eliminare gli eventi del canale
prima di poter eliminare il canale.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAMLOCATION
: la località in cui si trova il tuo 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-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: un identificatore del canale definito dall'utenteEVENT_ID
: un identificatore dell'evento definito dall'utente.
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{}
C#
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Eliminare il canale
Usa il metodo projects.locations.channels.delete
per eliminare il canale. Devi eliminare il canale prima di poter eliminare
l'endpoint di input utilizzato dal canale.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAMLOCATION
: la località in cui si trova il tuo 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-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
CHANNEL_ID
: un identificatore del canale definito dall'utente
Per inviare la richiesta, espandi una delle seguenti 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": "delete", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Utilizza OPERATION_ID per controllare lo stato dell'operazione fino a quando non ottieni "done":true
nel risultato.
Elimina l'endpoint di input
Utilizza il metodo projects.locations.inputs.delete
per eliminare l'endpoint di input.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il numero del progetto Google Cloud, che si trova nel campo Numero progetto della pagina Impostazioni IAMLOCATION
: la località in cui si trova 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-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
INPUT_ID
: l'identificatore definito dall'utente per l'endpoint di input
Per inviare la richiesta, espandi una delle seguenti 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": "delete", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
C#
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per informazioni su come installare e utilizzare la libreria client per l'API Live Stream, consulta le librerie client dell'API Live Stream. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby dell'API Live Stream.
Per autenticarti all'API Live Stream, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Elimina il bucket Cloud Storage
Tieni presente che tutti i file e le cartelle nel bucket generato dall'API Live Stream vengono eliminati una volta interrotto il canale.
Nella console Google Cloud, vai alla pagina Browser Cloud Storage.
Seleziona la casella di controllo accanto al bucket che hai creato.
Fai clic su Elimina.
Nella finestra popup che viene visualizzata, fai clic su Elimina per eliminare definitivamente il bucket e i relativi contenuti.
Revocare le credenziali
-
Facoltativo: revoca le credenziali di autenticazione che hai creato ed elimina il file delle credenziali locale.
gcloud auth application-default revoke
-
Facoltativo: revoca le credenziali dallgcloud CLI.
gcloud auth revoke
Passaggi successivi
- Prova le istruzioni della guida rapida per un live streaming HLS.
- Scopri come configurare uno stream di input di backup.