Uso de variables en la configuración de su trabajo

Puede utilizar variables, también denominadas identificadores de formato, en su configuración de trabajo. Los identificadores de formato son valores que puede colocar en su configuración de trabajo que se resuelven de forma distinta en las salidas en función de las características de los archivos de entrada o el trabajo. Son especialmente útiles en elementos preestablecidos de salida, plantillas de trabajo y trabajos que va a duplicar y volver a utilizar.

Por ejemplo, podría utilizar el identificador de formato de fecha $d$ para su configuración Destino. Si dese organizar las salidas por la hora y fecha de inicio del trabajo, en Destino debería introducir s3://amzn-s3-demo-bucket1/$d$/. Para una tarea que comienza el 4 de junio de 2020, el servicio creará las salidas en s3://amzn-s3-demo-bucket1/20200604/.

Para obtener una lista de los identificadores de formato disponibles y ejemplos de cómo utilizarlos, consulte Lista de variables de configuración con ejemplos.

Para obtener más información acerca de los identificadores de formato que funcionan de manera diferente en las salidas de streaming, consulte Uso de variables de configuración con salidas de streaming.

Lista de variables de configuración con ejemplos

La siguiente tabla proporciona información sobre cada uno de los identificadores de formato que puedes usar en tu trabajo de AWS Elemental MediaConvert . Para obtener más información acerca de los identificadores de formato que funcionan de manera diferente en las salidas de streaming, consulte Uso de variables de configuración con salidas de streaming.

Identificador de formato	Valor que colocar en la configuración de trabajo	Configuración de trabajo compatible	Descripción y ejemplo
Fecha y hora	$dt$	Destino Modificador de nombre Modificador de segmento	UTCfecha y hora de inicio del trabajo. Formato: YYYYMMDDTHHMMSS Ejemplo: para un trabajo que comienza a las 3:05:28 PM en el 4 de junio de 2020, $dt$ se resuelve como 20200604T150528.
Date	$d$	Destino Modificador de nombre Modificador de segmento	UTCfecha de la hora de inicio del trabajo. Formato: YYYYMMDD Ejemplo: para un trabajo que comienza el 4 de junio de 2020, $d$ se resuelve como 20200604.
Tiempo	$t$	Destino Modificador de nombre Modificador de segmento	UTChora de inicio del trabajo. Formato: HHMMSS Ejemplo: para un trabajo que comienza a las 3:05:28 PM, $t$ se resuelve como 150528.
Tasa de bits de vídeo	$rv$	Modificador de nombre Modificador de segmento	La tasa de bits de vídeo de la salida, en kilobits. Para QVBR las salidas, el servicio utiliza la velocidad máxima de bits del vídeo, en kilobits. Ejemplo: si establece Configuración de codificación, Vídeo, Tasa de bits (bits/s) en 50000000, $rv$ se resuelve como 50000.
Velocidad de bits de audio	$ra$	Modificador de nombre Modificador de segmento	Total de todas las tasas de bits de audio en la salida, en kilobits. Ejemplo: si tiene una salida con una única pestaña de audio y estableceConfiguración de codificación, Audio 1, Tasa de bits (kbits/s) en 256000, $ra$ se resuelve como 256000.
Tasa de bits de contenedor	$rc$	Modificador de nombre Modificador de segmento	Tasa de bits de audio y vídeo combinada para la salida, en kilobits. Ejemplo: tiene una salida con una pestaña de configuración de Vídeo y una pestaña con configuración de Audio 1. Si establece Configuración de codificación, Vídeo, Tasa de bits (bits/s) en 5000000 y configura Configuración de codificación, Audio, Tasa de bits (bits/s) en 96000 (96 kilobits), $rc$ se resuelve como 5096.
Anchura del fotograma de vídeo	$w$	Modificador de nombre Modificador de segmento	La anchura del fotograma o resolución horizontal, en píxeles. Ejemplo: si establece Configuración de codificación, Vídeo, Resolución (an x al) en 1280 x 720 , $w$se resuelve como 1280.
Altura del fotograma de vídeo	$h$	Modificador de nombre Modificador de segmento	La altura del fotograma o resolución vertical, en píxeles. Ejemplo: si establece Configuración de codificación, Vídeo, Resolución (an x al) en 1280 x 720 , $h$se resuelve como 720.
Framerate	$f$	Modificador de nombre Modificador de segmento	Velocidad de fotogramas, en fotogramas por segundo, trucado al número entero más cercano. Ejemplo: si la velocidad de fotogramas es 59.940, $f$ se resuelve como 59.
Nombre de archivo de entrada	$fn$	Destino Modificador de nombre Modificador de segmento	Nombre del archivo de entrada, sin la extensión de archivo. Para los trabajos que tienen varias entradas, este es el primer archivo especificado en el trabajo. Ejemplo: si Entrada 1 para el trabajo es s3://amzn-s3-demo-bucket/my-video.mov, $fn$ se resuelve como my-video.
Extensión de archivo del contenedor de salida	$ex$	Modificador de nombre Modificador de segmento	Varía en función del grupo de salida. Para salidas Grupo de archivos, se trata de la extensión del archivo de contenedor de salida. Para otros grupos de salida, esta es la extensión del manifiesto. Ejemplo para un grupo de archivos: si selecciona MPEG2-TS como configuración de salida, Container se convierte en. $ex$ m2ts Ejemplo de HLS grupo: si su grupo de salida esHLS, se $ex$ resuelve en. m3u8
$	$$	Modificador de nombre Modificador de segmento	$ de escape. Ejemplo: Supongamos que proporciona los siguientes valores: Nombre de archivo de entrada: file1.mp4 Destino: s3://amzn-s3-demo-bucket/ Modificador de nombre: my-video$$hi-res- El nombre de archivo de salida y la ruta se resuelven como s3://amzn-s3-demo-bucket/my-video$hi-res-file1.mp4.

Uso de variables de configuración con salidas de streaming

Las variables de la configuración de tu trabajo, también denominadas identificadores de formato, funcionan de forma diferente para las salidas de Apple HLS y para los grupos DASH ISO de salidas. Estas son las diferencias:

Para Apple Outputs HLS

Cuando se utilizan los identificadores de formato de fecha y hora ($dt$, $t$, $d$) en la configuración Modificador de segmento, estos identificadores de formato se resuelven como la hora de finalización de cada segmento, en lugar de la hora de inicio del trabajo.

nota

Para trabajos que utilizan transcodificación acelerada, los segmentos podrían completarse al mismo tiempo. Esto significa que los identificadores de formato de fecha y hora no siempre se resuelven como valores únicos.

Para DASH ISO salidas

Puede utilizar dos identificadores de formato adicionales en la configuración Modificador de nombre. Afectan al DASH manifiesto además del nombre del archivo de salida. Aquí están los identificadores:

$Number$

En los nombre de archivo de salida, $Number$ se resuelve como una serie de números que se incrementan desde 1. Esto sustituye la numeración de segmento predeterminada de nueve dígitos en los nombres de archivo de segmento. Por ejemplo:

• Si especifica video_$Number$ para Modificador de nombre, el servicio crea archivos de segmento denominados video_1.mp4, video_2.mp4, etc.

• Si especifica solo video_ para Modificador de nombre, el servicio crea archivos de segmento denominados video_000000001.mp4, video_000000002.mp4, etc.

En tu DASH manifiesto, AWS Elemental MediaConvert incluye duration y startNumber dentro del SegmentTemplate elemento, de la siguiente manera: <SegmentTemplate timescale="90000" media="main_video_$Number$.mp4" initialization="main_video_$Number$init.mp4" duration="3375000"/>

nota

Si utiliza el identificador de formato $Number$ en una salida, también debe utilizarlo en todas las demás salidas del grupo de salidas.

$Bandwidth$

En los nombres de archivo de salida, $Bandwidth$ se resuelve como el valor de Vídeo, Tasa de bits más el valor de Audio, Tasa de bits en la salida. Independientemente de si incluye este identificador de formato, el servicio utiliza numeración de segmentos de nueve dígitos en los nombres de archivo de segmento.

Por ejemplo, supongamos que especifica estos valores:

• Vídeo, Tasa de bits (bits/s): 50000000

• Audio, Tasa de bits (kbits/s): 96.0 (96.000 bits/s)

• Modificador de nombre: video_$Bandwidth$

El valor de $Bandwidth$ se resuelve en 50.096.000. El servicio crea archivos de segmento llamados video_50096000_000000001.mp4, video_50096000_000000002.mp4, etc.

En el manifiesto, AWS Elemental MediaConvert incluye duration y está startNumber dentro del SegmentTemplate elemento, así:<SegmentTemplate timescale="90000" media="main_video_$Bandwidth$.mp4" initialization="main_video_$Bandwidth$init.mp4" duration="3375000"/>.

$Time$

En los nombres del archivo de salida, $Time$ se resuelve como la duración, en milisegundos, del segmento. Al incluir este identificador de formato, el servicio no utiliza la numeración de segmento de nueve dígitos predeterminada en los nombres de archivo del segmento.

Por ejemplo, si especifica video180__$Time$ para Modificador de nombre, el servicio crea archivos de segmento denominados video180__345600.mp4, video180__331680.mp4, etc. En estos ejemplos, las duraciones de segmentos son 345.600 ms y 331.680 ms.

En el manifiesto, AWS Elemental MediaConvert incluye el SegmentTimeline interior del SegmentTemplate elemento, así:

<Representation id="5" width="320" height="180" bandwidth="200000" codecs="avc1.4d400c">
        <SegmentTemplate media="video180_$Time$.mp4" initialization="videovideo180_init.mp4">
          <SegmentTimeline>
            <S t="0" d="345600" r="2"/>
            <S t="1036800" d="316800"/>
          </SegmentTimeline>
        </SegmentTemplate>
      </Representation>

nota

Si utiliza el identificador de formato $Time$ en una salida, también debe utilizarlo en todas las demás salidas del grupo de salidas.

Especificación de un número mínimo de dígitos

Para los identificadores de formato que devuelven un número, puede especificar un número mínimo de dígitos en los que se resolverá el identificador de formato. Cuando lo haga, el servicio añade ceros de relleno delante de cualquier valor que devolviera menos dígitos.

Utilice la siguiente sintaxis para especificar el número de dígitos: %0[number of digits]. Ponga este valor justo delante del $ final del identificador de formato.

Por ejemplo, suponga que la altura del fotograma de vídeo es 720 y desea especificar un mínimo de cuatro dígitos, de forma que aparezca en su nombre de archivo como 0720. Para ello, utilice el siguiente identificador de formato: $h%04$.

nota

Los valores que son demasiado grandes para expresarlos con la cantidad de dígitos que especifique se resuelven con más dígitos.