TargetVideo - Intelligent Media Management - Centro de documentación de Alibaba Cloud

Parámetro	Tipo	Descripción	Ejemplo
	object	La configuración de parámetros de procesamiento de video.
DisableVideo	boolean	Especifica si se debe deshabilitar la generación de flujo de video. Valores válidos: true: Deshabilitado. El archivo de salida no contiene un flujo de video. false (predeterminado): No deshabilitado.	false
Stream	array	La lista de números de índice de flujos de video que se procesarán del archivo fuente. Un valor vacío (predeterminado) indica que se procesa el flujo de video con el número de índice más pequeño (el primer flujo de video). Un número de índice mayor que 100 indica que se procesan todos los flujos de video. Ejemplo: `[0,1]` procesa los flujos de video con números de índice 0 y 1. `[1]` procesa el flujo de video con número de índice 1. `[101]` procesa todos los flujos de video. Nota Solo se procesan los flujos de video con números de índice existentes. Si no existe un flujo de video correspondiente a un número de índice, ese número de índice se ignora.
	integer	El número de índice del flujo de video que se procesará.	0
TranscodeVideo	object	Los parámetros de transcodificación de video. Un valor vacío indica que el procesamiento de video está deshabilitado y que el archivo de salida no contiene un flujo de video. Nota No se recomienda establecer este parámetro en un valor vacío para deshabilitar el procesamiento de video.
Codec	string	El formato de codificación de video. Valores válidos: Para la API CreateMediaConvert: copy (predeterminado), h264, h265, vp9. Aviso Cuando este parámetro se establece en copy, los flujos de video que se van a procesar se copian directamente al archivo de salida, y otros parámetros bajo TranscodeVideo no surten efecto. copy no se puede utilizar para la concatenación de videos y se usa típicamente en escenarios de conversión de formato de contenedor. Para la API GenerateVideoPlaylist: h264 (predeterminado), h265.	h264
PixelFormat	string	El formato de píxel. El valor predeterminado es el mismo que el del video fuente. Valores válidos: yuv420p yuv422p yuv444p yuv420p10le yuv422p10le yuv444p10le yuva420p Nota yuva420p solo está disponible para la API CreateMediaConvert, y el parámetro Codec debe establecerse en vp9.	yuv420p
FrameRateOption	string	La opción de velocidad de fotogramas. Valores válidos: fixed: Siempre utiliza la velocidad de fotogramas de video objetivo especificada. adaptive: Utiliza la velocidad de fotogramas del video fuente cuando esta es inferior a la velocidad de fotogramas de video objetivo especificada. fall: Devuelve un error cuando la velocidad de fotogramas del video fuente es inferior a la velocidad de fotogramas de video objetivo especificada. Valor predeterminado: Para la API CreateMediaConvert, el valor predeterminado es fixed. Para la API GenerateVideoPlaylist, el valor predeterminado es adaptive. Nota Este parámetro debe configurarse junto con el parámetro FrameRate.	fixed
FrameRate	number	La velocidad de fotogramas del video. El valor predeterminado es el mismo que el del video fuente.	25
ResolutionOption	string	La opción de resolución. Valores válidos: fixed: Siempre utiliza la resolución de video objetivo especificada. adaptive: Utiliza la resolución del video fuente cuando el área de resolución del video fuente es menor que el área de resolución de video objetivo especificada. fall: Devuelve un error cuando el área de resolución del video fuente es menor que el área de resolución de video objetivo especificada. Valor predeterminado: Para la API CreateMediaConvert, el valor predeterminado es fixed. Para la API GenerateVideoPlaylist, el valor predeterminado es adaptive. Nota Este parámetro debe configurarse junto con el parámetro Resolution.	fixed
Resolution	string	La resolución del video de salida en el formato `anchuraxaltura`. El valor predeterminado es el mismo que la resolución de reproducción del video fuente. Puede especificar tanto la anchura como la altura, o especificar solo la anchura o la altura. También puede usar el parámetro AdaptiveResolutionDirection para especificar tanto el lado largo como el corto, o solo el lado largo o el lado corto. El rango de valores para un solo lado es (0,4096]. Ejemplo 1: Si AdaptiveResolutionDirection es false, `1280x720` establece la anchura en 1280 y la altura en 720. `1280x` establece la anchura en 1280 y mantiene la altura igual a la del video fuente. `x720` establece la altura en 720 y mantiene la anchura igual a la del video fuente. Ejemplo 2: Si AdaptiveResolutionDirection es true, `1280x720` establece el lado largo en 1280 y el lado corto en 720. `1280x` establece el lado largo en 1280 y mantiene el lado corto igual al del video fuente. `x720` establece el lado corto en 720 y mantiene el lado largo igual al del video fuente. Nota Si el video fuente contiene información de rotación, la determinación de anchura/altura y lado largo/corto se basa en el estado posterior a la rotación, que corresponde a la resolución de reproducción.	640x480
AdaptiveResolutionDirection	boolean	Especifica si se debe habilitar el modo adaptativo de lado largo/corto. Valores válidos: true: Habilitado. El formato del parámetro Resolution es `lado largo × lado corto`. false (predeterminado): Deshabilitado. El formato del parámetro Resolution es `anchura × altura`.	true
ScaleType	string	El modo de escalado. Valores válidos: stretch (predeterminado): Anchura/altura o lados largos/cortos fijos. Fuerza el escalado y estira la imagen para llenar las áreas en blanco. crop: Escalado proporcional. Escala a la resolución mínima que excede el rectángulo de anchura/altura o lado largo/corto especificado, y luego recorta el exceso desde el centro. fill: Escalado proporcional. Escala a la resolución máxima dentro del rectángulo de anchura/altura o lado largo/corto especificado, y luego llena las áreas en blanco con negro usando alineación central. fit: Escalado proporcional. Escala a la resolución máxima dentro del rectángulo de anchura/altura o lado largo/corto especificado. Nota Este parámetro debe configurarse junto con el parámetro Resolution.	crop
Rotation	integer	El grado de rotación del video en sentido horario. Valores válidos: 0 (predeterminado) 90 180 270	90
BitrateOption	string	La opción de tasa de bits de video. Valores válidos: fixed: Siempre utiliza la tasa de bits de video objetivo especificada. adaptive: Utiliza la tasa de bits del video fuente cuando esta es inferior a la tasa de bits de video objetivo especificada. fall: Devuelve un error cuando la tasa de bits del video fuente es inferior a la tasa de bits de video objetivo especificada. Valor predeterminado: Para la API CreateMediaConvert, el valor predeterminado es fixed. Para la API GenerateVideoPlaylist, el valor predeterminado es adaptive. Nota Este parámetro debe configurarse junto con el parámetro Bitrate.	fixed
Bitrate	integer	La tasa de bits del flujo de video, en bits por segundo (bit/s). Nota Este parámetro es mutuamente excluyente con CRF. Si tanto este parámetro como CRF están vacíos, la codificación se realiza con un valor de CRF de 23.	128000
GOPSize	integer	El número de fotogramas entre fotogramas clave. Valor predeterminado: 150. Nota La API GenerateVideoPlaylist no admite este parámetro.	60
CRF	number	Especifica el modo de calidad constante. Este parámetro es mutuamente excluyente con el parámetro Bitrate. El rango de valores es [0,51]. Un valor mayor resulta en una menor calidad de video. El rango de valores recomendado es [18,38].	18
BufferSize	integer	El tamaño del búfer de decodificación para tasa de bits variable, en bits por segundo (bps). Nota Este parámetro solo surte efecto cuando se usa junto con el parámetro CRF.	4000000
MaxBitrate	integer	El límite máximo de tasa de bits para tasa de bits variable. Al usar este parámetro, se debe especificar el parámetro BufferSize. Nota Este parámetro solo surte efecto cuando se usa junto con el parámetro CRF.	128000
BFrames	integer	El número de B-frames consecutivos. Valor predeterminado: 3.	3
Refs	integer	El número de fotogramas de referencia. Valor predeterminado: 2.	2
VideoSlim	integer	Habilita el modo HD ligero. Valores válidos: 0: Valor predeterminado. Deshabilitado. 1: Utiliza el modo HD ligero para la transcodificación. Nota Para obtener resultados óptimos, utilice los parámetros Bitrate o CRF recomendados oficialmente para la codificación de transcodificación de video con HD ligero. Importante HD ligero solo admite formatos h.264/h.265, únicamente yuv420p, profundidad de 8 bits, y no admite salida de transcodificación de video multidestino ni concatenación de videos. Para más información, consulte Introducción al producto HD ligero.	0
FilterVideo	object	Los parámetros de procesamiento de video. Este parámetro no surte efecto cuando el parámetro TranscodeVideo está vacío o cuando TranscodeVideo.Codec se establece en copy. Nota La API GenerateVideoPlaylist no admite este parámetro.
Watermarks	array	La lista de marcas de agua de video.
	object	La información de la marca de agua de video.
Type	string	El tipo de marca de agua. Valores válidos: text (predeterminado): marca de agua de texto. file: marca de agua de imagen o imagen animada.	text
Dx	number	Los significados varían según si el valor es un entero o un decimal: 0 (predeterminado): Tanto el desplazamiento en píxeles como la proporción del desplazamiento horizontal respecto a la altura de la resolución de salida son 0. Entero: El desplazamiento en píxeles (px). Rango de valores: [1,4096]. Decimal: La proporción del desplazamiento horizontal respecto a la altura de la resolución de salida. Rango de valores: (0,1).	0
Dy	number	Los significados varían según si el valor es un entero o un decimal: 0 (predeterminado): Tanto el desplazamiento en píxeles como la proporción del desplazamiento vertical respecto a la altura de la resolución de salida son 0. Entero: El desplazamiento en píxeles (px). Rango de valores: [1,4096]. Decimal: La proporción del desplazamiento vertical respecto a la altura de la resolución de salida. Rango de valores: (0,1).	0
StartTime	number	La hora de inicio para agregar la marca de agua, en segundos (s). El valor predeterminado es la hora de inicio del video.	0
Duration	number	La duración durante la cual se muestra la marca de agua, en segundos (s). El valor predeterminado es hasta el final del video.	0
ReferPos	string	La posición de referencia para agregar la marca de agua. Valores válidos: topleft (predeterminado): esquina superior izquierda topright: esquina superior derecha bottomright: esquina inferior derecha bottomleft: esquina inferior izquierda	topleft
Content	string	El contenido de la marca de agua de texto. El valor predeterminado está vacío. Importante Este parámetro surte efecto cuando el parámetro `Type` se establece en `text`.	ejemplo
FontName	string	El nombre de la fuente de la marca de agua de texto. Valores válidos: SourceHanSans-Regular (predeterminado) SourceHanSans-Bold SourceHanSerif-Regular SourceHanSerif-Bold Importante Este parámetro surte efecto cuando el parámetro `Type` se establece en `text`.	SourceHanSans-Bold
FontSize	integer	El tamaño de fuente de la marca de agua de texto. Valor predeterminado: 16. El valor debe ser un entero. Rango de valores: (4,120). Importante Este parámetro surte efecto cuando el parámetro `Type` se establece en `text`.	18
FontColor	string	El color de fuente del texto de la marca de agua. El formato es #RRGGBB. Valor predeterminado: #000000. También se admiten valores como "red" y "green". Importante Este parámetro surte efecto cuando el parámetro `Type` se establece en `text`.	red
FontApha	number	La transparencia de la fuente de la marca de agua de texto. Rango de valores: (0,1]. Valor predeterminado: 1, que indica totalmente opaco. Importante Este parámetro surte efecto cuando el parámetro `Type` se establece en `text`.	0.8
BorderWidth	integer	El ancho del borde de la marca de agua de texto, en píxeles (px). El valor debe ser un entero. Rango de valores: [0,4096]. Valor predeterminado: 0. Importante Este parámetro surte efecto cuando el parámetro `Type` se establece en `text`.	2
BorderColor	string	El color del borde del texto de la marca de agua. El formato es #RRGGBB. Valor predeterminado: #000000. También se admiten valores como "red" y "green". Importante Este parámetro surte efecto cuando el parámetro `Type` se establece en `text`.	red
URI	string	El URI de OSS del archivo de marca de agua. Los formatos admitidos son PNG y MOV. El formato del URI de OSS es `oss://<bucket>/<object>`, donde `<bucket>` es el nombre de un bucket de OSS en la misma región que el proyecto actual, y `<object>` es la ruta completa del archivo, incluida la extensión del nombre del archivo. Importante Este parámetro surte efecto cuando el parámetro `Type` se establece en `file`.	oss://test-bucket/watermark.jpg
Width	number	El ancho de la imagen de la marca de agua. El valor predeterminado es el ancho original de la imagen de la marca de agua. Los significados varían según si el valor es un entero o un decimal: Entero: El valor en píxeles del ancho de eliminación del logotipo, en píxeles (px). Rango de valores: [1,4096]. Decimal: La proporción relativa al ancho de la resolución del video de salida. Rango de valores: (0,1).	80
Height	number	La altura de la imagen de la marca de agua. El valor predeterminado es la altura original de la imagen de la marca de agua. Los significados varían según si el valor es un entero o un decimal: Entero: El valor en píxeles de la altura de eliminación del logotipo, en píxeles (px). Rango de valores: [1,4096]. Decimal: La proporción relativa a la altura de la resolución del video de salida. Rango de valores: (0,1).	40
Delogos	array	Desenfoca un área rectangular del video para eliminar logotipos, marcas de canal y elementos similares.
	object	Los parámetros de procesamiento de desenfoque de video.
StartTime	number	La hora de inicio para agregar el mosaico, en segundos (s). El valor predeterminado es la hora de inicio del video.	0
Duration	number	La duración durante la cual se aplica el mosaico, en segundos (s). El valor predeterminado es hasta el final del video.	15
Dx	number	Los significados varían según si el valor es un entero o un decimal: 0 (predeterminado): Tanto el desplazamiento en píxeles como la proporción del desplazamiento horizontal respecto a la altura de la resolución de salida son 0. Entero: El desplazamiento en píxeles (px). Rango de valores: [1,4096]. Decimal: La proporción del desplazamiento horizontal respecto a la altura de la resolución de salida. Rango de valores: (0,1).	0
Dy	number	Valor predeterminado: 0. Los significados varían según si el valor es un entero o un decimal: 0 (predeterminado): Tanto el desplazamiento en píxeles como la proporción del desplazamiento vertical respecto a la altura de la resolución de salida son 0. Entero: El desplazamiento en píxeles (px). Rango de valores: [1,4096]. Decimal: La proporción del desplazamiento vertical respecto a la altura de la resolución de salida. Rango de valores: (0,1).	0
Width	number	El ancho del mosaico. El valor predeterminado es el decimal 1.0, que llena todo el ancho del video de salida. Los significados varían según si el valor es un entero o un decimal: Entero: El valor en píxeles, en píxeles (px). Rango de valores: [1,4096]. Decimal: La proporción relativa al ancho de la resolución del video de salida. Rango de valores: (0,1).	100
Height	number	La altura del mosaico. El valor predeterminado es el decimal 1.0, que llena toda la altura del video de salida. Los significados varían según si el valor es un entero o un decimal: Entero: El valor en píxeles, en píxeles (px). Rango de valores: [1,4096]. Decimal: La proporción relativa a la altura de la resolución del video de salida. Rango de valores: (0,1).	40
ReferPos	string	La posición de referencia para agregar el mosaico. Valores válidos: topleft (predeterminado): esquina superior izquierda topright: esquina superior derecha bottomright: esquina inferior derecha bottomleft: esquina inferior izquierda	topleft
Speed	number	La configuración de velocidad de reproducción de video. Rango de valores: [0.5,1.0]. Valor predeterminado: 1.0. Nota Esta es la proporción de la velocidad de reproducción del archivo multimedia transcodificado respecto a la velocidad de reproducción predeterminada del archivo multimedia de origen, no es una transcodificación acelerada. Importante Este parámetro solo es aplicable a la API CreateMediaConvertTask.	1.0
Desensitization	object	La configuración de desensibilización de video. Importante Este parámetro solo es aplicable a la API CreateMediaConvertTask.
Face	object	La configuración de desensibilización facial. Nota Esta función se encuentra en versión preliminar pública. Si tiene alguna pregunta, únase al grupo de DingTalk para enviar sus comentarios. Para obtener el número del grupo de DingTalk, consulte Contáctenos.
Confidence	number	El umbral de confianza facial, que establece el límite inferior de confianza para el reconocimiento facial. Si el valor de confianza de un rostro detectado es inferior a este umbral, el rostro no se desensibiliza. Rango de valores: 0.0 a 1.0. Valor predeterminado: 0.0 (no se realiza ningún filtrado por confianza).	0.4
MinSize	integer	El umbral de tamaño mínimo de rostro, que establece el tamaño mínimo de los rostros que se van a desensibilizar. Si el ancho o la altura de un rostro detectado es menor que este umbral, el rostro no se desensibiliza. Unidad: píxeles. Valor predeterminado: 0, que indica que no hay restricción en el tamaño del rostro.	0.4
ScaleRatio	number	La proporción de escala del cuadro de detección. Rango de valores: 0.1 a 5.0. Escala tanto el ancho como la altura del cuadro de detección basándose en su centro. • > 1.0: Amplía el área de desenfoque. • < 1.0: Reduce el área de desenfoque. • = 1.0: Utiliza el cuadro de detección original.	1.0
BlurRadius	integer	El radio de desenfoque. Rango de valores: 1 a 100. Un valor mayor generalmente resulta en un área más desenfocada.	100
Transparency	number	La transparencia y la intensidad del difuminado de bordes del área de desenfoque. Rango de valores: 0.0 a 1.0. • 0.0: Muestra el efecto de desenfoque completo. • 1.0: No se realiza ningún procesamiento de desenfoque. Solo se muestra la imagen original. • 0.0 a 1.0: Un valor mayor resulta en una mayor proporción de la imagen original, un radio de desenfoque real menor y, por lo general, un rango de difuminado de bordes mayor.	0.0
LicensePlate	object	La configuración de desensibilización de matrículas. Nota Esta función se encuentra en versión preliminar pública. Si tiene alguna pregunta, únase al grupo de DingTalk para enviar sus comentarios. Para obtener el número del grupo de DingTalk, consulte Contáctenos.
Confidence	number	El umbral de confianza de matrícula, que establece el límite inferior de confianza para el reconocimiento de matrículas. Si el valor de confianza de una matrícula detectada es inferior a este umbral, la matrícula no se desensibiliza. Rango de valores: 0.0 a 1.0. Valor predeterminado: 0.0 (no se realiza ningún filtrado por confianza).	0.4
MinSize	integer	El umbral de tamaño mínimo de matrícula, que establece el tamaño mínimo de las matrículas que se van a desensibilizar. Si el ancho o la altura de una matrícula detectada es menor que este umbral, la matrícula no se desensibiliza. Unidad: píxeles. Valor predeterminado: 0, que indica que no hay restricción en el tamaño de la matrícula.	0.4
ScaleRatio	number	La proporción de escala del cuadro de detección. Rango de valores: 0.1 a 5.0. Escala tanto el ancho como la altura del cuadro de detección basándose en su centro. • > 1.0: Amplía el área de desenfoque. • < 1.0: Reduce el área de desenfoque. • = 1.0: Utiliza el cuadro de detección original.	1.0
BlurRadius	integer	El radio de desenfoque. Rango de valores: 1 a 100. Un valor mayor generalmente resulta en un área más desenfocada.	100
Transparency	number	La transparencia y la intensidad del difuminado de bordes del área de desenfoque. Rango de valores: 0.0 a 1.0. • 0.0: Muestra el efecto de desenfoque completo. • 1.0: No se realiza ningún procesamiento de desenfoque. Solo se muestra la imagen original. • 0.0 a 1.0: Un valor mayor resulta en una mayor proporción de la imagen original, un radio de desenfoque real menor y, por lo general, un rango de difuminado de bordes mayor.	0.0

object

La configuración de parámetros de procesamiento de video.

DisableVideo

boolean

Especifica si se debe deshabilitar la generación de flujo de video. Valores válidos:

true: Deshabilitado. El archivo de salida no contiene un flujo de video.
false (predeterminado): No deshabilitado.

false

Stream

array

La lista de números de índice de flujos de video que se procesarán del archivo fuente. Un valor vacío (predeterminado) indica que se procesa el flujo de video con el número de índice más pequeño (el primer flujo de video). Un número de índice mayor que 100 indica que se procesan todos los flujos de video.

Ejemplo: [0,1] procesa los flujos de video con números de índice 0 y 1. [1] procesa el flujo de video con número de índice 1. [101] procesa todos los flujos de video.

Nota

Solo se procesan los flujos de video con números de índice existentes. Si no existe un flujo de video correspondiente a un número de índice, ese número de índice se ignora.

integer

El número de índice del flujo de video que se procesará.

0

TranscodeVideo

object

Los parámetros de transcodificación de video. Un valor vacío indica que el procesamiento de video está deshabilitado y que el archivo de salida no contiene un flujo de video.

Nota

No se recomienda establecer este parámetro en un valor vacío para deshabilitar el procesamiento de video.

Codec

string

El formato de codificación de video. Valores válidos:

Para la API CreateMediaConvert: copy (predeterminado), h264, h265, vp9.
Aviso Cuando este parámetro se establece en copy, los flujos de video que se van a procesar se copian directamente al archivo de salida, y otros parámetros bajo TranscodeVideo no surten efecto. copy no se puede utilizar para la concatenación de videos y se usa típicamente en escenarios de conversión de formato de contenedor.
Para la API GenerateVideoPlaylist: h264 (predeterminado), h265.

h264

PixelFormat

string

El formato de píxel. El valor predeterminado es el mismo que el del video fuente. Valores válidos:

yuv420p
yuv422p
yuv444p
yuv420p10le
yuv422p10le
yuv444p10le
yuva420p

Nota

yuva420p solo está disponible para la API CreateMediaConvert, y el parámetro Codec debe establecerse en vp9.

yuv420p

FrameRateOption

string

La opción de velocidad de fotogramas. Valores válidos:

fixed: Siempre utiliza la velocidad de fotogramas de video objetivo especificada.
adaptive: Utiliza la velocidad de fotogramas del video fuente cuando esta es inferior a la velocidad de fotogramas de video objetivo especificada.
fall: Devuelve un error cuando la velocidad de fotogramas del video fuente es inferior a la velocidad de fotogramas de video objetivo especificada.

Valor predeterminado:

Para la API CreateMediaConvert, el valor predeterminado es fixed.
Para la API GenerateVideoPlaylist, el valor predeterminado es adaptive.

Nota

Este parámetro debe configurarse junto con el parámetro FrameRate.

fixed

FrameRate

number

La velocidad de fotogramas del video. El valor predeterminado es el mismo que el del video fuente.

25

ResolutionOption

string

La opción de resolución. Valores válidos:

fixed: Siempre utiliza la resolución de video objetivo especificada.
adaptive: Utiliza la resolución del video fuente cuando el área de resolución del video fuente es menor que el área de resolución de video objetivo especificada.
fall: Devuelve un error cuando el área de resolución del video fuente es menor que el área de resolución de video objetivo especificada.

Valor predeterminado:

Para la API CreateMediaConvert, el valor predeterminado es fixed.
Para la API GenerateVideoPlaylist, el valor predeterminado es adaptive.

Nota

Este parámetro debe configurarse junto con el parámetro Resolution.

fixed

Resolution

string

La resolución del video de salida en el formato anchuraxaltura. El valor predeterminado es el mismo que la resolución de reproducción del video fuente. Puede especificar tanto la anchura como la altura, o especificar solo la anchura o la altura. También puede usar el parámetro AdaptiveResolutionDirection para especificar tanto el lado largo como el corto, o solo el lado largo o el lado corto. El rango de valores para un solo lado es (0,4096].

Ejemplo 1: Si AdaptiveResolutionDirection es false, 1280x720 establece la anchura en 1280 y la altura en 720. 1280x establece la anchura en 1280 y mantiene la altura igual a la del video fuente. x720 establece la altura en 720 y mantiene la anchura igual a la del video fuente.
Ejemplo 2: Si AdaptiveResolutionDirection es true, 1280x720 establece el lado largo en 1280 y el lado corto en 720. 1280x establece el lado largo en 1280 y mantiene el lado corto igual al del video fuente. x720 establece el lado corto en 720 y mantiene el lado largo igual al del video fuente.

Nota

Si el video fuente contiene información de rotación, la determinación de anchura/altura y lado largo/corto se basa en el estado posterior a la rotación, que corresponde a la resolución de reproducción.

640x480

AdaptiveResolutionDirection

boolean

Especifica si se debe habilitar el modo adaptativo de lado largo/corto. Valores válidos:

true: Habilitado. El formato del parámetro Resolution es lado largo × lado corto.
false (predeterminado): Deshabilitado. El formato del parámetro Resolution es anchura × altura.

true

ScaleType

string

El modo de escalado. Valores válidos:

stretch (predeterminado): Anchura/altura o lados largos/cortos fijos. Fuerza el escalado y estira la imagen para llenar las áreas en blanco.
crop: Escalado proporcional. Escala a la resolución mínima que excede el rectángulo de anchura/altura o lado largo/corto especificado, y luego recorta el exceso desde el centro.
fill: Escalado proporcional. Escala a la resolución máxima dentro del rectángulo de anchura/altura o lado largo/corto especificado, y luego llena las áreas en blanco con negro usando alineación central.
fit: Escalado proporcional. Escala a la resolución máxima dentro del rectángulo de anchura/altura o lado largo/corto especificado.

Nota

Este parámetro debe configurarse junto con el parámetro Resolution.

crop

Rotation

integer

El grado de rotación del video en sentido horario. Valores válidos:

0 (predeterminado)
90
180
270

90

BitrateOption

string

La opción de tasa de bits de video. Valores válidos:

fixed: Siempre utiliza la tasa de bits de video objetivo especificada.
adaptive: Utiliza la tasa de bits del video fuente cuando esta es inferior a la tasa de bits de video objetivo especificada.
fall: Devuelve un error cuando la tasa de bits del video fuente es inferior a la tasa de bits de video objetivo especificada.

Valor predeterminado:

Para la API CreateMediaConvert, el valor predeterminado es fixed.
Para la API GenerateVideoPlaylist, el valor predeterminado es adaptive.

Nota

Este parámetro debe configurarse junto con el parámetro Bitrate.

fixed

Bitrate

integer

La tasa de bits del flujo de video, en bits por segundo (bit/s).

Nota

Este parámetro es mutuamente excluyente con CRF. Si tanto este parámetro como CRF están vacíos, la codificación se realiza con un valor de CRF de 23.

128000

GOPSize

integer

El número de fotogramas entre fotogramas clave. Valor predeterminado: 150.

Nota

La API GenerateVideoPlaylist no admite este parámetro.

60

CRF

number

Especifica el modo de calidad constante. Este parámetro es mutuamente excluyente con el parámetro Bitrate. El rango de valores es [0,51]. Un valor mayor resulta en una menor calidad de video. El rango de valores recomendado es [18,38].

18

BufferSize

integer

El tamaño del búfer de decodificación para tasa de bits variable, en bits por segundo (bps).

Nota

Este parámetro solo surte efecto cuando se usa junto con el parámetro CRF.

4000000

MaxBitrate

integer

El límite máximo de tasa de bits para tasa de bits variable. Al usar este parámetro, se debe especificar el parámetro BufferSize.

Nota

Este parámetro solo surte efecto cuando se usa junto con el parámetro CRF.

128000

BFrames

integer

El número de B-frames consecutivos. Valor predeterminado: 3.

3

Refs

integer

El número de fotogramas de referencia. Valor predeterminado: 2.

2

VideoSlim

integer

Habilita el modo HD ligero. Valores válidos:

0: Valor predeterminado. Deshabilitado.

1: Utiliza el modo HD ligero para la transcodificación.

Nota

Para obtener resultados óptimos, utilice los parámetros Bitrate o CRF recomendados oficialmente para la codificación de transcodificación de video con HD ligero.

Importante HD ligero solo admite formatos h.264/h.265, únicamente yuv420p, profundidad de 8 bits, y no admite salida de transcodificación de video multidestino ni concatenación de videos. Para más información, consulte Introducción al producto HD ligero.

0

FilterVideo

object

Los parámetros de procesamiento de video. Este parámetro no surte efecto cuando el parámetro TranscodeVideo está vacío o cuando TranscodeVideo.Codec se establece en copy.

Nota

La API GenerateVideoPlaylist no admite este parámetro.

Watermarks

array

La lista de marcas de agua de video.

object

La información de la marca de agua de video.

Type

string

El tipo de marca de agua. Valores válidos:

text (predeterminado): marca de agua de texto.
file: marca de agua de imagen o imagen animada.

text

Dx

number

Los significados varían según si el valor es un entero o un decimal:

0 (predeterminado): Tanto el desplazamiento en píxeles como la proporción del desplazamiento horizontal respecto a la altura de la resolución de salida son 0.
Entero: El desplazamiento en píxeles (px). Rango de valores: [1,4096].
Decimal: La proporción del desplazamiento horizontal respecto a la altura de la resolución de salida. Rango de valores: (0,1).

0

Dy

number

Los significados varían según si el valor es un entero o un decimal:

0 (predeterminado): Tanto el desplazamiento en píxeles como la proporción del desplazamiento vertical respecto a la altura de la resolución de salida son 0.
Entero: El desplazamiento en píxeles (px). Rango de valores: [1,4096].
Decimal: La proporción del desplazamiento vertical respecto a la altura de la resolución de salida. Rango de valores: (0,1).

0

StartTime

number

La hora de inicio para agregar la marca de agua, en segundos (s). El valor predeterminado es la hora de inicio del video.

0

Duration

number

La duración durante la cual se muestra la marca de agua, en segundos (s). El valor predeterminado es hasta el final del video.

0

ReferPos

string

La posición de referencia para agregar la marca de agua. Valores válidos:

topleft (predeterminado): esquina superior izquierda
topright: esquina superior derecha
bottomright: esquina inferior derecha
bottomleft: esquina inferior izquierda

topleft

Content

string

El contenido de la marca de agua de texto. El valor predeterminado está vacío.