Questa pagina spiega come generare un foglio sprite che contiene frame da un
video transcodificato. Questi frame di dimensioni ridotte, noti anche come miniature, sono utili per organizzare e visualizzare l'anteprima dei contenuti. Per generare lo spritesheet, utilizza
l'array
spriteSheets
nel modello JobConfig
.
Hai due opzioni per generare lo spritesheet:
- Genera un numero prestabilito di miniature distribuite uniformemente nella sequenza temporale del video di input.
- Genera periodicamente un'immagine in miniatura, vale a dire ogni n secondi lungo la sequenza temporale del video di input.
Genera un numero specifico di immagini in miniatura
La configurazione seguente genera un foglio sprite 10x10 di grandi dimensioni
e uno spritesheet 10x10 di piccole immagini, ciascuna con 100
miniature. Tieni presente che gli spritesheet richiedono almeno un VideoStream
nella configurazione del job.
Puoi aggiungere questa configurazione modello di lavoro o includerlo in un configurazione ad hoc dei job:
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progetto Google Cloud elencato in nelle impostazioni IAM.LOCATION
: la posizione in cui verrà eseguito il job. Utilizza le funzionalità di in una delle regioni supportate.Mostra localitàus-central1
us-west1
us-west2
us-east1
us-east4
southamerica-east1
northamerica-northeast1
asia-east1
asia-northeast1
asia-northeast3
asia-south1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west4
STORAGE_BUCKET_NAME
: il nome del bucket Cloud Storage che hai creato.STORAGE_INPUT_VIDEO
: il nome del video nel bucket Cloud Storage di cui stai eseguendo la transcodifica, ad esempiomy-vid.mp4
. Questo campo deve tenere conto di eventuali cartelle create nel bucket (ad esempioinput/my-vid.mp4
).STORAGE_OUTPUT_FOLDER
: il nome della cartella Cloud Storage in cui vuoi salvare le uscite video codificate.
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/jobs/JOB_ID", "config": { ... }, "state": "PENDING", "createTime": CREATE_TIME, "ttlAfterCompletionDays": 30 }
gcloud
- Crea un file
request.json
che definisce i campi del job. Marca le seguenti sostituzioni pergcloud
:- STORAGE_BUCKET_NAME: il del bucket Cloud Storage che hai creato.
- STORAGE_INPUT_VIDEO: il
nome del video nel bucket Cloud Storage di cui stai
eseguendo la transcodifica, ad esempio
my-vid.mp4
. Questo campo deve includere prendi in considerazione le cartelle che hai creato nel bucket (ad esempioinput/my-vid.mp4
). - LOCATION: la località in cui
verrà eseguito il job. Utilizza una posizione dall'elenco seguente.
Sedi dei negozi
us-central1
us-west1
us-west2
us-east1
us-east4
southamerica-east1
northamerica-northeast1
asia-east1
asia-northeast1
asia-northeast3
asia-south1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west4
- STORAGE_OUTPUT_FOLDER: il nome della cartella Cloud Storage in cui vuoi salvare le uscite video codificate.
{ "config": { "inputs": [ { "key": "input0", "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO" } ], "elementaryStreams": [ { "key": "video-stream0", "videoStream": { "h264": { "heightPixels": 360, "widthPixels": 640, "bitrateBps": 550000, "frameRate": 60 } } }, { "key": "audio-stream0", "audioStream": { "codec": "aac", "bitrateBps": 64000 } } ], "muxStreams": [ { "key": "sd", "container": "mp4", "elementaryStreams": [ "video-stream0", "audio-stream0" ] } ], "output": { "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_OUTPUT_FOLDER/" }, "spriteSheets": [ { "filePrefix": "small-sprite-sheet", "spriteHeightPixels": 32, "spriteWidthPixels": 64, "columnCount": 10, "rowCount": 10, "totalCount": 100 }, { "filePrefix": "large-sprite-sheet", "spriteHeightPixels": 72, "spriteWidthPixels": 128, "columnCount": 10, "rowCount": 10, "totalCount": 100 } ] } }
- Esegui questo comando:
Dovresti visualizzare una risposta simile alla seguente:gcloud transcoder jobs create --location=LOCATION --file="request.json"
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/jobs/JOB_ID", "config": { ... }, "state": "PENDING", "createTime": CREATE_TIME, "ttlAfterCompletionDays": 30 }
C#
Prima di provare questo esempio, segui le istruzioni di configurazione C# riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Transcoder C#.
Per autenticarti all'API Transcoder, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nel Guida rapida dell'API Transcoder con librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Transcoder Go.
Per eseguire l'autenticazione nell'API Transcoder, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nel Guida rapida dell'API Transcoder con librerie client. Per ulteriori informazioni, consulta API Java dell'API Transcoder documentazione di riferimento.
Per autenticarti all'API Transcoder, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta API Node.js dell'API Transcoder documentazione di riferimento.
Per autenticarti all'API Transcoder, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Prima di provare questo esempio, segui le istruzioni di configurazione PHP riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta API PHP dell'API Transcoder documentazione di riferimento.
Per autenticarti all'API Transcoder, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta API Python dell'API Transcoder documentazione di riferimento.
Per eseguire l'autenticazione nell'API Transcoder, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Prima di provare questo esempio, segui le istruzioni per la configurazione di Ruby nel Guida rapida dell'API Transcoder con librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Transcoder Ruby.
Per eseguire l'autenticazione nell'API Transcoder, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Utilizza questa configurazione sul video di esempio per generare le seguenti spritesheet:
Figura 1. Foglio sprite di immagini piccolo (100 miniature)
e
Figura 2. Spritesheet di immagini grandi (100 miniature)
Generare un'immagine in miniatura periodicamente
La seguente configurazione genera un foglio sprite di immagini di piccole dimensioni
e uno spritesheet di immagini di grandi dimensioni. Ogni foglio sprite contiene
miniature generate ogni 7 secondi dal video di input. Tieni presente che gli spritesheet richiedono almeno un VideoStream
nella configurazione del job.
Puoi aggiungere questa configurazione modello di lavoro o includerlo in un configurazione ad hoc dei job:
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google Cloud elencato nelle Impostazioni IAM.LOCATION
: la località in cui verrà eseguito il job. Utilizza le funzionalità di in una delle regioni supportate.Sedi dei negozius-central1
us-west1
us-west2
us-east1
us-east4
southamerica-east1
northamerica-northeast1
asia-east1
asia-northeast1
asia-northeast3
asia-south1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west4
STORAGE_BUCKET_NAME
: il nome del bucket Cloud Storage che hai creato.STORAGE_INPUT_VIDEO
: il nome del video nel bucket Cloud Storage di cui stai eseguendo la transcodifica, ad esempiomy-vid.mp4
. Questo campo deve tenere conto di eventuali cartelle create nel bucket (ad esempioinput/my-vid.mp4
).STORAGE_OUTPUT_FOLDER
: il nome della cartella Cloud Storage in cui vuoi salvare le uscite video codificate.
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/jobs/JOB_ID", "config": { ... }, "state": "PENDING", "createTime": CREATE_TIME, "ttlAfterCompletionDays": 30 }
gcloud
- Crea un file
request.json
che definisce i campi del job. Marca le seguenti sostituzioni pergcloud
:- STORAGE_BUCKET_NAME: il nome del bucket Cloud Storage che hai creato.
- STORAGE_INPUT_VIDEO: il
nome del video nel bucket Cloud Storage di cui stai
eseguendo la transcodifica, ad esempio
my-vid.mp4
. Questo campo deve includere prendi in considerazione le cartelle che hai creato nel bucket (ad esempioinput/my-vid.mp4
). - LOCATION: la località in cui
verrà eseguito il job. Utilizza una posizione dall'elenco seguente.
Sedi dei negozi
us-central1
us-west1
us-west2
us-east1
us-east4
southamerica-east1
northamerica-northeast1
asia-east1
asia-northeast1
asia-northeast3
asia-south1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west4
- STORAGE_OUTPUT_FOLDER: il nome della cartella Cloud Storage in cui vuoi salvare le uscite video codificate.
{ "config": { "inputs": [ { "key": "input0", "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_INPUT_VIDEO" } ], "elementaryStreams": [ { "key": "video-stream0", "videoStream": { "h264": { "heightPixels": 360, "widthPixels": 640, "bitrateBps": 550000, "frameRate": 60 } } }, { "key": "audio-stream0", "audioStream": { "codec": "aac", "bitrateBps": 64000 } } ], "muxStreams": [ { "key": "sd", "container": "mp4", "elementaryStreams": [ "video-stream0", "audio-stream0" ] } ], "output": { "uri": "gs://STORAGE_BUCKET_NAME/STORAGE_OUTPUT_FOLDER/" }, "spriteSheets": [ { "filePrefix": "small-sprite-sheet", "spriteHeightPixels": 32, "spriteWidthPixels": 64, "interval": "7s" }, { "filePrefix": "large-sprite-sheet", "spriteHeightPixels": 72, "spriteWidthPixels": 128, "interval": "7s" } ] } }
- Esegui questo comando:
Dovresti visualizzare una risposta simile alla seguente:gcloud transcoder jobs create --location=LOCATION --file="request.json"
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/jobs/JOB_ID", "config": { ... }, "state": "PENDING", "createTime": CREATE_TIME, "ttlAfterCompletionDays": 30 }
C#
Prima di provare questo esempio, segui le istruzioni di configurazione C# riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Transcoder C#.
Per autenticarti all'API Transcoder, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Transcoder Go.
Per autenticarti all'API Transcoder, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Transcoder Java.
Per eseguire l'autenticazione nell'API Transcoder, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nel Guida rapida dell'API Transcoder con librerie client. Per ulteriori informazioni, consulta API Node.js dell'API Transcoder documentazione di riferimento.
Per autenticarti all'API Transcoder, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Prima di provare questo esempio, segui le istruzioni di configurazione PHP riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta API PHP dell'API Transcoder documentazione di riferimento.
Per autenticarti all'API Transcoder, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta API Python dell'API Transcoder documentazione di riferimento.
Per eseguire l'autenticazione nell'API Transcoder, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione Ruby riportate nella guida rapida all'API Transcoder che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Transcoder Ruby.
Per autenticarti all'API Transcoder, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Utilizza questa configurazione sul video di esempio per generare le seguenti spritesheet:
Figura 3. Spritesheet di immagini piccole (1 miniatura ogni 7 secondi)
e
Figura 4. Foglio sprite di immagini grande (1 miniatura ogni 7 secondi)
Dal video di esempio vengono generate otto miniature, della durata di 60 secondi. lunghezza.