Configuración que se especifica para crear una tarea de Elastic Transcoder

Cuando se crea una tarea mediante la consola de Elastic Transcoder, se pueden especificar los siguientes valores.

nota

Puede configurar Elastic Transcoder para recibir una notificación cuando el estado de una tarea cambie, incluido cuándo Elastic Transcoder empieza y termina de procesar una tarea, y cuándo Elastic Transcoder encuentra una condición de error o una advertencia. Para obtener más información, consulte Notificaciones de estado de la tarea.

Región

Elastic Transcoder crea la tarea en la región en la que se encuentra.

Configuración general

Pipeline

El nombre de la canalización que desea que Elastic Transcoder use para la transcodificación. La canalización determina varias opciones de configuración, como el bucket de Amazon S3 desde el que Elastic Transcoder obtiene los archivos que se van a transcodificar y el bucket en el que Elastic Transcoder coloca los archivos transcodificados.

Output Key Prefix

El valor, si existe, que desea que Elastic Transcoder anexe como prefijo en los nombres de todos los archivos que crea esta tarea, como los archivos de salida, las miniaturas y las listas de reproducción. Si especifica un valor, este debe contener una barra invertida / en algún lugar después del primer carácter, lo que simplifica la administración de archivos de Amazon S3.

Detalles de entrada, parte 1

Utilice la configuración en esta sección para especificar información sobre los archivos de entrada. Si proporciona más de un archivo de entrada, Elastic Transcoder los transcodifica y, a continuación, los une creando un archivo de salida. Para obtener más información, consulte Combinación de clips.

Input Key

El nombre de los archivos que desea transcodificar. Para determinar desde qué bucket de Amazon S3 se obtiene el archivo, Elastic Transcoder consulta el campo Bucket de entrada en la canalización que especificó para esta tarea.

Si el nombre del archivo incluye un prefijo, por ejemplo, cooking/lasagna.mpg, inclúyalo en la clave. Si el archivo no se encuentra en el bucket especificado, Elastic Transcoder devuelve un error.

Input Decryption

La configuración de cifrado, si la hay, que se utiliza para descifrar los archivos de entrada. Si el archivo de entrada está cifrado, debe especificar el modo que utilizará Elastic Transcoder para descifrarlo.

Decryption Mode (obligatorio para el descifrado)

El modo de cifrado concreto que desea que utilice Elastic Transcoder al descifrar los archivos.

Elastic Transcoder admite las siguientes opciones:

• Cifrado del servidor de Amazon S3: Amazon S3 se encarga del cifrado y el descifrado de los archivos. Mientras Elastic Transcoder tenga permisos de acceso a su bucket de Amazon S3, no es necesario realizar ninguna acción.

  Para obtener más información, consulte Protección de los datos con el cifrado del servidor en la Guía del usuario de Amazon Simple Storage Service.

• Cifrado del cliente mediante claves proporcionadas por el cliente: Elastic Transcoder admite tres tipos de cifrado mediante claves proporcionadas por el cliente:

  • aes-cbc-pkcs7: Modo de funcionamiento con bloques de cifrado acolchados.

  • aes-ctr: modo AES Counter.

  • aes-gcm: modo AES Galois Counter, un modo de funcionamiento que es un formato de cifrado autenticado, lo que significa que un archivo, una clave o un vector de inicialización que han sido manipulados dará un error en el proceso de descifrado.

  Si elige uno de los modos de cifrado AES, también debe especificar los tres valores siguientes (los tres deben estar codificados en base64):

  • Clave de cifrado

  • Clave de cifrado MD5

  • Vector de inicialización del cifrado

Decryption Key (obligatoria para el descifrado de AES)

La clave de cifrado de datos utilizada para cifrar el archivo. La clave debe estar codificada en base64, y debe tener una de las siguientes longitudes de bits para poder codificarla en base64:

96 (solo AES-GCM), 128, 192 o 256.

La clave también debe cifrarse mediante el uso. AWS KMS Para obtener más información, consulte Cifrado y descifrado de datos en la Guía para desarrolladores de AWS Key Management Service .

Decryption Key MD5 (obligatoria para el descifrado de AES)

El resumen MD5 de la clave utilizada para cifrar el archivo de entrada y que desea que Elastic Transcoder utilice como suma de comprobación para asegurarse de que la clave no se dañó durante el transporte. La clave MD5 debe estar codificada en base64, y debe tener exactamente 16 bytes para poder codificarla en base64.

Decryption Initialization Vector (obligatorio para el descifrado de AES)

La serie de bits aleatorios creada por un generador de bits aleatorios, única para cada operación de cifrado, que se utilizó para cifrar los archivos de entrada. El vector de inicialización debe estar codificado en base64, y debe tener exactamente 16 bytes para poder codificarla en base64.

Para obtener más información, consulte Vector de inicialización.

Detalles de entrada, parte 2, Configuración de clips y subtítulos

Utilice la configuración en esta sección para especificar información sobre clips y subtítulos para los archivos de entrada. Esta configuración solo está disponible cuando proporciona múltiples entradas.

Para obtener más información acerca de los subtítulos, consulte Títulos

(Opcional) Clip Start Time

Puede crear un archivo de salida que contenga un extracto del archivo de entrada. Clip Start Time indica el lugar en el archivo de entrada en el que desea que comience el clip. El formato puede ser HH:mm:ss.SSS (valor máximo: 23:59:59.999; SSS corresponde a milésimos de un segundo) o sssss.SSS (valor máximo: 86399.999). Si no se especifica ningún valor, Elastic Transcoder comienza al principio del archivo de entrada.

(Opcional) Clip Duration

La duración del clip del extracto. El formato puede ser HH:mm:ss.SSS (valor máximo: 23:59:59.999; SSS corresponde a milésimos de un segundo) o sssss.SSS (valor máximo: 86399.999). Si no se especifica ningún valor, Elastic Transcoder genera el clip desde Hora de inicio del clip hasta el final del archivo.

Si se especifica un valor más largo que la duración del archivo de entrada, Elastic Transcoder transcodifica desde Hora de inicio del clip hasta el final del archivo y devuelve un mensaje de advertencia.

(Solo vídeos) Captions Merge Policy

Una política que determina cómo Elastic Transcoder gestiona la existencia de varios subtítulos.

• MergeOverride: Elastic Transcoder transcodifica los subtítulos integrados y en el sidecar en salidas. Si los subtítulos de un idioma están integrados en el archivo de entrada y también aparecen en un archivo asociado, Elastic Transcoder usa los subtítulos asociados y hace caso omiso de los subtítulos integrados para ese idioma.

• MergeRetain: Elastic Transcoder transcodifica los subtítulos integrados y en el sidecar en salidas. Si los subtítulos de un idioma están integrados en el archivo de entrada y también aparecen en un archivo asociado, Elastic Transcoder usa los subtítulos integrados y hace caso omiso de los subtítulos asociados para ese idioma. Si se deja Origen de los subtítulos en blanco, Elastic Transcoder omite todos los subtítulos asociados de los archivos de salida.

• Anular: Elastic Transcoder realiza la transcodificación de solo los subtítulos asociados que se especifiquen en Origen de los subtítulos.

(Solo vídeos, opcional) Input Key

El nombre del archivo de subtítulos asociados que desea que Elastic Transcoder transcodifique e incluya con las salidas.

(Solo vídeos) Language

Una cadena que especifica el idioma del subtítulo en uno de los siguientes formatos:

• Código ISO 639-1 de 2 caracteres, por ejemplo, en para inglés

• Código ISO 639-2 de 3 caracteres, por ejemplo, eng para inglés

Para obtener más información sobre los códigos de idioma ISO, consulte List of ISO 639-1 codes.

(Solo vídeo, opcional) TimeOffset

En el caso de la generación de clips o de los subtítulos que no comiencen al mismo tiempo que el archivo de vídeo asociado, TimeOffsetindica a Elastic Transcoder qué parte del vídeo debe codificar antes de incluir los subtítulos.

Especifique el TimeOffset formato [+-] SS.sss o [+-] HH:mm:SS.ss.

(Solo vídeos, opcional) Label

La etiqueta de los subtítulos que se muestra en el reproductor al elegir un idioma. Es recomendable colocar aquí el nombre del idioma del subtítulo, en el idioma de los subtítulos.

Detalles de salida, parte 1

Utilice la configuración en esta sección para especificar información sobre los archivos de salida.

Preset

El elemento preestablecido que desea utilizar para esta salida. El elemento preestablecido determina la configuración de audio, vídeo y miniaturas que Elastic Transcoder usa para la transcodificación.

(Solo salidas MP4/MPEG-TS fragmentadas) Segment Duration

Si especifica un elemento preestablecido para la salida actual cuyo valor de Container es ts (MPEG-TS) o fmp4 (MP4 fragmentado), Segment Duration es la duración máxima objetivo de cada segmento en segundos. Para las listas de reproducción de formato HLSv3, cada segmento multimedia se almacena en un archivo .ts independiente. Para las listas de reproducción de formato HLSv4, MPEG-DASH y Smooth, todos los segmentos multimedia de una salida se almacenan en un solo archivo. Cada segmento tiene aproximadamente la longitud de Segment Duration, aunque los segmentos individuales pueden ser más cortos o más largos.

El intervalo de valores válidos es de 1 a 60 segundos. Si la duración del vídeo no se puede dividir de manera uniforme por Segment Duration, la duración del último segmento será el resto de:

total length/Segment Duration

Elastic Transcoder crea una lista de reproducción específica de la salida para cada salida HLS que se especifique en Claves de salida. Para añadir una salida a una lista de reproducción maestra para esta tarea, inclúyala en Outputs in Master Playlist.

Elastic Transcoder aplica esta segmentación a los subtítulos asociados con el vídeo de salida.

Output Key

El nombre que desea que Elastic Transcoder asigne al archivo transcodificado y la lista de reproducción. Elastic Transcoder guarda los archivos en el bucket de Amazon S3 indicado por el campo Bucket en la canalización que indique en Pipeline. Si el bucket ya contiene un archivo con el nombre especificado, se produce un error en la salida. Sin embargo, es posible que otras salidas de la misma tarea se completen correctamente.

El formato de los nombres de archivo depende del tipo de contenedor y si se ha establecido la duración del segmento. Si el tipo de contenedor no es ts o no se proporciona la duración del segmento, el nombre del archivo de salida es una concatenación de Output Key Prefix y Output Key.

Si el tipo de contenedor es ts y se proporciona la duración del segmento, Elastic Transcoder usa el valor de Clave de salida para asignar el nombre de la lista de reproducción de la salida y de los archivos .ts:

• Lista de reproducción:

  • HLSv3: el nombre del archivo es una concatenación de Output Key Prefix y Output Key más la extensión del nombre de archivo .m3u8:

    Output Key PrefixOutput Key.m3u8

  • HLSv4: el nombre del archivo es una concatenación de Output Key Prefix y Output Key más la extensión del nombre de archivo _v4.m3u8. Las salidas de vídeo crean un segundo archivo con un nombre de archivo que es una concatenación de Output Key Prefix y Output Key, además de la extensión de nombre de archivo _iframe.m3u8:

    Output Key PrefixOutput Key_v4.m3u8

    Output Key PrefixOutput Key_iframe.m3u8 (Solo vídeos)

• Archivos de segmento (.ts):

  • HLSv3: el nombre de archivo es una concatenación de Output Key Prefix y Output Key, además de un contador secuencial de cinco dígitos que comienza por 00000 y la extensión de nombre de archivo .ts:

    Output Key PrefixOutput Key00000.ts

  • HLSv4: el nombre del archivo es una concatenación de Output Key Prefix y Output Key más la extensión del nombre de archivo .ts:

    Output Key PrefixOutput Key.ts

Si no se incluye una salida ts segmentada en una lista de reproducción maestra, Elastic Transcoder procesa la salida como HLSv3.

nota

Elastic Transcoder añade automáticamente la extensión de archivo pertinente a las salidas en una lista de reproducción HLSv3 o HLSv4. Si incluye una extensión de archivo en la opción Output Key para las salidas de lista de reproducción HLSv3 o HLSv4, el nombre de archivo tendrá dos extensiones.

Prefijo de clave de salida agrupa todos los archivos de una tarea en el bucket de Amazon S3. Si desea agrupar los archivos para cada salida dentro de una tarea, puede incluir un prefijo en el valor de Output Key, por ejemplo:

OutputKeyPrefixiPhone/Key 00000.ts

OutputKeyPrefixKindleFireHD/Key 00000.ts

Segment Filename Preview

El nombre del archivo del primer segmento, en función del valor que introdujo para Output Key.

Detalles de salida, parte 2

Utilice la configuración en esta sección para especificar información sobre los archivos de salida.

(Solo vídeos) Create Thumbnails

Si desea que Elastic Transcoder cree miniaturas para sus vídeos, seleccione Sí y especifique el formato de los nombres de archivo en el campo Patrón de nombres de archivo de miniaturas.

(Solo vídeos) Thumbnail Filename Pattern

Si ha seleccionado Yes para Thumbnail Filename Pattern, especifique el formato de los nombres de archivo. Puede especificar los valores siguientes, en cualquier orden:

• {count} (obligatorio): número de cinco dígitos que comienza por 00001 que indica dónde aparece una miniatura determinada en la secuencia de miniaturas de un archivo transcodificado. Debe incluir {count} en algún lugar en el campo. Si lo omite, Elastic Transcoder añade automáticamente el recuento al final del nombre del archivo, inmediatamente antes de la extensión del nombre de archivo (.jpg o .png).

• (Opcional) Literal values: puede especificar valores literales en cualquier lugar en el campo, por ejemplo, como prefijo de nombre de archivo o como delimitador entre {resolution} y {count}.

• (Opcional) {resolution}: si desea que Elastic Transcoder incluya la resolución en el nombre de archivo, incluya {resolution} en el campo.

El campo Thumbnail Filename Preview muestra un ejemplo de nombres de archivo para miniaturas en función del valor que introdujo en Thumbnail Filename Pattern.

Al crear miniaturas, Elastic Transcoder guarda los archivos automáticamente en el formato (.jpg o .png) que aparece en el elemento preestablecido que ha especificado en Preset. Elastic Transcoder también añade la extensión de nombre de archivo aplicable.

(Solo vídeos/miniaturas, opcional) Output Rotation

El número de grados en dirección horaria en el que desea que Elastic Transcoder gire la salida en relación con la entrada. Si desea que Elastic Transcoder detecte automáticamente si se ha girado el archivo de entrada, seleccione auto. Tenga en cuenta, sin embargo, que por lo general Elastic Transcoder solo puede detectar si hay que girar la salida si el archivo que está transcodificando contiene metadatos de rotación.

Detalles de salida, parte 3, Configuración de subtítulos

Utilice la configuración en esta sección para especificar información sobre subtítulos para los archivos de salida.

Para obtener más información acerca de los subtítulos, consulte Títulos.

(Solo vídeos) Caption Format

El formato que especifique determina si Elastic Transcoder genera un subtítulo integrado o asociado para esta salida. Si deja este valor en blanco, Elastic Transcoder devuelve un error.

• Embedded Caption Formats: para contenedores MP4, se admiten mov-text y CEA-708. En el caso de los contenedores MPEG-TS, se admite CEA-708. Para otros tipos de contenedores, no se admiten formatos de subtítulos integrados.

  Los subtítulos CEA-708 se integran en los datos de usuario H.264 SEI del flujo. Elastic Transcoder admite un formato integrado para cada salida como máximo.

• Formatos de subtítulos asociados: Elastic Transcoder admite dfxp, scc, srt y webvtt. Los contenedores Fmp4 con listas de reproducción tipo Smooth solo admiten dfxp y Elastic Transcoder crea un archivo con la extensión .ismt. Los contenedores Fmp4 con listas de reproducción tipo MPEG-DASH solo admiten webvtt y Elastic Transcoder crea un archivo con la extensión .vtt. Si desea usar subtítulos compatibles con ttml o smpte-tt, especifique dfxp como formato de salida.

(Solo vídeos) Captions Filename Pattern

El prefijo de los nombres de archivo de subtítulo, en la forma de descripción-{language}, donde:

• descripción es una descripción del vídeo.

• {language} es un valor literal que Elastic Transcoder reemplaza por el código de dos o tres letras que corresponde al idioma del subtítulo en los nombres de archivo de salida.

Si no incluye {language} en el patrón de nombre de archivo, Elastic Transcoder añade automáticamente "{language}" al valor que especifique para la descripción. Además, Elastic Transcoder añade automáticamente el recuento al final de los archivos de segmento.

Por ejemplo, supongamos que realiza la transcodificación al formato srt. Si escribe "Sydney-{idioma}-sunrise" y el idioma de los subtítulos es inglés (en), el nombre del primer archivo de subtítulos será Sydney-en-sunrise00000.srt.

(Solo vídeos) Captions Filename Preview

El nombre del primer archivo de subtítulos, en función del valor que introdujo para Captions Filename Pattern. La vista previa utiliza el código ISO inglés "en" para mostrar cómo {language} se verá en su nombre de archivo.

(Opcional) Cifrado de salidas

Puede especificar la configuración de cifrado de los archivos de salida que desea utilizar para una tarea de transcodificación. Esto incluye el archivo de salida y cualquier marca de agua, miniatura, carátula de álbum o subtítulo que desee utilizar. Debe especificar la configuración de cifrado para cada archivo de manera individual.

Output Encryption

La configuración de cifrado, si la hay, que desea que Elastic Transcoder aplique a los archivos de salida. Si decide utilizar el cifrado, debe especificar un modo de uso. Si decide no utilizar el cifrado, Elastic Transcoder escribirá un archivo sin cifrar en su bucket de Amazon S3.

(Obligatorio para el cifrado en el nivel del archivo) Encryption Mode

El modo de cifrado concreto que desea que utilice Elastic Transcoder al cifrar los archivos de salida individuales. Elastic Transcoder es compatible con las siguientes opciones de Modo de cifrado:

• s3: Amazon S3 crea y administra las claves usadas para cifrar los archivos.

  Para obtener más información, consulte Protección de los datos con el cifrado del servidor en la Guía del usuario de Amazon Simple Storage Service.

• s3-aws-kms: Amazon S3 calls AWS KMS, que crea y administra las claves que se utilizan para cifrar los archivos. Si especifica s3-aws-kms y no desea utilizar la clave predeterminada, debe añadir la clave de AWS-KMS que desee utilizar en su canalización.

  Para obtener más información, consulte Protección de datos mediante cifrado del servidor con claves administradas por AWS KMS) en la Guía del usuario de Amazon Simple Storage Service.

• aes-cbc-pkcs7: Modo de funcionamiento con bloques de cifrado acolchados.

• aes-ctr: modo AES Counter.

• aes-gcm: modo AES Galois Counter, un modo de funcionamiento que es un formato de cifrado autenticado, lo que significa que un archivo, una clave o un vector de inicialización que han sido manipulados dará un error en el proceso de descifrado.

Si elige uno de los modos de cifrado AES, también debe especificar los tres valores siguientes (los tres deben estar codificados en base64):

• Clave de cifrado

• Clave de cifrado MD5

• Vector de inicialización del cifrado

Si ha elegido uno de los modos de cifrado AES y desea que Elastic Transcoder genere una clave de cifrado AES de 128 bits, no especifique valores para la clave de cifrado, la clave de cifrado MD5 o el vector de inicialización del cifrado. Una vez que Elastic Transcoder haya generado la clave, puede recuperarla llamando a ReadJob. La clave no está incluida en el objeto CreateJobResponse.

importante

Para los modos AES, AWS nunca almacena las claves de cifrado privadas específicas de multimedia y sus datos sin cifrar, por lo que es muy importante que administre de manera segura las claves de cifrado. Si las pierde, no podrá descifrar los datos.

(Opcional) Encryption Key

Si desea que Elastic Transcoder genere una clave, deje este campo en blanco. Una vez que Elastic Transcoder ha generado la clave, puede recuperarla llamando a Leer tarea. La clave no está incluida en el objeto Crear respuesta de tarea.

Si decide proporcionar su propia clave, debe cifrarla mediante AWS KMS. La clave debe estar codificada en base64 y debe tener una de las siguientes longitudes de bits para poder codificarla en base64:

96 (solo AES-GCM), 128, 192 o 256.

Si ha configurado Elastic Transcoder para que genere una clave, Elastic Transcoder deja este campo en blanco en la respuesta de Crear tarea. Para recuperar la clave de cifrado de datos generada, envíe una solicitud de Leer tarea.

Para obtener más información sobre cómo cifrar la clave con AWS KMS, consulte Cifrar y descifrar datos en la Guía para desarrolladores.AWS Key Management Service

(Obligatorio si se proporciona una clave de cifrado) Encryption Key MD5

El resumen MD5 de la clave que desea que Elastic Transcoder use para cifrar el archivo de salida y que quiere que Elastic Transcoder utilice como suma de comprobación para asegurarse de que la clave no se dañó durante el transporte. La clave MD5 debe estar codificada en base64, y debe tener exactamente 16 bytes para poder codificarla en base64.

Si desea que Elastic Transcoder genere una clave, deje este campo en blanco.

(Obligatorio si se proporciona una clave de cifrado) Encryption Initialization Vector

La serie de bits aleatorios creada por un generador de bits aleatorios, única para cada operación de cifrado, que desee que Elastic Transcoder utilice para cifrar los archivos de salida. El vector de inicialización debe estar codificado en base64, y debe tener exactamente 16 bytes para poder codificarla en base64.

Si desea que Elastic Transcoder genere una clave, deje este campo en blanco.

Para obtener más información, consulte Vector de inicialización.

(Solo vídeos/miniaturas) Marcas de agua

Información sobre las marcas de agua que desea que Elastic Transcoder añada al vídeo durante la transcodificación. Puede especificar hasta cuatro marcas de agua para cada salida. La configuración de cada marca de agua se debe definir en el elemento preestablecido que especifique en Preset para la salida actual.

Las marcas de agua se añaden al vídeo de salida en la secuencia en la que se enumeren en la salida de la tarea: la primera marca de agua de la lista se añade al vídeo de salida en primer lugar, luego se añade la segunda marca de agua de la lista y así sucesivamente. Como resultado, si la configuración de un elemento preestablecido hace que Elastic Transcoder coloque todas las marcas de agua en la misma ubicación, la segunda marca de agua que añada cubrirá la primera, la tercera cubrirá la segunda y la cuarta cubrirá la tercera.

Para obtener más información sobre las marcas de agua, consulte Marcas de agua.

Preset Watermark ID

El ID de la configuración de marca de agua que Elastic Transcoder utiliza para añadir marcas de agua al vídeo durante la transcodificación. La configuración está en el elemento preestablecido especificado por Preset para la salida actual. En ese elemento prestablecido, el valor de ID de marcas de agua indica a Elastic Transcoder qué configuración debe usar.

Input Key for Preset Watermark Id

El nombre del archivo .png o .jpg que desea usar para la marca de agua. Para determinar el bucket de Amazon S3 que contiene el archivo especificado, Elastic Transcoder comprueba la canalización que se especifica mediante Canalización; el objeto Bucket de entrada de esta canalización identifica el bucket.

Si el nombre del archivo incluye un prefijo, por ejemplo, logos/128x64.png, inclúyalo en la clave. Si el archivo no se encuentra en el bucket especificado, Elastic Transcoder devuelve un error.

(Solo FLAC/MP3/MP4) Carátula del álbum

La carátula del álbum que se debe asociar con el archivo de salida, si existe.

Para quitar carátulas o dejar la carátula vacía, puede establecer la opción Artwork en nulo o establecer la opción Merge Policy en "Replace" y usar una matriz Artwork vacía.

Para transferir carátulas existentes sin cambios, establezca la opción Merge Policy en "Prepend", "Append" o "Fallback" y use una matriz Artwork vacía.

nota

La carátula del álbum está disponible solo para salidas de audio en contenedores de tipo flac, mp3 o mp4.

Album Art Merge Policy

Una política que determina cómo gestionará Elastic Transcoder la existencia de varios archivos de carátula del álbum.

• Replace: la carátula del álbum especificada reemplazará toda carátula del álbum existente.

• Prepend: la carátula del álbum especificada se colocará por delante de toda carátula del álbum existente.

• Append: la carátula del álbum especificada se colocará por detrás de toda carátula del álbum existente.

• Alternativa: si el archivo de entrada contiene carátulas, Elastic Transcoder las usará para la salida. Si el archivo de entrada no contiene carátulas, Elastic Transcoder usará el archivo de carátula del álbum especificado.

Album Art Artwork

El archivo que se debe usar como carátula del álbum. Puede haber varias carátulas asociadas a un archivo de audio, hasta un máximo de 20.

Album Art Input Key

El nombre del archivo que se debe usar como carátula del álbum. Para determinar qué bucket de Amazon S3 contiene el archivo especificado, Elastic Transcoder comprueba la canalización especificada PipelineIdpor; el objeto de esa canalización identifica InputBucketla canalización.

Si el archivo incluye un prefijo, por ejemplo, cooking/pie.jpg, inclúyalo en la clave. Si el archivo no se encuentra en el bucket especificado, Elastic Transcoder devuelve un error.

Album Art Format

El formato de la carátula del álbum, si existe. Los formatos válidos son jpg y png.

Album Art Max Width

El ancho máximo de la carátula del álbum de salida, en píxeles. Si especifica auto, Elastic Transcoder usa 600 como valor predeterminado. Si especifica un valor numérico, escriba un número entero par entre 32 y 4096, ambos incluidos.

Album Art Max Height

La altura máxima de la carátula del álbum de salida, en píxeles. Si especifica auto, Elastic Transcoder usa 600 como valor predeterminado. Si especifica un valor numérico, escriba un número entero par entre 32 y 3072, ambos incluidos.

Album Art Sizing Policy

Un valor que controla el escalado de la carátula del álbum de salida:

• Ajuste: Elastic Transcoder escala la imagen de salida para que coincida con el valor que especificó en uno de los dos valores MaxWidthMaxHeighto sin superar el otro.

• Rellenar: Elastic Transcoder escala la imagen de salida para que coincida con el valor que especificó en uno o varios valores y que coincida MaxWidthMaxHeighto supere el otro valor. Elastic Transcoder centra la carátula de salida y luego la recorta según las dimensiones (si las hay) que superan el valor máximo.

• Expansión: Elastic Transcoder estira la imagen de salida para que coincida con los valores que especificó para y. MaxWidthMaxHeight Si las proporciones relativas de la carátula de entrada y la carátula de salida son diferentes, la carátula de salida se distorsionará.

• Conservar: Elastic Transcoder no ajusta la escala de la imagen de salida. Si alguna de las dimensiones de la imagen de entrada supera los valores especificados para MaxWidthy MaxHeight, Elastic Transcoder recorta la imagen de salida.

• ShrinkToFit: Elastic Transcoder reduce la escala de la ilustración de salida para que sus dimensiones coincidan con los valores que especificó para al menos uno MaxWidthde los valores MaxHeighty sin sobrepasarlos. Si especifica esta opción, Elastic Transcoder no aumenta la escala de la carátula.

• ShrinkToFill: Elastic Transcoder reduce la escala de la ilustración de salida para que sus dimensiones coincidan con los valores que especificó para al menos uno de los valores MaxHeighty sin caer por debajo MaxWidthde ninguno de ellos. Si especifica esta opción, Elastic Transcoder no aumenta la escala de la carátula.

La siguiente tabla muestra los posibles efectos de los SizingPolicyajustes en la carátula del álbum de salida:

SizingPolicy	Es posible que se aumente la escala de la carátula del álbum de salida	Es posible que se rellene la carátula del álbum de salida cuando la política de rellenado es "Rellenar"	Es posible que la carátula del álbum de salida tenga una relación de aspecto en píxeles diferente de la carátula del álbum de entrada	Es posible que se recorte la carátula del álbum de salida
Ajustar	Sí	Sí
Rellenar	Sí			Sí
Estirar	Sí		Sí
Conservar	Sí	Sí		Sí
ShrinkToFit		Sí
ShrinkToFill		Sí		Sí

Album Art Padding Policy

Si lo PaddingPolicyestablecesPad, Elastic Transcoder puede añadir barras blancas en los lados superior e inferior o izquierdo y derecho de la carátula del álbum de salida para que el tamaño total de la carátula de salida coincida con los valores que especificaste para y. MaxWidthMaxHeight Para obtener más información, consulte la tabla en AlbumArt:Art:SizingPolicy.

(Opcional) Metadatos del usuario

Los metadatos definidos por el usuario que desee asociar a una tarea de Elastic Transcoder. Los metadatos se especifican en pares key/value. Puede utilizar los pares key/value para realizar un seguimiento de los detalles de un archivo, por ejemplo, Season 1: Episode 3.

Puede añadir hasta 10 pares clave/valor a cada tarea. Elastic Transcoder no garantiza que los pares key/value se devuelvan en el mismo orden en que se especificaron.

Metadata Key

La clave del par key/value de metadatos que desea que se devuelva con el archivo de salida. Cada clave debe ser una cadena única con 1-128 caracteres y debe usar solo caracteres de la siguiente lista:

• 0-9

• A-Z y a-z

• Space

• Los siguientes símbolos: _.:/=+-%@

Puede utilizar las claves como sistema de numeración para organizar los metadatos, para almacenar 128 caracteres adicionales de metadatos o para etiquetar los metadatos almacenados en el valor. Si desea utilizar únicamente metadatos de valores, puede colocar cadenas desechables en las claves, por ejemplo key1, y no tenerlas en cuenta cuando recupere los metadatos de Elastic Transcoder.

importante

Debe especificar cadenas únicas para todas las claves de una tarea. Si se utiliza la misma cadena para más de una clave en una tarea, Elastic Transcoder devuelve solo uno de los pares clave/valor que utilizan esa clave. No hay forma de garantizar qué valor se devuelve.

Metadata Value

El valor del par de metadatos key/value que desea que se devuelva con su tarea. Cada valor debe ser una cadena con 0-256 caracteres y debe usar solo caracteres de la siguiente lista:

• 0-9

• A-Z y a-z

• Space

• Los siguientes símbolos: _.:/=+-%@

(Solo salidas MP4/MPEG-TS fragmentadas) Lista de reproducción

Si elige un elemento preestablecido en la lista Elemento preestablecido para el cual el valor del Contenedor es ts (MPEG-TS) o fmp4 (MP4 fragmentado), utilice la configuración de esta sección para especificar información sobre las listas de reproducción maestras que desea que Elastic Transcoder cree. Es recomendable crear, como máximo, una lista de reproducción maestra por formato de lista de reproducción.

Master Playlist Name

El nombre que desea que Elastic Transcoder asigne a una lista de reproducción maestra. Si el nombre incluye un carácter /, la sección del nombre antes de la última / debe ser idéntica para todos los objetos Playlist Names. Si crea más de una lista de reproducción maestra, cada una de ellas debe tener un nombre único.

nota

Elastic Transcoder añade automáticamente la extensión de archivo pertinente al nombre de archivo (.m3u8 para las listas de reproducción tipo HLSv3 y HLSv4, .mpd para las listas de reproducción tipo MPEG-DASH y .ism y .ismc para las listas de reproducción tipo Smooth). Si incluye una extensión de archivo en Master Playlist Name, el nombre de archivo tendrá dos extensiones.

Cualquier configuración de duración de segmento, configuración de clip o configuración de subtítulo debe ser igual para todas las salidas de la lista de reproducción. Para las listas de reproducción tipo Smooth, la relación Audio:Profile, Video:Profile y Frame Rate con respecto a Maximum Number of Frames Between Keyframes debe ser la misma para todas las salidas.

Playlist Format

El formato de la lista de reproducción. Entre los formatos válidos se incluyen HLSv3, HLSv4, MPEG-DASH y Smooth.

Outputs in Master Playlist

Para cada salida de esta tarea que desee incluir en una lista de reproducción maestra, el valor del campo Output Key. Si incluye más de una salida en una lista de reproducción, el valor Segment Duration de todas las salidas debe ser el mismo.

Para las listas de reproducción maestras de tipo HLSv4, Elastic Transcoder elige las combinaciones de entradas de audio y vídeo que se vincularán en las listas de reproducción de salida. Las primeras entradas de audio y vídeo se vincularán y representarán como la experiencia de reproducción predeterminada, de modo que pueda elegir el valor predeterminado de reproducción preferida. Para otras listas de reproducción individuales de la lista de reproducción maestra, Elastic Transcoder elige las combinaciones de velocidad de bits de audio y vídeo que proporcionen la mejor reproducción.

(Solo salidas de MP4/MPEG-TS fragmentadas, opcional) Protección de contenido HLS

nota

La protección de contenido HLS cifra cada uno de los segmentos de un archivo y Elastic Transcoder no admite la protección de contenido HLS combinada con cifrado de nivel de archivo.

Si elige un elemento preestablecido en la lista Preset para el que el valor de Container es ts (MPEG-TS) o fmp4 (MP4 fragmentado) con una lista de reproducción Smooth, puede especificar la configuración de cifrado para el streaming del archivo. No puede combinar el cifrado de streaming de datos con el cifrado de archivos o subtítulos. Si decide cifrar el streaming de datos, utilice la configuración en esta sección para especificar información sobre el cifrado de streaming de datos.

Para usar la protección de contenido HLS, debe tener un servidor web que pueda autenticar las sesiones (como Amazon Elastic Compute Cloud), una forma de distribuir los archivos multimedia transmitidos (como Amazon CloudFront) y una forma de reproducir contenido multimedia transmitido cifrado (como un navegador con reproductor).

Método

El método de protección del contenido de la salida. El único valor válido es:

aes-128.

Este valor se escribirá en el atributo method de la etiqueta de metadatos EXT-X-KEY de la lista de reproducción de salida.

Clave

Si desea que Elastic Transcoder genere una clave, deje este campo en blanco. Una vez que Elastic Transcoder haya generado la clave, puede recuperarla llamando a ReadJob. La clave no está incluida en el objeto CreateJobResponse.

Si decide proporcionar su propia clave, debe cifrarla mediante AWS KMS. La clave debe estar codificada en base64 y debe tener una de las siguientes longitudes de bits para poder codificarla en base64:

96 (solo AES-GCM), 128, 192 o 256.

Si ha configurado Elastic Transcoder para que genere una clave, Elastic Transcoder dejará este campo en blanco en la respuesta de CreateJob. Para recuperar la clave de cifrado de datos generada, envíe una solicitud de ReadJob.

Para obtener más información sobre cómo cifrar su clave AWS KMS, consulte Cifrado y descifrado de datos en la Guía para desarrolladores.AWS Key Management Service

Si elige un método de protección de contenido HLS de aes-128, la clave debe ser de 128 bits. Si tiene un relative KeyStoragePolicyconjunto, Elastic Transcoder escribe la clave en un bucket de Amazon S3 con cifrado del lado del servidor de Amazon S3.

Key MD5 (obligatorio si se proporciona una clave de cifrado)

El resumen MD5 de la clave que desea que Elastic Transcoder use para cifrar el archivo de salida y que quiere que Elastic Transcoder utilice como suma de comprobación para asegurarse de que la clave no se dañó durante el transporte. La clave MD5 debe estar codificada en base64, y debe tener exactamente 16 bytes para poder codificarla en base64.

Si desea que Elastic Transcoder genere una clave, deje este campo en blanco.

Initialization Vector (obligatorio si se proporciona una clave de cifrado)

La serie de bits aleatorios creada por un generador de bits aleatorios, única para cada operación de cifrado, que desee que Elastic Transcoder utilice para cifrar los archivos de salida. El vector de inicialización debe estar codificado en base64, y debe tener exactamente 16 bytes para poder codificarla en base64.

Si desea que Elastic Transcoder genere una clave, deje este campo en blanco.

Para obtener más información, consulte Vector de inicialización.

License Acquisition URL

La ubicación de la clave de licencia necesaria para descifrar la lista de reproducción HLS. La URL debe ser una ruta absoluta y se hace referencia a ella en el atributo URI de la etiqueta de metadatos EXT-X-KEY del archivo de la lista de reproducción. Por ejemplo:

https://www.example.com/exampleKey/

Key Storage Policy

Especifique si desea que Elastic Transcoder escriba su clave de licencia de HLS en un bucket de Amazon S3. Si elige WithVariantPlaylists, Elastic Transcoder escribirá la clave cifrada en el mismo bucket de Amazon S3 que la lista de reproducción asociada.

importante

Si elige NoStore, Elastic Transcoder no almacenará la clave. Usted es responsable de almacenarla y proporcionársela a sus usuarios, ofreciéndoles la URL de adquisición de la licencia en la que guarda la clave.

(Solo listas de reproducción tipo HLSv3 y Smooth, opcional) Gestión de derechos digitales

Si elige un elemento preestablecido en la lista Preset para el que el valor de Container es fmp4 (MP4 fragmentado) o ts (MPEG-TS), y su Playlist es del tipo HLSv3 o Smooth, puede especificar la configuración DRM para su archivo. Si decide utilizar DRM para proteger sus archivos, utilice la configuración en esta sección para especificar información sobre su configuración DRM.

Para usar DRM, debe tener un servidor proveedor de licencias que pueda rastrear y conceder licencias, un servidor web que pueda autenticar a los usuarios, un servidor de paquetes para cifrar sus archivos con DRM (como Elastic Transcoder), una forma de distribuir sus archivos multimedia (como Amazon) y una forma de reproducir contenido multimedia protegido por DRM (como un reproductor con DRM CloudFront).

nota

PlayReady El DRM, la protección de contenido HLS y el cifrado de salida son opciones que se excluyen mutuamente.

(Opcional) DRM PlayReady

La configuración de DRM utilizada para restringir quién puede ver sus archivos. Esto se hace mediante la inclusión de un encabezado PlayReady DRM en la lista de reproducción de salida. Esto no se puede utilizar para ilustraciones, subtítulos, miniaturas o marcas de agua. PlayReady El DRM cifra sus archivos multimedia mediante cifrado. aes-ctr

Si utiliza DRM para una lista de reproducción HLSv3, sus salidas deben tener una lista de reproducción maestra.

Para obtener más información, consulte Administración de derechos digitales.

(Obligatorio para protección DRM) DRM Format

El formato DRM de la lista de reproducción de salida. Los formatos válidos son discretix-3.0 y microsoft.

Para listas de reproducción de tipo Smooth, especifique microsoft. Para listas de reproducción de tipo HLSv3, especifique discretix-3.0.

(Obligatorio para protección DRM) DRM Key

La clave de DRM del archivo, proporcionada por el proveedor de licencias DRM. La clave debe estar codificada en base64 y debe tener una de las siguientes longitudes de bits para poder codificarla en base64:

128, 192, o 256.

La clave también debe cifrarse mediante. AWS KMS Para obtener más información, consulte Cifrado y descifrado de datos en la Guía para desarrolladores de AWS Key Management Service .

(Obligatorio para protección DRM) DRM Key Id

El ID de la clave de DRM, para que el proveedor de licencias de DRM sepa qué clave debe proporcionar.

El ID de clave debe proporcionarse en big endian y Elastic Transcoder lo convertirá en little endian antes de insertarlo en los encabezados de DRM. PlayReady Si no está seguro de si su servidor de licencias proporciona su ID de clave en Big Endian o Little Endian, consulte con su proveedor de DRM.

(Obligatorio para protección DRM) DRM Key MD5

El resumen MD5 de la clave utilizada para DRM en su archivo y que desea que Elastic Transcoder utilice como suma de comprobación para asegurarse de que la clave no se dañó durante el transporte. La clave MD5 debe estar codificada en base64, y debe tener exactamente 16 bytes para poder codificarla en base64.

(Obligatorio para protección DRM) DRM Initialization Vector

La serie de bits aleatorios creada por un generador de bits aleatorios, única para cada operación de cifrado, que desee que Elastic Transcoder utilice para cifrar los archivos. El vector de inicialización debe estar codificado en base64, y debe tener una longitud de exactamente 8 bytes para poder codificarlo en base64. Si no se proporciona ningún vector de inicialización, Elastic Transcoder generará uno automáticamente.

Para obtener más información, consulte Vector de inicialización.

(Obligatorio para protección DRM) DRM License Acquisition Url

La ubicación de la clave de licencia necesaria para reproducir contenido DRM. La URL debe ser una ruta absoluta y el encabezado hace referencia a ella. PlayReady Se hace referencia al PlayReady encabezado en el encabezado de protección del manifiesto del cliente para las salidas de Smooth Streaming y en las etiquetas de metadatos EXT-X-DXDRM y EXT-XDXDRMINFO para las salidas de listas de reproducción HLS. Un ejemplo de URL tiene este aspecto:

https://www.example.com/exampleKey/