En esta página se explica cómo generar una hoja de sprites que contenga fotogramas de un vídeo que transcodifiques. Estos marcos de tamaño reducido, también conocidos como miniaturas, son útiles para organizar y previsualizar contenido. Para generar la hoja de sprites, usa la matriz spriteSheets
en la plantilla JobConfig
.
Tienes dos opciones para generar la hoja de sprites:
- Generar un número determinado de imágenes en miniatura distribuidas de forma uniforme a lo largo de la línea de tiempo del vídeo de entrada.
- Generar una imagen en miniatura periódicamente, es decir, cada n segundos, a lo largo de la línea de tiempo del vídeo de entrada.
Generar un número determinado de imágenes en miniatura
La siguiente configuración genera una hoja de sprites de 10x10 de imágenes grandes y otra de 10x10 de imágenes pequeñas, cada una con 100 miniaturas. Ten en cuenta que las hojas de sprites requieren al menos un VideoStream
en la configuración del trabajo.
Puedes añadir esta configuración a una plantilla de tarea o incluirla en una configuración de tarea específica:
REST
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: ID de tu proyecto Google Cloud que aparece en la sección Configuración de IAM.LOCATION
: la ubicación en la que se ejecutará el trabajo. Utiliza una de las regiones admitidas.Mostrar ubicacionesus-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
me-west1
me-central1
me-central2
STORAGE_BUCKET_NAME
: nombre del segmento de Cloud Storage que has creado.STORAGE_INPUT_VIDEO
: el nombre del vídeo de tu cubo de Cloud Storage que quieres transcodificar, comomy-vid.mp4
. En este campo se deben tener en cuenta las carpetas que hayas creado en el segmento (por ejemplo,input/my-vid.mp4
).STORAGE_OUTPUT_FOLDER
: nombre de la carpeta de Cloud Storage en la que quieres guardar las salidas de vídeo codificadas.
Para enviar tu solicitud, despliega una de estas opciones:
Deberías recibir una respuesta JSON similar a la siguiente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/jobs/JOB_ID", "config": { ... }, "state": "PENDING", "createTime": CREATE_TIME, "ttlAfterCompletionDays": 30 }
gcloud
- Crea un archivo
request.json
que defina los campos de la tarea. Haz los siguientes cambios en el comandogcloud
:- STORAGE_BUCKET_NAME: el nombre del segmento de Cloud Storage que has creado.
- STORAGE_INPUT_VIDEO: el nombre del vídeo del bucket de Cloud Storage que quieres transcodificar, como
my-vid.mp4
. En este campo se deben tener en cuenta las carpetas que hayas creado en el segmento (por ejemplo,input/my-vid.mp4
). - LOCATION: la ubicación en la que se ejecutará el trabajo. Usa una ubicación de la siguiente lista.
Mostrar ubicaciones
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
me-west1
me-central1
me-central2
- STORAGE_OUTPUT_FOLDER: nombre de la carpeta de Cloud Storage en la que quieres guardar los resultados de vídeo codificado.
{ "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 } ] } }
- Ejecuta el siguiente comando:
Debería ver una respuesta similar a la siguiente: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#
Antes de probar este ejemplo, sigue las C# instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API C#.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Go
Antes de probar este ejemplo, sigue las Go instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Go.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Antes de probar este ejemplo, sigue las Java instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Java.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las Node.js instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Node.js.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
PHP
Antes de probar este ejemplo, sigue las PHP instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API PHP.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Antes de probar este ejemplo, sigue las Python instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Python.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Ruby
Antes de probar este ejemplo, sigue las Ruby instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Ruby.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Usa esta configuración en el vídeo de ejemplo para generar las siguientes hojas de sprites:
Imagen 1. Hoja de sprites de imágenes pequeñas (100 miniaturas)
Imagen 2. Hoja de sprites de imagen grande (100 miniaturas)
Generar una imagen en miniatura periódicamente
La siguiente configuración genera una hoja de sprites de imágenes pequeñas y otra de imágenes grandes. Cada hoja de sprites contiene miniaturas que se han generado cada 7 segundos a partir del vídeo de entrada. Ten en cuenta que las hojas de sprites requieren al menos un VideoStream
en la configuración del trabajo.
Puedes añadir esta configuración a una plantilla de tarea o incluirla en una configuración de tarea específica:
REST
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: ID de tu proyecto Google Cloud que aparece en la sección Configuración de IAM.LOCATION
: la ubicación en la que se ejecutará el trabajo. Utiliza una de las regiones admitidas.Mostrar ubicacionesus-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
me-west1
me-central1
me-central2
STORAGE_BUCKET_NAME
: nombre del segmento de Cloud Storage que has creado.STORAGE_INPUT_VIDEO
: el nombre del vídeo de tu cubo de Cloud Storage que quieres transcodificar, comomy-vid.mp4
. En este campo se deben tener en cuenta las carpetas que hayas creado en el segmento (por ejemplo,input/my-vid.mp4
).STORAGE_OUTPUT_FOLDER
: nombre de la carpeta de Cloud Storage en la que quieres guardar las salidas de vídeo codificadas.
Para enviar tu solicitud, despliega una de estas opciones:
Deberías recibir una respuesta JSON similar a la siguiente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/jobs/JOB_ID", "config": { ... }, "state": "PENDING", "createTime": CREATE_TIME, "ttlAfterCompletionDays": 30 }
gcloud
- Crea un archivo
request.json
que defina los campos de la tarea. Haz los siguientes cambios en el comandogcloud
:- STORAGE_BUCKET_NAME: el nombre del segmento de Cloud Storage que has creado.
- STORAGE_INPUT_VIDEO: el nombre del vídeo del bucket de Cloud Storage que quieres transcodificar, como
my-vid.mp4
. En este campo se deben tener en cuenta las carpetas que hayas creado en el segmento (por ejemplo,input/my-vid.mp4
). - LOCATION: la ubicación en la que se ejecutará el trabajo. Usa una ubicación de la siguiente lista.
Mostrar ubicaciones
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
me-west1
me-central1
me-central2
- STORAGE_OUTPUT_FOLDER: nombre de la carpeta de Cloud Storage en la que quieres guardar los resultados de vídeo codificado.
{ "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" } ] } }
- Ejecuta el siguiente comando:
Debería ver una respuesta similar a la siguiente: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#
Antes de probar este ejemplo, sigue las C# instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API C#.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Go
Antes de probar este ejemplo, sigue las Go instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Go.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Antes de probar este ejemplo, sigue las Java instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Java.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Antes de probar este ejemplo, sigue las Node.js instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Node.js.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
PHP
Antes de probar este ejemplo, sigue las PHP instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API PHP.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Antes de probar este ejemplo, sigue las Python instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Python.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Ruby
Antes de probar este ejemplo, sigue las Ruby instrucciones de configuración de la guía de inicio rápido de la API Transcoder con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Transcoder API Ruby.
Para autenticarte en la API Transcoder, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Usa esta configuración en el vídeo de ejemplo para generar las siguientes hojas de sprites:
Imagen 3. Hoja de sprites de imagen pequeña (1 miniatura cada 7 segundos)
Imagen 4. Hoja de sprites de imagen grande (1 miniatura cada 7 segundos)
Se generan ocho miniaturas a partir del vídeo de muestra, que tiene una duración de 60 segundos.