Transforms - Create Or Update

Crear o actualizar transformación
Crea o actualiza una nueva transformación.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}?api-version=2020-05-01

Parámetros de identificador URI

Name In Required Type Description
accountName
path True
  • string

Nombre Media Services cuenta.

resourceGroupName
path True
  • string

Nombre del grupo de recursos dentro de la suscripción de Azure.

subscriptionId
path True
  • string

Identificador único de una Microsoft Azure suscripción.

transformName
path True
  • string

Nombre de transformación.

api-version
query True
  • string

La versión de la API que se va a usar con la solicitud de cliente.

Cuerpo de la solicitud

Name Required Type Description
properties.outputs True

Una matriz de uno o más elementos TransformOutputs que debe generar la transformación.

properties.description
  • string

Una descripción detallada opcional de la transformación.

Respuestas

Name Type Description
200 OK

Aceptar

201 Created

Creado

Other Status Codes

Información detallada del error.

Ejemplos

Create or update a Transform

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/createdTransform?api-version=2020-05-01
{
  "properties": {
    "description": "Example Transform to illustrate create and update.",
    "outputs": [
      {
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  }
}

Sample Response

{
  "name": "createdTransform",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
  "type": "Microsoft.Media/mediaservices/transforms",
  "properties": {
    "created": "2021-01-26T13:35:47.7499582-08:00",
    "description": "Example Transform to illustrate create and update.",
    "lastModified": "2021-01-26T13:35:47.7499582-08:00",
    "outputs": [
      {
        "onError": "StopProcessingJob",
        "relativePriority": "Normal",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2021-01-26T13:35:47.7499582Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-26T13:35:47.7499582Z"
  }
}
{
  "name": "createdTransform",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
  "type": "Microsoft.Media/mediaservices/transforms",
  "properties": {
    "created": "2021-01-26T13:35:47.7499582-08:00",
    "description": "Example Transform to illustrate create and update.",
    "lastModified": "2021-01-26T13:35:47.7499582-08:00",
    "outputs": [
      {
        "onError": "StopProcessingJob",
        "relativePriority": "Normal",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2021-01-26T13:35:47.7499582Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-26T13:35:47.7499582Z"
  }
}

Definiciones

AacAudio

Describe la configuración de codificación de audio de Códec de audio avanzado (AAC).

AacAudioProfile

Perfil de codificación que se va a usar al codificar audio con AAC.

AnalysisResolution

Especifica la resolución máxima en la que se analiza el vídeo. El comportamiento predeterminado es "SourceResolution", que mantendrá el vídeo de entrada en su resolución original cuando se analice. El uso de "StandardDefinition" cambia el tamaño de los vídeos de entrada a la definición estándar, al tiempo que se conserva la relación de aspecto adecuada. Solo cambiará de tamaño si el vídeo tiene una resolución más alta. Por ejemplo, una entrada de 1920 x 1080 se escalaría a 640 x 360 antes del procesamiento. Cambiar a "StandardDefinition" reducirá el tiempo que se tarda en procesar vídeo de alta resolución. También puede reducir el costo de usar este componente (consulte https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para más información). Sin embargo, es posible que no se detecten caras que terminen siendo demasiado pequeñas en el vídeo con cambio de tamaño.

ApiError

Error de API.

Audio

Define las propiedades comunes de todos los códecs de audio.

AudioAnalysisMode

Determina el conjunto de operaciones de análisis de audio que se realizarán. Si no se especifica, se elegiría Standard AudioAnalysisMode.

AudioAnalyzerPreset

El valor preestablecido del Analizador de audio aplica un conjunto predefinido de operaciones de análisis basadas en inteligencia artificial, incluida la transcripción de voz. Actualmente, el valor predeterminado admite el procesamiento de contenido con una sola pista de audio.

AudioOverlay

Describe las propiedades de una superposición de audio.

BlurType

Tipo de desenfoque

BuiltInStandardEncoderPreset

Describe un valor preestablecido integrado para codificar el vídeo de entrada con el codificador estándar.

CopyAudio

Marca de códec, que indica al codificador que copie la secuencia de bits de audio de entrada.

CopyVideo

Marca de códec, que indica al codificador que copie la secuencia de bits del vídeo de entrada sin volver a codificar.

createdByType

Tipo de identidad que creó el recurso.

Deinterlace

Describe la configuración de desenlazado.

DeinterlaceMode

Modo de desenlazado. El valor predeterminado es AutoPixelAdaptive.

DeinterlaceParity

La paridad de campos para desenlazar tiene como valor predeterminado Auto.

EncoderNamedPreset

El valor preestablecido integrado que se usará para codificar vídeos.

EntropyMode

Modo de entropía que se va a usar para esta capa. Si no se especifica, el codificador elige el modo adecuado para el perfil y el nivel.

FaceDetectorPreset

Describe toda la configuración que se va a usar al analizar un vídeo con el fin de detectar (y, opcionalmente, censurar) todas las caras presentes.

FaceRedactorMode

Este modo proporciona la capacidad de elegir entre la siguiente configuración: 1) Analizar: solo para la detección. Este modo genera un archivo JSON de metadatos que marca las apariencias de las caras a lo largo del vídeo. Siempre que sea posible, a las apariencias de la misma persona se les asigna el mismo identificador. 2) Combinado: además, censura (desenfoca) las caras detectadas. 3) Redact: permite un proceso de dos pasos, lo que permite la censura selectiva de un subconjunto de caras detectadas. Toma el archivo de metadatos de un paso de análisis anterior, junto con el vídeo de origen, y un subconjunto seleccionado por el usuario de los id. que requieren censura.

Filters

Describe todas las operaciones de filtrado, como el desenlazado, la rotación, etc., que se van a aplicar a los medios de entrada antes de la codificación.

H264Complexity

Indica al codificador cómo elegir su configuración de codificación. El valor predeterminado es Balanced.

H264Layer

Describe la configuración que se va a usar al codificar el vídeo de entrada en una capa de velocidad de bits de salida deseada con el códec de vídeo H.264.

H264Video

Describe todas las propiedades para codificar un vídeo con el códec H.264.

H264VideoProfile

Actualmente se admiten Baseline, Main, High, High422 y High444. El valor predeterminado es Auto.

H265Complexity

Indica al codificador cómo elegir su configuración de codificación. La calidad proporcionará una mayor relación de compresión, pero con un costo mayor y un tiempo de proceso más largo. La velocidad producirá un archivo relativamente mayor, pero es más rápido y económico. El valor predeterminado es Balanced.

H265Layer

Describe la configuración que se va a usar al codificar el vídeo de entrada en una capa de velocidad de bits de salida deseada con el códec de vídeo H.265.

H265Video

Describe todas las propiedades para codificar un vídeo con el códec H.265.

H265VideoProfile

Actualmente se admite Main. El valor predeterminado es Auto.

Image

Describe las propiedades básicas para generar miniaturas a partir del vídeo de entrada.

ImageFormat

Describe las propiedades de un archivo de imagen de salida.

InsightsType

Define el tipo de información que desea que genere el servicio. Los valores permitidos son "AudioInsightsOnly", "VideoInsightsOnly" y "AllInsights". El valor predeterminado es AllInsights. Si establece esta opción en AllInsights y la entrada es solo audio, solo se genera información de audio. De forma similar, si la entrada es solo de vídeo, solo se genera información de vídeo. Se recomienda no usar AudioInsightsOnly si espera que algunas de las entradas sean solo de vídeo. o use VideoInsightsOnly si espera que algunas de las entradas sean solo audio. Los trabajos en estas condiciones generarían un error.

JpgFormat

Describe la configuración para generar miniaturas JPEG.

JpgImage

Describe las propiedades para generar una serie de imágenes JPEG a partir del vídeo de entrada.

JpgLayer

Describe la configuración para generar una imagen JPEG a partir del vídeo de entrada.

Mp4Format

Describe las propiedades de un archivo MP4 ISO de salida.

MultiBitrateFormat

Describe las propiedades para generar una colección de archivos de velocidad de bits múltiple alineados con GOP. El comportamiento predeterminado es generar un archivo de salida para cada capa de vídeo que se muxed junto con todos los audios. Los archivos de salida exactos generados se pueden controlar especificando la colección outputFiles.

ODataError

Información sobre un error.

OnErrorType

Una transformación puede definir más de una salida. Esta propiedad define lo que debe hacer el servicio cuando se produce un error en una salida: continuar generando otras salidas o detener las demás salidas. El estado general del trabajo no reflejará los errores de las salidas que se especifican con "ContinueJob". El valor predeterminado es "StopProcessingJob".

OutputFile

Representa un archivo de salida generado.

PngFormat

Describe la configuración para generar miniaturas PNG.

PngImage

Describe las propiedades para generar una serie de imágenes PNG a partir del vídeo de entrada.

PngLayer

Describe la configuración para generar una imagen PNG a partir del vídeo de entrada.

Priority

Establece la prioridad relativa de TransformOutputs dentro de una transformación. Esto establece la prioridad que el servicio usa para procesar TransformOutputs. La prioridad predeterminada es Normal.

Rectangle

Describe las propiedades de una ventana rectangular aplicada al medio de entrada antes de procesarla.

Rotation

Rotación, si existe, que se va a aplicar al vídeo de entrada, antes de codificarse. El valor predeterminado es Auto

StandardEncoderPreset

Describe toda la configuración que se va a usar al codificar el vídeo de entrada con el codificador estándar.

StretchMode

El modo de cambio de tamaño: cómo se cambia el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Transform

Una transformación encapsula las reglas o instrucciones para generar salidas deseadas a partir de medios de entrada, como transcodificación o extracción de información. Una vez creada la transformación, se puede aplicar a los medios de entrada mediante la creación de trabajos.

TransformOutput

Describe las propiedades de un objeto TransformOutput, que son las reglas que se aplicarán al generar la salida deseada.

TransportStreamFormat

Describe las propiedades para generar archivos de vídeo de salida mpeg-2 transport stream (ISO/IEC 13818-1).

Video

Describe las propiedades básicas para codificar el vídeo de entrada.

VideoAnalyzerPreset

Un valor preestablecido del analizador de vídeo que extrae información (metadatos enriquecidos) de audio y vídeo, y genera un archivo de formato JSON.

VideoOverlay

Describe las propiedades de una superposición de vídeo.

VideoSyncMode

Modo de sincronización de vídeo

AacAudio

Describe la configuración de codificación de audio de Códec de audio avanzado (AAC).

Name Type Description
@odata.type string:
  • #Microsoft.Media.AacAudio

Discriminador para tipos derivados.

bitrate
  • integer

Velocidad de bits, en bits por segundo, del audio codificado de salida.

channels
  • integer

Número de canales del audio.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de la experiencia de usuario.

profile

Perfil de codificación que se va a usar al codificar audio con AAC.

samplingRate
  • integer

Velocidad de muestreo que se usará para la codificación en hertz.

AacAudioProfile

Perfil de codificación que se va a usar al codificar audio con AAC.

Name Type Description
AacLc
  • string

Especifica que el audio de salida se codificará en el perfil de baja complejidad de AAC (AAC-LC).

HeAacV1
  • string

Especifica que el audio de salida se codificará en el perfil HE-AAC v1.

HeAacV2
  • string

Especifica que el audio de salida se va a codificar en el perfil de HE-AAC v2.

AnalysisResolution

Especifica la resolución máxima en la que se analiza el vídeo. El comportamiento predeterminado es "SourceResolution", que mantendrá el vídeo de entrada en su resolución original cuando se analice. El uso de "StandardDefinition" cambia el tamaño de los vídeos de entrada a la definición estándar, al tiempo que se conserva la relación de aspecto adecuada. Solo cambiará de tamaño si el vídeo tiene una resolución más alta. Por ejemplo, una entrada de 1920 x 1080 se escalaría a 640 x 360 antes del procesamiento. Cambiar a "StandardDefinition" reducirá el tiempo que se tarda en procesar vídeo de alta resolución. También puede reducir el costo de usar este componente (consulte https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para más información). Sin embargo, es posible que no se detecten caras que terminen siendo demasiado pequeñas en el vídeo con cambio de tamaño.

Name Type Description
SourceResolution
  • string
StandardDefinition
  • string

ApiError

Error de API.

Name Type Description
error

Propiedades de error.

Audio

Define las propiedades comunes de todos los códecs de audio.

Name Type Description
@odata.type string:
  • #Microsoft.Media.Audio

Discriminador para tipos derivados.

bitrate
  • integer

Velocidad de bits, en bits por segundo, del audio codificado de salida.

channels
  • integer

Número de canales del audio.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de muxing.

samplingRate
  • integer

Frecuencia de muestreo que se usará para la codificación en hertz.

AudioAnalysisMode

Determina el conjunto de operaciones de análisis de audio que se realizarán. Si no se especifica, se elegiría Standard AudioAnalysisMode.

Name Type Description
Basic
  • string

Este modo realiza la transcripción de voz a texto y la generación de un archivo de subtítulos VTT. La salida de este modo incluye un archivo JSON de información, que incluye solo las palabras clave, la transcripción y la información de tiempo. La detección automática de idioma y la diarización de los altavoces no se incluyen en este modo.

Standard
  • string

Realiza todas las operaciones incluidas en el modo Básico, además de realizar la detección de idioma y la diarización del hablante.

AudioAnalyzerPreset

El valor preestablecido del Analizador de audio aplica un conjunto predefinido de operaciones de análisis basadas en inteligencia artificial, incluida la transcripción de voz. Actualmente, el valor predeterminado admite el procesamiento de contenido con una sola pista de audio.

Name Type Description
@odata.type string:
  • #Microsoft.Media.AudioAnalyzerPreset

Discriminador para tipos derivados.

audioLanguage
  • string

Idioma de la carga de audio en la entrada con el formato BCP-47 de "language tag-region" (por ejemplo, "en-US"). Si conoce el idioma del contenido, se recomienda especificarlo. El idioma debe especificarse explícitamente para AudioAnalysisMode::Basic, ya que la detección automática de idioma no se incluye en el modo básico. Si el idioma no se especifica o se establece en null, la detección automática de idioma elegirá el primer idioma detectado y realizará el procesamiento con el idioma seleccionado lo que dure el archivo. Por ahora no se admite el cambio dinámico entre idiomas una vez detectado el primer idioma. La detección automática funciona mejor con grabaciones de audio con voz claramente reconocible. Si la detección automática no encuentra el idioma, la transcripción se reservaría a "en-US"." La lista de idiomas admitidos está disponible aquí: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions
  • object

Diccionario que contiene pares clave-valor para parámetros no expuestos en el propio valor preestablecido

mode

Determina el conjunto de operaciones de análisis de audio que se realizarán. Si no se especifica, se elegiría Standard AudioAnalysisMode.

AudioOverlay

Describe las propiedades de una superposición de audio.

Name Type Description
@odata.type string:
  • #Microsoft.Media.AudioOverlay

Discriminador para tipos derivados.

audioGainLevel
  • number

Nivel de ganancia de audio en la superposición. El valor debe estar en el intervalo [0, 1,0]. El valor predeterminado es 1.0.

end
  • string

Posición final, con referencia al vídeo de entrada, donde finaliza la superposición. El valor debe estar en formato ISO 8601. Por ejemplo, PT30S para finalizar la superposición en 30 segundos en el vídeo de entrada. Si no se especifica o el valor es mayor que la duración del vídeo de entrada, la superposición se aplicará hasta el final del vídeo de entrada si la duración del medio superpuesto es mayor que la duración del vídeo de entrada; de lo contrario, la superposición se mantendrá siempre que la duración del medio superpuesto.

fadeInDuration
  • string

Duración durante la que la superposición se atenua en el vídeo de entrada. El valor debe estar en formato de duración ISO 8601. Si no se especifica, el comportamiento predeterminado es no atenuarse (igual que PT0S).

fadeOutDuration
  • string

La duración durante la que la superposición desaparece del vídeo de entrada. El valor debe estar en formato de duración ISO 8601. Si no se especifica, el comportamiento predeterminado es no atenuarse (igual que PT0S).

inputLabel
  • string

Etiqueta de la entrada del trabajo que se va a usar como superposición. La entrada debe especificar exactamente un archivo. Puede especificar un archivo de imagen en formato JPG, PNG, GIF o BMP, un archivo de audio (por ejemplo, un archivo WAV, MP3, WMA o M4A) o un archivo de vídeo. Consulte https://aka.ms/mesformats para obtener la lista completa de los formatos de archivo de audio y vídeo admitidos.

start
  • string

Posición inicial, con referencia al vídeo de entrada, donde se inicia la superposición. El valor debe estar en formato ISO 8601. Por ejemplo, PT05S para iniciar la superposición en 5 segundos en el vídeo de entrada. Si no se especifica, la superposición comienza desde el principio del vídeo de entrada.

BlurType

Tipo de desenfoque

Name Type Description
Black
  • string

Negro: filtro de apagón

Box
  • string

Cuadro: filtro de depuración, solo cuadro de límite

High
  • string

Alto: Filtro de desenfoque confuso

Low
  • string

Baja: filtro de desenfoque de caja de automóvil

Med
  • string

Argentina: filtro de desenfoque gaussiano

BuiltInStandardEncoderPreset

Describe un valor preestablecido integrado para codificar el vídeo de entrada con el codificador estándar.

Name Type Description
@odata.type string:
  • #Microsoft.Media.BuiltInStandardEncoderPreset

Discriminador para tipos derivados.

presetName

El valor preestablecido integrado que se usará para codificar vídeos.

CopyAudio

Marca de códec, que indica al codificador que copie la secuencia de bits de audio de entrada.

Name Type Description
@odata.type string:
  • #Microsoft.Media.CopyAudio

Discriminador para tipos derivados.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de muxing.

CopyVideo

Marca de códec, que indica al codificador que copie la secuencia de bits del vídeo de entrada sin volver a codificar.

Name Type Description
@odata.type string:
  • #Microsoft.Media.CopyVideo

Discriminador para tipos derivados.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de muxing.

createdByType

Tipo de identidad que creó el recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

Deinterlace

Describe la configuración de desenlazado.

Name Type Description
mode

Modo de desenlazado. El valor predeterminado es AutoPixelAdaptive.

parity

La paridad de campos para desenlazar tiene como valor predeterminado Auto.

DeinterlaceMode

Modo de desenlazado. El valor predeterminado es AutoPixelAdaptive.

Name Type Description
AutoPixelAdaptive
  • string

Aplique el desenlazado adaptable de píxeles automático en cada fotograma del vídeo de entrada.

Off
  • string

Deshabilita el desenlazado del vídeo de origen.

DeinterlaceParity

La paridad de campos para desenlazar tiene como valor predeterminado Auto.

Name Type Description
Auto
  • string

Detectar automáticamente el orden de los campos

BottomFieldFirst
  • string

Aplique el primer procesamiento del campo inferior del vídeo de entrada.

TopFieldFirst
  • string

Aplique el primer procesamiento de campo superior del vídeo de entrada.

EncoderNamedPreset

El valor preestablecido integrado que se usará para codificar vídeos.

Name Type Description
AACGoodQualityAudio
  • string

Genera un único archivo MP4 que contiene solo audio estéreo codificado a 192 kbps.

AdaptiveStreaming
  • string

Genera un conjunto de archivos MP4 alineados con GOP con vídeo H.264 y audio AAC estéreo. Genera automáticamente una escala de velocidad de bits basada en la resolución de entrada, la tasa de bits y la velocidad de fotogramas. El valor preestablecido que se generó automáticamente nunca superará la resolución de entrada. Por ejemplo, si la entrada es 720p, la salida permanecerá en 720p en el mejor de los casos.

ContentAwareEncoding
  • string

Genera un conjunto de MP4 alineados con GOP mediante la codificación según el contenido. Dado cualquier contenido de entrada, el servicio realiza un análisis ligero inicial del mismo y usa los resultados para determinar automáticamente el número óptimo de capas, la velocidad de bits adecuada y la configuración de resolución para la entrega a través del streaming adaptable. Este valor predefinido resulta particularmente eficaz en los vídeos de complejidad baja y media, donde los archivos de salida tendrán velocidades de bits más lentas, pero una calidad que seguirá ofreciendo una buena experiencia a los espectadores. La salida contendrá archivos MP4 con el vídeo y audio intercalados.

ContentAwareEncodingExperimental
  • string

Expone un valor preestablecido experimental para la codificación según el contenido. Dado cualquier contenido de entrada, el servicio intenta determinar automáticamente el número óptimo de capas, la velocidad de bits adecuada y la configuración de resolución para la entrega a través del streaming adaptable. Los algoritmos subyacentes seguirán evolucionando con el tiempo. La salida contendrá archivos MP4 con el vídeo y audio intercalados.

CopyAllBitrateNonInterleaved
  • string

Copie todas las secuencias de vídeo y audio del recurso de entrada como archivos de salida de audio y vídeo no intercalados. Este valor preestablecido se puede usar para recortar un recurso existente o convertir un grupo de archivos MP4 alineados con fotogramas clave (GOP) como un recurso que se puede transmitir.

H264MultipleBitrate1080p
  • string

Genera un conjunto de 8 archivos MP4 alineados con GOP, que abarcan desde 6000 kbps hasta 400 kbps y audio AAC estéreo. La resolución comienza en 1080p y baja a 180p.

H264MultipleBitrate720p
  • string

Genera un conjunto de 6 archivos MP4 alineados con GOP, que abarcan desde 3400 kbps hasta 400 kbps y audio AAC estéreo. La resolución comienza en 720p y baja a 180p.

H264MultipleBitrateSD
  • string

Genera un conjunto de 5 archivos MP4 alineados con GOP, que abarcan desde 1900 kbps hasta 400 kbps y audio AAC estéreo. La resolución comienza en 480p y baja a 240p.

H264SingleBitrate1080p
  • string

Genera un archivo MP4 donde el vídeo se codifica con el códec H.264 a 6750 kbps y una altura de imagen de 1080 píxeles, y el audio estéreo se codifica con el códec AAC-LC a 128 kbps.

H264SingleBitrate720p
  • string

Genera un archivo MP4 donde el vídeo está codificado con el códec H.264 a 4500 kbps y una altura de imagen de 720 píxeles, y el audio estéreo se codifica con el códec AAC-LC a 128 kbps.

H264SingleBitrateSD
  • string

Genera un archivo MP4 donde el vídeo está codificado con el códec H.264 a 2200 kbps y una altura de imagen de 480 píxeles, y el audio estéreo se codifica con el códec AAC-LC a 128 kbps.

H265AdaptiveStreaming
  • string

Genera un conjunto de archivos MP4 alineados con GOP con vídeo H.265 y audio AAC estéreo. Genera automáticamente una escala de velocidad de bits basada en la resolución de entrada, la tasa de bits y la velocidad de fotogramas. El valor preestablecido que se generó automáticamente nunca superará la resolución de entrada. Por ejemplo, si la entrada es 720p, la salida permanecerá en 720p en el mejor de los casos.

H265ContentAwareEncoding
  • string

Genera un conjunto de MP4 alineados con GOP mediante la codificación según el contenido. Dado cualquier contenido de entrada, el servicio realiza un análisis ligero inicial del mismo y usa los resultados para determinar automáticamente el número óptimo de capas, la velocidad de bits adecuada y la configuración de resolución para la entrega a través del streaming adaptable. Este valor predefinido resulta particularmente eficaz en los vídeos de complejidad baja y media, donde los archivos de salida tendrán velocidades de bits más lentas, pero una calidad que seguirá ofreciendo una buena experiencia a los espectadores. La salida contendrá archivos MP4 con el vídeo y audio intercalados.

H265SingleBitrate1080p
  • string

Genera un archivo MP4 donde el vídeo se codifica con el códec H.265 a 3500 kbps y una altura de imagen de 1080 píxeles, y el audio estéreo se codifica con el códec AAC-LC a 128 kbps.

H265SingleBitrate4K
  • string

Genera un archivo MP4 donde el vídeo se codifica con el códec H.265 a 9500 kbps y una altura de imagen de 2160 píxeles, y el audio estéreo se codifica con el códec AAC-LC a 128 kbps.

H265SingleBitrate720p
  • string

Genera un archivo MP4 donde el vídeo se codifica con el códec H.265 a 1800 kbps y una altura de imagen de 720 píxeles, y el audio estéreo se codifica con el códec AAC-LC a 128 kbps.

EntropyMode

Modo de entropía que se va a usar para esta capa. Si no se especifica, el codificador elige el modo adecuado para el perfil y el nivel.

Name Type Description
Cabac
  • string

Codificación de entropía de Context Adaptive Binary Arithmetic Coder (CABAC).

Cavlc
  • string

Codificación de entropía de longitud variable adaptable de contexto (VBALC).

FaceDetectorPreset

Describe toda la configuración que se va a usar al analizar un vídeo con el fin de detectar (y, opcionalmente, censurar) todas las caras presentes.

Name Type Description
@odata.type string:
  • #Microsoft.Media.FaceDetectorPreset

Discriminador para tipos derivados.

blurType

Tipo de desenfoque

experimentalOptions
  • object

Diccionario que contiene pares clave-valor para parámetros no expuestos en el propio valor preestablecido

mode

Este modo proporciona la capacidad de elegir entre la siguiente configuración: 1) Analizar: solo para la detección. Este modo genera un archivo JSON de metadatos que marca las apariencias de las caras a lo largo del vídeo. Siempre que sea posible, a las apariencias de la misma persona se les asigna el mismo identificador. 2) Combinado: además, censura (desenfoca) las caras detectadas. 3) Redact: permite un proceso de dos pasos, lo que permite la censura selectiva de un subconjunto de caras detectadas. Toma el archivo de metadatos de un paso de análisis anterior, junto con el vídeo de origen, y un subconjunto seleccionado por el usuario de los id. que requieren censura.

resolution

Especifica la resolución máxima en la que se analiza el vídeo. El comportamiento predeterminado es "SourceResolution", que mantendrá el vídeo de entrada en su resolución original cuando se analice. El uso de "StandardDefinition" cambia el tamaño de los vídeos de entrada a la definición estándar, al tiempo que se conserva la relación de aspecto adecuada. Solo cambiará de tamaño si el vídeo tiene una resolución más alta. Por ejemplo, una entrada de 1920 x 1080 se escalaría a 640 x 360 antes del procesamiento. Cambiar a "StandardDefinition" reducirá el tiempo que se tarda en procesar vídeo de alta resolución. También puede reducir el costo de usar este componente (consulte https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para más información). Sin embargo, es posible que no se detecten caras que terminen siendo demasiado pequeñas en el vídeo con cambio de tamaño.

FaceRedactorMode

Este modo proporciona la capacidad de elegir entre la siguiente configuración: 1) Analizar: solo para la detección. Este modo genera un archivo JSON de metadatos que marca las apariencias de las caras a lo largo del vídeo. Siempre que sea posible, a las apariencias de la misma persona se les asigna el mismo identificador. 2) Combinado: además, censura (desenfoca) las caras detectadas. 3) Redact: permite un proceso de dos pasos, lo que permite la censura selectiva de un subconjunto de caras detectadas. Toma el archivo de metadatos de un paso de análisis anterior, junto con el vídeo de origen, y un subconjunto seleccionado por el usuario de los id. que requieren censura.

Name Type Description
Analyze
  • string

El modo Analizar detecta caras y genera un archivo de metadatos con los resultados. Permite editar el archivo de metadatos antes de que las caras se desenfoque con el modo Redact.

Combined
  • string

El modo combinado realiza los pasos Analizar y Censura en un solo paso cuando no se desea editar las caras analizadas.

Redact
  • string

El modo Censura consume el archivo de metadatos del modo Analizar y censura las caras encontradas.

Filters

Describe todas las operaciones de filtrado, como el desenlazado, la rotación, etc., que se van a aplicar a los medios de entrada antes de la codificación.

Name Type Description
crop

Parámetros de la ventana rectangular con la que se va a recortar el vídeo de entrada.

deinterlace

Configuración de desenlazado.

overlays Overlay[]:

Propiedades de las superposiciones que se aplicarán al vídeo de entrada. Pueden ser superposiciones de audio, imagen o vídeo.

rotation

Rotación, si existe, que se va a aplicar al vídeo de entrada, antes de codificarse. El valor predeterminado es Auto

H264Complexity

Indica al codificador cómo elegir su configuración de codificación. El valor predeterminado es Balanced.

Name Type Description
Balanced
  • string

Indica al codificador que use configuraciones que consigan un equilibrio entre velocidad y calidad.

Quality
  • string

Indica al codificador que use configuraciones optimizadas para generar una salida de mayor calidad a costa de un tiempo de codificación general más lento.

Speed
  • string

Indica al codificador que use la configuración optimizada para una codificación más rápida. La calidad se sacrifique para reducir el tiempo de codificación.

H264Layer

Describe la configuración que se va a usar al codificar el vídeo de entrada en una capa de velocidad de bits de salida deseada con el códec de vídeo H.264.

Name Type Description
@odata.type string:
  • #Microsoft.Media.H264Layer

Discriminador para tipos derivados.

adaptiveBFrame
  • boolean

Si se van a usar o no fotogramas B adaptables al codificar esta capa. Si no se especifica, el codificador lo activará cada vez que el perfil de vídeo permita su uso.

bFrames
  • integer

Número de fotogramas B que se usarán al codificar esta capa. Si no se especifica, el codificador elige un número adecuado en función del perfil y el nivel de vídeo.

bitrate
  • integer

Velocidad de bits media en bits por segundo en la que se codifica el vídeo de entrada al generar esta capa. Este campo es obligatorio.

bufferWindow
  • string

Longitud de la ventana del búfer de VBV. El valor debe estar en formato ISO 8601. El valor debe estar en el intervalo [0,1-100] segundos. El valor predeterminado es 5 segundos (por ejemplo, PT5S).

entropyMode

Modo de entropía que se va a usar para esta capa. Si no se especifica, el codificador elige el modo adecuado para el perfil y el nivel.

frameRate
  • string

Velocidad de fotogramas (en fotogramas por segundo) a la que se codifica esta capa. El valor puede tener el formato M/N, donde M y N son enteros (por ejemplo, 30000/1001) o en forma de un número (por ejemplo, 30 o 29,97). El codificador aplica restricciones en las velocidades de fotogramas permitidas en función del perfil y el nivel. Si no se especifica, el codificador usará la misma velocidad de fotogramas que el vídeo de entrada.

height
  • string

Alto del vídeo de salida de esta capa. El valor puede ser absoluto (en píxeles) o relativo (en porcentaje). Por ejemplo, el 50 % significa que el vídeo de salida tiene la mitad de píxeles de alto que la entrada.

label
  • string

Etiqueta alfanumérica para esta capa, que se puede usar para multiplexar diferentes capas de audio y vídeo, o para asignar un nombre al archivo de salida.

level
  • string

Actualmente se admite level hasta 6.2. El valor puede ser Auto o un número que coincida con el perfil H.264. Si no se especifica, el valor predeterminado es Auto, que permite al codificador elegir el nivel adecuado para esta capa.

maxBitrate
  • integer

Velocidad de bits máxima (en bits por segundo), en la que se debe suponer que el búfer de VBV se rellena. Si no se especifica, el valor predeterminado es el mismo valor que la velocidad de bits.

profile

Actualmente se admiten Baseline, Main, High, High422 y High444. El valor predeterminado es Auto.

referenceFrames
  • integer

Número de fotogramas de referencia que se usarán al codificar esta capa. Si no se especifica, el codificador determina un número adecuado en función de la configuración de complejidad del codificador.

slices
  • integer

Número de segmentos que se usarán al codificar esta capa. Si no se especifica, el valor predeterminado es cero, lo que significa que el codificador usará un solo segmento para cada fotograma.

width
  • string

Ancho del vídeo de salida de esta capa. El valor puede ser absoluto (en píxeles) o relativo (en porcentaje). Por ejemplo, el 50 % significa que el vídeo de salida tiene la mitad de píxeles de ancho que la entrada.

H264Video

Describe todas las propiedades para codificar un vídeo con el códec H.264.

Name Type Description
@odata.type string:
  • #Microsoft.Media.H264Video

Discriminador para tipos derivados.

complexity

Indica al codificador cómo elegir su configuración de codificación. El valor predeterminado es Balanced.

keyFrameInterval
  • string

Distancia entre dos fotogramas clave. El valor debe ser distinto de cero en el intervalo [0,5, 20] segundos, especificado en formato ISO 8601. El valor predeterminado es 2 segundos (PT2S). Tenga en cuenta que esta configuración se omite si se establece VideoSyncMode.Passthrough, donde el valor KeyFrameInterval seguirá la configuración de origen de entrada.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de la experiencia de usuario.

layers

Colección de capas H.264 de salida que va a generar el codificador.

sceneChangeDetection
  • boolean

Si el codificador debe insertar o no fotogramas clave en los cambios de la escena. Si no se especifica, el valor predeterminado es false. Esta marca debe establecerse en true solo cuando el codificador se configura para generar un único vídeo de salida.

stretchMode

Modo de cambio de tamaño: cómo se cambia el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize

syncMode

Modo de sincronización de vídeo

H264VideoProfile

Actualmente se admiten Baseline, Main, High, High422 y High444. El valor predeterminado es Auto.

Name Type Description
Auto
  • string

Indica al codificador que determine automáticamente el perfil H.264 adecuado.

Baseline
  • string

Perfil de línea base

High
  • string

Perfil alto.

High422
  • string

Perfil alto de 4:2:2.

High444
  • string

Perfil predictivo alto de 4:4:4.

Main
  • string

Perfil principal

H265Complexity

Indica al codificador cómo elegir su configuración de codificación. La calidad proporcionará una mayor relación de compresión, pero con un costo mayor y un tiempo de proceso más largo. La velocidad producirá un archivo relativamente mayor, pero es más rápido y económico. El valor predeterminado es Balanced.

Name Type Description
Balanced
  • string

Indica al codificador que use configuraciones que consigan un equilibrio entre velocidad y calidad.

Quality
  • string

Indica al codificador que use configuraciones optimizadas para generar una salida de mayor calidad a costa de un tiempo de codificación general más lento.

Speed
  • string

Indica al codificador que use la configuración optimizada para una codificación más rápida. La calidad se sacrifique para reducir el tiempo de codificación.

H265Layer

Describe la configuración que se va a usar al codificar el vídeo de entrada en una capa de velocidad de bits de salida deseada con el códec de vídeo H.265.

Name Type Description
@odata.type string:
  • #Microsoft.Media.H265Layer

Discriminador para tipos derivados.

adaptiveBFrame
  • boolean

Especifica si se usarán o no fotogramas B adaptables al codificar esta capa. Si no se especifica, el codificador lo activará cada vez que el perfil de vídeo permita su uso.

bFrames
  • integer

Número de fotogramas B que se usarán al codificar esta capa. Si no se especifica, el codificador elige un número adecuado en función del perfil y el nivel de vídeo.

bitrate
  • integer

Velocidad de bits media en bits por segundo en la que se codifica el vídeo de entrada al generar esta capa. Por ejemplo: una velocidad de bits de destino de 3000 Kbps o 3Mbps significa que este valor debe ser 300 00000. Este es un campo obligatorio.

bufferWindow
  • string

Longitud de la ventana del búfer de VBV. El valor debe estar en formato ISO 8601. El valor debe estar en el intervalo [0,1-100] segundos. El valor predeterminado es 5 segundos (por ejemplo, PT5S).

frameRate
  • string

Velocidad de fotogramas (en fotogramas por segundo) a la que se codifica esta capa. El valor puede tener el formato M/N, donde M y N son enteros (por ejemplo, 30000/1001) o en forma de un número (por ejemplo, 30 o 29,97). El codificador aplica restricciones en las velocidades de fotogramas permitidas en función del perfil y el nivel. Si no se especifica, el codificador usará la misma velocidad de fotogramas que el vídeo de entrada.

height
  • string

Alto del vídeo de salida de esta capa. El valor puede ser absoluto (en píxeles) o relativo (en porcentaje). Por ejemplo, el 50 % significa que el vídeo de salida tiene la mitad de píxeles de alto que la entrada.

label
  • string

Etiqueta alfanumérica para esta capa, que se puede usar para multiplexar diferentes capas de audio y vídeo, o para asignar un nombre al archivo de salida.

level
  • string

Actualmente se admite level hasta 6.2. El valor puede ser Auto o un número que coincida con el perfil H.265. Si no se especifica, el valor predeterminado es Auto, que permite al codificador elegir el nivel adecuado para esta capa.

maxBitrate
  • integer

Velocidad de bits máxima (en bits por segundo), en la que se debe suponer que el búfer de VBV se rellena. Si no se especifica, el valor predeterminado es el mismo valor que la velocidad de bits.

profile

Actualmente se admite Main. El valor predeterminado es Auto.

referenceFrames
  • integer

Número de fotogramas de referencia que se usarán al codificar esta capa. Si no se especifica, el codificador determina un número adecuado en función de la configuración de complejidad del codificador.

slices
  • integer

Número de segmentos que se usarán al codificar esta capa. Si no se especifica, el valor predeterminado es cero, lo que significa que el codificador usará un solo segmento para cada fotograma.

width
  • string

Ancho del vídeo de salida de esta capa. El valor puede ser absoluto (en píxeles) o relativo (en porcentaje). Por ejemplo, el 50 % significa que el vídeo de salida tiene la mitad de píxeles de ancho que la entrada.

H265Video

Describe todas las propiedades para codificar un vídeo con el códec H.265.

Name Type Description
@odata.type string:
  • #Microsoft.Media.H265Video

Discriminador para tipos derivados.

complexity

Indica al codificador cómo elegir su configuración de codificación. La calidad proporcionará una mayor relación de compresión, pero con un costo mayor y un tiempo de proceso más largo. La velocidad producirá un archivo relativamente mayor, pero es más rápido y económico. El valor predeterminado es Balanced.

keyFrameInterval
  • string

Distancia entre dos fotogramas clave. El valor debe ser distinto de cero en el intervalo [0,5, 20] segundos, especificado en formato ISO 8601. El valor predeterminado es 2 segundos (PT2S). Tenga en cuenta que esta configuración se omite si se establece VideoSyncMode.Passthrough, donde el valor KeyFrameInterval seguirá la configuración de origen de entrada.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de muxing.

layers

Colección de capas H.265 de salida que va a generar el codificador.

sceneChangeDetection
  • boolean

Especifica si el codificador debe insertar o no fotogramas clave en los cambios de la escena. Si no se especifica, el valor predeterminado es false. Esta marca debe establecerse en true solo cuando el codificador se configura para generar un único vídeo de salida.

stretchMode

El modo de cambio de tamaño: cómo se cambia el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize

syncMode

Modo de sincronización de vídeo

H265VideoProfile

Actualmente se admite Main. El valor predeterminado es Auto.

Name Type Description
Auto
  • string

Indica al codificador que determine automáticamente el perfil H.265 adecuado.

Main
  • string

Perfil principal (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier)

Image

Describe las propiedades básicas para generar miniaturas a partir del vídeo de entrada.

Name Type Description
@odata.type string:
  • #Microsoft.Media.Image

Discriminador para tipos derivados.

keyFrameInterval
  • string

Distancia entre dos fotogramas clave. El valor debe ser distinto de cero en el intervalo [0,5, 20] segundos, especificado en formato ISO 8601. El valor predeterminado es 2 segundos (PT2S). Tenga en cuenta que esta configuración se omite si se establece VideoSyncMode.Passthrough, donde el valor KeyFrameInterval seguirá la configuración de origen de entrada.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de muxing.

range
  • string

Posición relativa a la transformación de la hora de inicio preestablecida en el vídeo de entrada en la que se dejan de generar miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT5M30S para detenerse a los 5 minutos y 30 segundos desde el momento de inicio), ser un número de fotogramas (por ejemplo, 300 para detenerse en el fotograma 300 desde el fotograma del momento de inicio. Si este valor es 1, significa que solo se genera una miniatura en el momento de inicio) o ser un valor relativo a la duración de la secuencia (por ejemplo, 50 % para detenerse a la mitad de la duración de la secuencia desde el momento de inicio). El valor predeterminado es 100 %, lo que significa que debe detenerse al final de la secuencia.

start
  • string

Posición en el vídeo de entrada desde donde empezar a generar miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT05S para empezar en 5 segundos), ser un número de fotogramas (por ejemplo, 10 para comenzar en el décimo fotograma) o ser un valor relativo a la duración de la secuencia (por ejemplo, 10 % para empezar en el 10 % de la duración de la secuencia). También admite una macro {Best}, que indica al codificador que seleccione la mejor miniatura en los primeros segundos del vídeo y que solo se producirá una miniatura, independientemente de cuál sea la configuración para step y range. El valor predeterminado es la macro {Best}.

step
  • string

Intervalos en los que se generan miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT05S para una imagen cada 5 segundos), un recuento de fotogramas (por ejemplo, 30 para una imagen cada 30 fotogramas) o un valor relativo a la duración de la secuencia (por ejemplo, un 10 % para una imagen cada 10 % de la duración de la secuencia). Nota: El valor del paso afectará a la primera miniatura generada, que puede no ser exactamente la especificada en la hora de inicio preestablecida de transformación. Esto se debe al codificador, que intenta seleccionar la mejor miniatura entre la hora de inicio y la posición paso a paso desde la hora de inicio como primera salida. Como el valor predeterminado es 10 %, significa que si la secuencia tiene una duración larga, la primera miniatura generada podría estar lejos de la especificada en la hora de inicio. Intente seleccionar un valor razonable para Paso si se espera que la primera miniatura esté cerca de la hora de inicio o establezca el valor de Intervalo en 1 si solo se necesita una miniatura en la hora de inicio.

stretchMode

El modo de cambio de tamaño: cómo se cambia el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize

syncMode

Modo de sincronización de vídeo

ImageFormat

Describe las propiedades de un archivo de imagen de salida.

Name Type Description
@odata.type string:
  • #Microsoft.Media.ImageFormat

Discriminador para tipos derivados.

filenamePattern
  • string

Patrón de los nombres de archivo para los archivos de salida generados. Las macros siguientes se admiten en el nombre de archivo: {Basename}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {Extension}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a las miniaturas. {Velocidad de bits}: velocidad de bits de audio/vídeo. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio y vídeo. {Resolución}: la resolución de vídeo. Las macros no sustituidas se contraerán y quitarán del nombre de archivo.

InsightsType

Define el tipo de información que desea que genere el servicio. Los valores permitidos son "AudioInsightsOnly", "VideoInsightsOnly" y "AllInsights". El valor predeterminado es AllInsights. Si establece esta opción en AllInsights y la entrada es solo audio, solo se genera información de audio. De forma similar, si la entrada es solo de vídeo, solo se genera información de vídeo. Se recomienda no usar AudioInsightsOnly si espera que algunas de las entradas sean solo de vídeo. o use VideoInsightsOnly si espera que algunas de las entradas sean solo audio. Los trabajos en estas condiciones generarían un error.

Name Type Description
AllInsights
  • string

Genere información de audio y vídeo. Se produce un error si se produce un error Ideas de audio o vídeo.

AudioInsightsOnly
  • string

Generar solo información de audio. Omitir vídeo incluso si está presente. Se produce un error si no hay audio presente.

VideoInsightsOnly
  • string

Generar solo información de vídeo. Omitir audio si está presente. Se produce un error si no hay ningún vídeo.

JpgFormat

Describe la configuración para generar miniaturas JPEG.

Name Type Description
@odata.type string:
  • #Microsoft.Media.JpgFormat

Discriminador para tipos derivados.

filenamePattern
  • string

Patrón de los nombres de archivo para los archivos de salida generados. Las macros siguientes se admiten en el nombre de archivo: {Basename}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {Extension}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a las miniaturas. {Velocidad de bits}: velocidad de bits de audio/vídeo. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio y vídeo. {Resolución}: la resolución de vídeo. Las macros no sustituidas se contraerán y quitarán del nombre de archivo.

JpgImage

Describe las propiedades para generar una serie de imágenes JPEG a partir del vídeo de entrada.

Name Type Description
@odata.type string:
  • #Microsoft.Media.JpgImage

Discriminador para tipos derivados.

keyFrameInterval
  • string

Distancia entre dos fotogramas clave. El valor debe ser distinto de cero en el intervalo [0,5, 20] segundos, especificado en formato ISO 8601. El valor predeterminado es 2 segundos (PT2S). Tenga en cuenta que esta configuración se omite si se establece VideoSyncMode.Passthrough, donde el valor KeyFrameInterval seguirá la configuración de origen de entrada.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de la experiencia de usuario.

layers

Colección de capas de imagen JPEG de salida que va a generar el codificador.

range
  • string

Posición relativa a la hora de inicio del valor preestablecido de transformación en el vídeo de entrada en el que se deja de generar miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT5M30S para detenerse a los 5 minutos y 30 segundos desde el momento de inicio), ser un número de fotogramas (por ejemplo, 300 para detenerse en el fotograma 300 desde el fotograma del momento de inicio. Si este valor es 1, significa que solo se genera una miniatura en el momento de inicio) o ser un valor relativo a la duración de la secuencia (por ejemplo, 50 % para detenerse a la mitad de la duración de la secuencia desde el momento de inicio). El valor predeterminado es 100 %, lo que significa que debe detenerse al final de la secuencia.

spriteColumn
  • integer

Establece el número de columnas usadas en la imagen de sprite en miniatura. El número de filas se calcula automáticamente y se genera un archivo VTT con las asignaciones de coordenadas para cada miniatura del sprite. Nota: Este valor debe ser un entero positivo y se recomienda un valor adecuado para que la resolución de la imagen de salida no supere el límite máximo de resolución de píxeles jpeg 65535x65535.

start
  • string

Posición en el vídeo de entrada desde donde empezar a generar miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT05S para empezar en 5 segundos), ser un número de fotogramas (por ejemplo, 10 para comenzar en el décimo fotograma) o ser un valor relativo a la duración de la secuencia (por ejemplo, 10 % para empezar en el 10 % de la duración de la secuencia). También admite una macro {Best}, que indica al codificador que seleccione la mejor miniatura en los primeros segundos del vídeo y que solo se producirá una miniatura, independientemente de cuál sea la configuración para step y range. El valor predeterminado es la macro {Best}.

step
  • string

Intervalos en los que se generan miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT05S para una imagen cada 5 segundos), un número de fotogramas (por ejemplo, 30 para una imagen cada 30 fotogramas) o un valor relativo para la duración de la secuencia (por ejemplo, un 10 % para una imagen cada 10 % de la duración del flujo). Nota: El valor del paso afectará a la primera miniatura generada, que puede no ser exactamente la especificada en la hora de inicio del valor preestablecido de transformación. Esto se debe al codificador, que intenta seleccionar la mejor miniatura entre la hora de inicio y la posición paso a paso desde la hora de inicio como primera salida. Como el valor predeterminado es 10 %, significa que si la secuencia tiene una duración larga, la primera miniatura generada podría estar lejos de la especificada en la hora de inicio. Intente seleccionar un valor razonable para Paso si se espera que la primera miniatura esté cerca de la hora de inicio o establezca Valor de intervalo en 1 si solo se necesita una miniatura en la hora de inicio.

stretchMode

Modo de cambio de tamaño: cómo se cambia el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize

syncMode

Modo de sincronización de vídeo

JpgLayer

Describe la configuración para generar una imagen JPEG a partir del vídeo de entrada.

Name Type Description
@odata.type string:
  • #Microsoft.Media.JpgLayer

Discriminador para tipos derivados.

height
  • string

Alto del vídeo de salida de esta capa. El valor puede ser absoluto (en píxeles) o relativo (en porcentaje). Por ejemplo, el 50 % significa que el vídeo de salida tiene la mitad de píxeles de alto que la entrada.

label
  • string

Etiqueta alfanumérica para esta capa, que se puede usar para multiplexar diferentes capas de audio y vídeo, o para asignar un nombre al archivo de salida.

quality
  • integer

La calidad de compresión de la salida JPEG. El intervalo es de 0 a 100 y el valor predeterminado es 70.

width
  • string

Ancho del vídeo de salida de esta capa. El valor puede ser absoluto (en píxeles) o relativo (en porcentaje). Por ejemplo, el 50 % significa que el vídeo de salida tiene la mitad de píxeles de ancho que la entrada.

Mp4Format

Describe las propiedades de un archivo MP4 ISO de salida.

Name Type Description
@odata.type string:
  • #Microsoft.Media.Mp4Format

Discriminador para tipos derivados.

filenamePattern
  • string

Patrón de los nombres de archivo para los archivos de salida generados. Las macros siguientes se admiten en el nombre de archivo: {Basename}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {Extension}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a las miniaturas. {Velocidad de bits}: velocidad de bits de audio/vídeo. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio y vídeo. {Resolución}: la resolución de vídeo. Las macros no sustituidas se contraerán y quitarán del nombre de archivo.

outputFiles

Lista de archivos de salida que se va a generar. Cada entrada de la lista es un conjunto de etiquetas de capa de audio y vídeo que se pueden muxed juntas.

MultiBitrateFormat

Describe las propiedades para generar una colección de archivos de velocidad de bits múltiple alineados con GOP. El comportamiento predeterminado es generar un archivo de salida para cada capa de vídeo que se muxed junto con todos los audios. Los archivos de salida exactos generados se pueden controlar especificando la colección outputFiles.

Name Type Description
@odata.type string:
  • #Microsoft.Media.MultiBitrateFormat

Discriminador para tipos derivados.

filenamePattern
  • string

Patrón de los nombres de archivo para los archivos de salida generados. Las macros siguientes se admiten en el nombre de archivo: {Basename}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {Extension}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a las miniaturas. {Velocidad de bits}: velocidad de bits de audio/vídeo. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio y vídeo. {Resolución}: la resolución de vídeo. Las macros no sustituidas se contraerán y quitarán del nombre de archivo.

outputFiles

Lista de archivos de salida que se va a generar. Cada entrada de la lista es un conjunto de etiquetas de capa de audio y vídeo que se pueden muxed juntas.

ODataError

Información sobre un error.

Name Type Description
code
  • string

Nombre de error independiente del idioma.

details

Los detalles del error.

message
  • string

El mensaje de error.

target
  • string

Destino del error (por ejemplo, el nombre de la propiedad en error).

OnErrorType

Una transformación puede definir más de una salida. Esta propiedad define lo que debe hacer el servicio cuando se produce un error en una salida: continuar generando otras salidas o detener las demás salidas. El estado general del trabajo no reflejará los errores de las salidas que se especifican con "ContinueJob". El valor predeterminado es "StopProcessingJob".

Name Type Description
ContinueJob
  • string

Indica al servicio que, si se produce un error en este objeto TransformOutput, permita que continúe cualquier otro objeto TransformOutput.

StopProcessingJob
  • string

Indica al servicio que, si se produce un error en este objeto TransformOutput, se puede detener cualquier otro objeto TransformOutputs incompleto.

OutputFile

Representa un archivo de salida generado.

Name Type Description
labels
  • string[]

Lista de etiquetas que describen cómo el codificador debe multiplexr vídeo y audio en un archivo de salida. Por ejemplo, si el codificador genera dos capas de vídeo con las etiquetas v1 y v2, y una capa de audio con la etiqueta a1, una matriz como "[v1, a1]" indica al codificador que produzca un archivo de salida con la pista de vídeo representada por v1 y la pista de audio representada por a1.

PngFormat

Describe la configuración para generar miniaturas PNG.

Name Type Description
@odata.type string:
  • #Microsoft.Media.PngFormat

Discriminador para tipos derivados.

filenamePattern
  • string

Patrón de los nombres de archivo para los archivos de salida generados. Las macros siguientes se admiten en el nombre de archivo: {Basename}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {Extension}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a las miniaturas. {Velocidad de bits}: velocidad de bits de audio/vídeo. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio y vídeo. {Resolución}: la resolución de vídeo. Las macros no sustituidas se contraerán y quitarán del nombre de archivo.

PngImage

Describe las propiedades para generar una serie de imágenes PNG a partir del vídeo de entrada.

Name Type Description
@odata.type string:
  • #Microsoft.Media.PngImage

Discriminador para tipos derivados.

keyFrameInterval
  • string

Distancia entre dos fotogramas clave. El valor debe ser distinto de cero en el intervalo [0,5, 20] segundos, especificado en formato ISO 8601. El valor predeterminado es 2 segundos (PT2S). Tenga en cuenta que esta configuración se omite si se establece VideoSyncMode.Passthrough, donde el valor KeyFrameInterval seguirá la configuración de origen de entrada.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de la experiencia de usuario.

layers

Colección de capas de imagen PNG de salida que va a generar el codificador.

range
  • string

Posición relativa a la hora de inicio del valor preestablecido de transformación en el vídeo de entrada en el que se deja de generar miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT5M30S para detenerse a los 5 minutos y 30 segundos desde el momento de inicio), ser un número de fotogramas (por ejemplo, 300 para detenerse en el fotograma 300 desde el fotograma del momento de inicio. Si este valor es 1, significa que solo se genera una miniatura en el momento de inicio) o ser un valor relativo a la duración de la secuencia (por ejemplo, 50 % para detenerse a la mitad de la duración de la secuencia desde el momento de inicio). El valor predeterminado es 100 %, lo que significa que debe detenerse al final de la secuencia.

start
  • string

Posición en el vídeo de entrada desde donde empezar a generar miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT05S para empezar en 5 segundos), ser un número de fotogramas (por ejemplo, 10 para comenzar en el décimo fotograma) o ser un valor relativo a la duración de la secuencia (por ejemplo, 10 % para empezar en el 10 % de la duración de la secuencia). También admite una macro {Best}, que indica al codificador que seleccione la mejor miniatura en los primeros segundos del vídeo y que solo se producirá una miniatura, independientemente de cuál sea la configuración para step y range. El valor predeterminado es la macro {Best}.

step
  • string

Intervalos en los que se generan miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT05S para una imagen cada 5 segundos), un número de fotogramas (por ejemplo, 30 para una imagen cada 30 fotogramas) o un valor relativo para la duración de la secuencia (por ejemplo, un 10 % para una imagen cada 10 % de la duración del flujo). Nota: El valor del paso afectará a la primera miniatura generada, que puede no ser exactamente la especificada en la hora de inicio del valor preestablecido de transformación. Esto se debe al codificador, que intenta seleccionar la mejor miniatura entre la hora de inicio y la posición paso a paso desde la hora de inicio como primera salida. Como el valor predeterminado es 10 %, significa que si la secuencia tiene una duración larga, la primera miniatura generada podría estar lejos de la especificada en la hora de inicio. Intente seleccionar un valor razonable para Paso si se espera que la primera miniatura esté cerca de la hora de inicio o establezca Valor de intervalo en 1 si solo se necesita una miniatura en la hora de inicio.

stretchMode

Modo de cambio de tamaño: cómo se cambia el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize

syncMode

Modo de sincronización de vídeo

PngLayer

Describe la configuración para generar una imagen PNG a partir del vídeo de entrada.

Name Type Description
@odata.type string:
  • #Microsoft.Media.PngLayer

Discriminador para tipos derivados.

height
  • string

Alto del vídeo de salida de esta capa. El valor puede ser absoluto (en píxeles) o relativo (en porcentaje). Por ejemplo, el 50 % significa que el vídeo de salida tiene la mitad de píxeles de alto que la entrada.

label
  • string

Etiqueta alfanumérica para esta capa, que se puede usar para multiplexar diferentes capas de audio y vídeo, o para asignar un nombre al archivo de salida.

width
  • string

Ancho del vídeo de salida de esta capa. El valor puede ser absoluto (en píxeles) o relativo (en porcentaje). Por ejemplo, el 50 % significa que el vídeo de salida tiene la mitad de píxeles de ancho que la entrada.

Priority

Establece la prioridad relativa de TransformOutputs dentro de una transformación. Esto establece la prioridad que el servicio usa para procesar TransformOutputs. La prioridad predeterminada es Normal.

Name Type Description
High
  • string

Se usa para transformOutputs que deben tener prioridad sobre otros.

Low
  • string

Se usa para TransformOutputs que se pueden generar después de TransformOutputs de prioridad normal y alta.

Normal
  • string

Se usa para TransformOutputs que se pueden generar con prioridad normal.

Rectangle

Describe las propiedades de una ventana rectangular aplicada al medio de entrada antes de procesarla.

Name Type Description
height
  • string

Alto de la región rectangular en píxeles. Puede ser un valor de píxel absoluto (por ejemplo, 100) o relativo al tamaño del vídeo (por ejemplo, un 50 %).

left
  • string

Número de píxeles del margen izquierdo. Puede ser un valor de píxel absoluto (por ejemplo, 100) o relativo al tamaño del vídeo (por ejemplo, un 50 %).

top
  • string

Número de píxeles del margen superior. Puede ser un valor de píxel absoluto (por ejemplo, 100) o relativo al tamaño del vídeo (por ejemplo, un 50 %).

width
  • string

Ancho de la región rectangular en píxeles. Puede ser un valor de píxel absoluto (por ejemplo, 100) o relativo al tamaño del vídeo (por ejemplo, un 50 %).

Rotation

Rotación, si existe, que se va a aplicar al vídeo de entrada, antes de codificarse. El valor predeterminado es Auto

Name Type Description
Auto
  • string

Detectar y girar automáticamente según sea necesario.

None
  • string

No rote el vídeo. Si el formato de salida lo admite, los metadatos sobre la rotación se mantienen intactos.

Rotate0
  • string

No rote el vídeo, pero quite los metadatos sobre la rotación.

Rotate180
  • string

Girar 180° grados en el sentido de las agujas del reloj.

Rotate270
  • string

Girar 270° grados en el sentido de las agujas del reloj.

Rotate90
  • string

Girar 90° grados en el sentido de las agujas del reloj.

StandardEncoderPreset

Describe toda la configuración que se va a usar al codificar el vídeo de entrada con el codificador estándar.

Name Type Description
@odata.type string:
  • #Microsoft.Media.StandardEncoderPreset

Discriminador para tipos derivados.

codecs Codec[]:

Lista de códecs que se usarán al codificar el vídeo de entrada.

filters

Una o varias operaciones de filtrado que se aplican a los medios de entrada antes de la codificación.

formats Format[]:

Lista de salidas que va a generar el codificador.

StretchMode

El modo de cambio de tamaño: cómo se cambia el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize

Name Type Description
AutoFit
  • string

Panele la salida (con el cuadro de texto o el cuadro de columnas) para respetar la resolución de salida, al tiempo que garantiza que la región de vídeo activa de la salida tenga la misma relación de aspecto que la entrada. Por ejemplo, si la entrada es 1920x1080 y el valor preestablecido de codificación pide 1280 x 1280, la salida será de 1280 x 1280, que contiene un rectángulo interno de 1280 x 720 con una relación de aspecto de 16:9, y regiones de cuadro de columnas de 280 píxeles de ancho a la izquierda y derecha.

AutoSize
  • string

Invalide la resolución de salida y cámbiela para que coincida con la relación de aspecto de presentación de la entrada, sin relleno. Por ejemplo, si la entrada es 1920x1080 y el valor preestablecido de codificación requiere 1280x1280, se invalida el valor en el valor preestablecido y la salida será de 1280x720, que mantiene la relación de aspecto de entrada de 16:9.

None
  • string

Respete estrictamente la resolución de salida sin tener en cuenta la relación de aspecto de píxeles o la relación de aspecto de pantalla del vídeo de entrada.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Name Type Description
createdAt
  • string

Marca de tiempo de creación de recursos (UTC).

createdBy
  • string

Identidad que creó el recurso.

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt
  • string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy
  • string

Identidad que modificó por última vez el recurso.

lastModifiedByType

Tipo de identidad que modificó por última vez el recurso.

Transform

Una transformación encapsula las reglas o instrucciones para generar salidas deseadas a partir de medios de entrada, como transcodificación o extracción de información. Una vez creada la transformación, se puede aplicar a los medios de entrada mediante la creación de trabajos.

Name Type Description
id
  • string

Identificador de recurso completo del recurso. Por ejemplo, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Nombre del recurso.

properties.created
  • string

La fecha y hora UTC cuando se creó la transformación, en formato "AAAA-MM-DDThh:mm:ssZ".

properties.description
  • string

Una descripción detallada opcional de la transformación.

properties.lastModified
  • string

La fecha y hora UTC cuando se actualizó la transformación por última vez, en formato "AAAA-MM-DDThh:mm:ssZ".

properties.outputs

Una matriz de uno o más elementos TransformOutputs que debe generar la transformación.

systemData

Metadatos del sistema relacionados con este recurso.

type
  • string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft. Storage/storageAccounts"

TransformOutput

Describe las propiedades de un objeto TransformOutput, que son las reglas que se aplicarán al generar la salida deseada.

Name Type Description
onError

Una transformación puede definir más de una salida. Esta propiedad define lo que debe hacer el servicio cuando se produce un error en una salida: continuar generando otras salidas o detener las demás salidas. El estado general del trabajo no reflejará los errores de las salidas que se especifican con "ContinueJob". El valor predeterminado es "StopProcessingJob".

preset Preset:

Valor preestablecido que describe las operaciones que se usarán para modificar, transcodificar o extraer información del archivo de origen para generar la salida.

relativePriority

Establece la prioridad relativa de TransformOutputs dentro de una transformación. Esto establece la prioridad que el servicio usa para procesar TransformOutputs. La prioridad predeterminada es Normal.

TransportStreamFormat

Describe las propiedades para generar archivos de vídeo de salida mpeg-2 transport stream (ISO/IEC 13818-1).

Name Type Description
@odata.type string:
  • #Microsoft.Media.TransportStreamFormat

Discriminador para tipos derivados.

filenamePattern
  • string

Patrón de los nombres de archivo para los archivos de salida generados. Las macros siguientes se admiten en el nombre de archivo: {Basename}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {Extension}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a las miniaturas. {Velocidad de bits}: velocidad de bits de audio/vídeo. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio y vídeo. {Resolución}: la resolución de vídeo. Las macros no sustituidas se contraerán y quitarán del nombre de archivo.

outputFiles

Lista de archivos de salida que se va a generar. Cada entrada de la lista es un conjunto de etiquetas de capa de audio y vídeo que se pueden muxed juntas.

Video

Describe las propiedades básicas para codificar el vídeo de entrada.

Name Type Description
@odata.type string:
  • #Microsoft.Media.Video

Discriminador para tipos derivados.

keyFrameInterval
  • string

Distancia entre dos fotogramas clave. El valor debe ser distinto de cero en el intervalo [0,5, 20] segundos, especificado en formato ISO 8601. El valor predeterminado es 2 segundos (PT2S). Tenga en cuenta que esta configuración se omite si se establece VideoSyncMode.Passthrough, donde el valor KeyFrameInterval seguirá la configuración de origen de entrada.

label
  • string

Una etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de muxing.

stretchMode

El modo de cambio de tamaño: cómo se cambia el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize

syncMode

Modo de sincronización de vídeo

VideoAnalyzerPreset

Un valor preestablecido del analizador de vídeo que extrae información (metadatos enriquecidos) de audio y vídeo, y genera un archivo de formato JSON.

Name Type Description
@odata.type string:
  • #Microsoft.Media.VideoAnalyzerPreset

Discriminador para tipos derivados.

audioLanguage
  • string

Idioma de la carga de audio en la entrada con el formato BCP-47 de "language tag-region" (por ejemplo, "en-US"). Si conoce el idioma del contenido, se recomienda especificarlo. El idioma debe especificarse explícitamente para AudioAnalysisMode::Basic, ya que la detección automática de idioma no se incluye en el modo básico. Si el idioma no se especifica o se establece en null, la detección automática de idioma elegirá el primer idioma detectado y realizará el procesamiento con el idioma seleccionado lo que dure el archivo. Por ahora no se admite el cambio dinámico entre idiomas una vez detectado el primer idioma. La detección automática funciona mejor con grabaciones de audio con voz claramente reconocible. Si la detección automática no encuentra el idioma, la transcripción se reservaría a "en-US"." La lista de idiomas admitidos está disponible aquí: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions
  • object

Diccionario que contiene pares clave-valor para parámetros no expuestos en el propio valor preestablecido

insightsToExtract

Define el tipo de información que desea que genere el servicio. Los valores permitidos son "AudioInsightsOnly", "VideoInsightsOnly" y "AllInsights". El valor predeterminado es AllInsights. Si establece esta opción en AllInsights y la entrada es solo audio, solo se genera información de audio. De forma similar, si la entrada es solo de vídeo, solo se genera información de vídeo. Se recomienda no usar AudioInsightsOnly si espera que algunas de las entradas sean solo de vídeo. o use VideoInsightsOnly si espera que algunas de las entradas sean solo audio. Los trabajos en estas condiciones generarían un error.

mode

Determina el conjunto de operaciones de análisis de audio que se realizarán. Si no se especifica, se elegiría Standard AudioAnalysisMode.

VideoOverlay

Describe las propiedades de una superposición de vídeo.

Name Type Description
@odata.type string:
  • #Microsoft.Media.VideoOverlay

Discriminador para tipos derivados.

audioGainLevel
  • number

Nivel de ganancia de audio en la superposición. El valor debe estar en el intervalo [0, 1,0]. El valor predeterminado es 1.0.

cropRectangle

Ventana rectangular opcional que se usa para recortar la imagen superpuesta o el vídeo.

end
  • string

Posición final, con referencia al vídeo de entrada, donde finaliza la superposición. El valor debe estar en formato ISO 8601. Por ejemplo, PT30S para finalizar la superposición en 30 segundos en el vídeo de entrada. Si no se especifica o el valor es mayor que la duración del vídeo de entrada, la superposición se aplicará hasta el final del vídeo de entrada si la duración del medio de superposición es mayor que la duración del vídeo de entrada; de lo contrario, la superposición se mantendrá siempre que se superponga la duración del medio.

fadeInDuration
  • string

Duración durante la que la superposición se atenua en el vídeo de entrada. El valor debe estar en formato de duración ISO 8601. Si no se especifica, el comportamiento predeterminado es no atenuar (igual que PT0S).

fadeOutDuration
  • string

La duración durante la que la superposición desaparece del vídeo de entrada. El valor debe estar en formato de duración ISO 8601. Si no se especifica, el comportamiento predeterminado es no atenuarse (igual que PT0S).

inputLabel
  • string

Etiqueta de la entrada del trabajo que se va a usar como superposición. La entrada debe especificar exactamente un archivo. Puede especificar un archivo de imagen en formato JPG, PNG, GIF o BMP, un archivo de audio (por ejemplo, un archivo WAV, MP3, WMA o M4A) o un archivo de vídeo. Consulte https://aka.ms/mesformats para obtener la lista completa de los formatos de archivo de audio y vídeo admitidos.

opacity
  • number

Opacidad de la superposición. Se trata de un valor en el intervalo [0 - 1,0]. El valor predeterminado es 1.0, lo que significa que la superposición es opaca.

position

Ubicación en el vídeo de entrada donde se aplica la superposición.

start
  • string

Posición inicial, con referencia al vídeo de entrada, donde se inicia la superposición. El valor debe estar en formato ISO 8601. Por ejemplo, PT05S para iniciar la superposición en 5 segundos en el vídeo de entrada. Si no se especifica, la superposición comienza desde el principio del vídeo de entrada.

VideoSyncMode

Modo de sincronización de vídeo

Name Type Description
Auto
  • string

Este es el método predeterminado. Elige entre Cfr y Vfr en función de las funcionalidades de muxer. Para el formato de salida MP4, el modo predeterminado es Cfr.

Cfr
  • string

Los fotogramas de entrada se repetirán o se eliminarán según sea necesario para lograr exactamente la velocidad de fotogramas constante solicitada. Se recomienda cuando la velocidad de fotogramas de salida se establece explícitamente en un valor especificado.

Passthrough
  • string

Las marcas de tiempo de presentación de los fotogramas se pasan desde el archivo de entrada al escritor de archivos de salida. Se recomienda cuando el origen de entrada tiene velocidad de fotogramas variable y está intentando generar varias capas para el streaming adaptable en la salida que tienen límites goP alineados. Nota: si dos o más fotogramas de la entrada tienen marcas de tiempo duplicadas, la salida también tendrá el mismo comportamiento.

Vfr
  • string

De forma similar al modo de acceso directo, pero si la entrada tiene fotogramas que tienen marcas de tiempo duplicadas, solo se pasa un fotograma a la salida y se descartan otros. Se recomienda cuando se espera que el número de fotogramas de salida sea igual al número de fotogramas de entrada. Por ejemplo, la salida se usa para calcular una métrica de calidad como PSNR con respecto a la entrada.