Jobs - Get
Obtener trabajo
Obtiene un trabajo.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}/jobs/{jobName}?api-version=2022-07-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta de Media Services. |
job
|
path | True |
string |
Nombre del trabajo. |
resource
|
path | True |
string |
Nombre del grupo de recursos dentro de la suscripción de Azure. |
subscription
|
path | True |
string |
Identificador único de una suscripción de Microsoft Azure. |
transform
|
path | True |
string |
Nombre de transformación. |
api-version
|
query | True |
string |
Versión de la API que se va a usar con la solicitud de cliente. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
Other Status Codes |
Información detallada del error. |
Ejemplos
Get a Job by name
Solicitud de ejemplo
Respuesta de muestra
{
"name": "job1",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/exampleTransform/jobs/job1",
"type": "Microsoft.Media/mediaservices/transforms/jobs",
"properties": {
"created": "2021-06-01T00:00:00Z",
"state": "Queued",
"input": {
"@odata.type": "#Microsoft.Media.JobInputs",
"inputs": [
{
"@odata.type": "#Microsoft.Media.JobInputAsset",
"files": [],
"inputDefinitions": [],
"assetName": "job1-InputAsset"
}
]
},
"lastModified": "2021-06-01T00:00:00Z",
"outputs": [
{
"@odata.type": "#Microsoft.Media.JobOutputAsset",
"state": "Queued",
"progress": 0,
"label": "example-custom-label",
"assetName": "job1-OutputAsset"
}
],
"priority": "Low",
"correlationData": {}
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2021-06-01T00:00:00Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2021-06-01T00:00:00Z"
}
}
Definiciones
Nombre | Description |
---|---|
Aac |
Describe la configuración avanzada de codificación de audio de códec de audio (AAC). |
Aac |
Perfil de codificación que se va a usar al codificar audio con AAC. |
Absolute |
Especifica el tiempo de recorte como una posición de tiempo absoluta en el archivo multimedia. El tiempo absoluto puede apuntar a una posición diferente en función de si el archivo multimedia se inicia desde una marca de tiempo de cero o no. |
Analysis |
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" cambiará el tamaño de los vídeos de entrada a la definición estándar, a la vez que conserva la relación de aspecto adecuada. Solo cambiará el tamaño si el vídeo es de mayor resolución. Por ejemplo, una entrada de 1920x1080 se escalaría a 640x360 antes del procesamiento. Cambiar a "StandardDefinition" reducirá el tiempo necesario para 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 obtener más información). Sin embargo, es posible que no se detecten caras que terminen siendo demasiado pequeñas en el vídeo cambiado. |
Attribute |
Tipo de AttributeFilter que se va a aplicar a TrackAttribute para seleccionar las pistas. |
Audio |
Define las propiedades comunes para todos los códecs de audio. |
Audio |
Determina el conjunto de operaciones de análisis de audio que se van a realizar. Si no se especifica, se elegiría El estándar AudioAnalysisMode. |
Audio |
El valor preestablecido de Audio Analyzer aplica un conjunto predefinido de operaciones de análisis basadas en IA, incluida la transcripción de voz. Actualmente, el valor predeterminado admite el procesamiento de contenido con una sola pista de audio. |
Audio |
Describe las propiedades de una superposición de audio. |
Audio |
TrackSelection para seleccionar pistas de audio. |
Blur |
Tipo de desenfoque |
Built |
Describe un valor preestablecido integrado para codificar el vídeo de entrada con el codificador estándar. |
Channel |
Designación opcional para pistas de audio de canal único. Se puede usar para combinar las pistas en pistas de audio estéreo o multicanal. |
Complexity |
Permite configurar los valores del codificador para controlar el equilibrio entre velocidad y calidad. Ejemplo: establezca Complejidad como Velocidad para una codificación más rápida, pero menos eficiencia de compresión. |
Copy |
Marca de códec, que indica al codificador que copie la secuencia de bits de audio de entrada. |
Copy |
Marca de códec, que indica al codificador que copie la secuencia de bits de vídeo de entrada sin volver a codificar. |
created |
Tipo de identidad que creó el recurso. |
DDAudio |
Describe la configuración de codificación de audio Dolby Digital Audio Codec (AC3). La implementación actual para la compatibilidad con Dolby Digital Audio son: Números de canal de audio en 1(mono), 2(estéreo), 6(5.1side); Frecuencia de muestreo de audio a: 32K/44,1K/48K Hz; Los valores de velocidad de bits de audio como especificación AC3 admiten: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps. |
Deinterlace |
Describe la configuración de desconlazamiento. |
Deinterlace |
Modo de desinterlazado. El valor predeterminado es AutoPixelAdaptive. |
Deinterlace |
La paridad de campos para la desenlazamiento, el valor predeterminado es Auto. |
Encoder |
Valor preestablecido integrado que se va a usar para codificar vídeos. |
Entropy |
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. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Face |
Describe toda la configuración que se va a usar al analizar un vídeo para detectar (y, opcionalmente, censurar) todas las caras presentes. |
Face |
Este modo proporciona la capacidad de elegir entre las siguientes opciones: 1) Analizar: solo para la detección. Este modo genera un archivo JSON de metadatos que marca las apariencias de las caras en todo el vídeo. Siempre que sea posible, a las apariencias de la misma persona se les asigna el mismo identificador. 2) Combinado: además redactes (desenfoque) caras detectadas. 3) Redact: esto permite un proceso de 2 pasos, lo que permite la reacción 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 identificadores que requieren redacción. |
Fade |
Describe las propiedades de un efecto Fade aplicado al medio de entrada. |
Filters |
Describe todas las operaciones de filtrado, como desacoplación, rotación, etc. que se van a aplicar a los medios de entrada antes de la codificación. |
From |
InputDefinition que busca en todos los archivos proporcionados para seleccionar las pistas especificadas por la propiedad IncludedTracks. Por lo general, se usa con AudioTrackByAttribute y VideoTrackByAttribute para permitir la selección de una sola pista en un conjunto de archivos de entrada. |
From |
InputDefinition que examina cada archivo de entrada proporcionado para seleccionar las pistas especificadas por la propiedad IncludedTracks. Por lo general, se usa con AudioTrackByAttribute y VideoTrackByAttribute para seleccionar pistas de cada archivo especificado. |
H264Complexity |
Indica al codificador cómo elegir su configuración de codificación. El valor predeterminado es Equilibrado. |
H264Layer |
Describe la configuración que se 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. |
H264Rate |
Modo de control de velocidad de vídeo |
H264Video |
Describe todas las propiedades para codificar un vídeo con el códec H.264. |
H264Video |
Actualmente se admite la línea base, Main, High, High422, High444. El valor predeterminado es Automático. |
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 más alto 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 Equilibrado. |
H265Layer |
Describe la configuración que se 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. |
H265Video |
Actualmente se admite Main. El valor predeterminado es Automático. |
Image |
Describe las propiedades básicas para generar miniaturas a partir del vídeo de entrada. |
Image |
Describe las propiedades de un archivo de imagen de salida. |
Input |
InputDefinition para un único archivo. TrackSelections se limita al archivo especificado. |
Insights |
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 esto en AllInsights y la entrada es solo audio, solo se generan conclusiones de audio. Del mismo modo, si la entrada es solo vídeo, solo se generan conclusiones de vídeo. Se recomienda no usar AudioInsightsOnly si espera que algunas de sus entradas sean solo vídeos; o use VideoInsightsOnly si espera que algunas de sus entradas sean solo audio. Los trabajos en estas condiciones generarían errores. |
Interleave |
Establece el modo de intercalación de la salida para controlar cómo se almacenan el audio y el vídeo en el formato de contenedor. Ejemplo: establezca InterleavedOutput como NonInterleavedOutput para generar salidas de solo audio y solo vídeo en archivos MP4 independientes. |
Job |
Tipo de recurso Job. El progreso y el estado se pueden obtener mediante el sondeo de un trabajo o la suscripción a eventos mediante EventGrid. |
Job |
Detalles de los errores de JobOutput. |
Job |
Ayuda con la categorización de errores. |
Job |
Código de error que describe el error. |
Job |
Detalles de los errores de JobOutput. |
Job |
Representa un recurso para la entrada en un trabajo. |
Job |
Representa los archivos de entrada de un trabajo. |
Job |
Representa la entrada del trabajo HTTPS. |
Job |
Describe una lista de entradas para un trabajo. |
Job |
Una secuencia contiene una lista ordenada de clips donde cada clip es jobInput. La secuencia se tratará como una sola entrada. |
Job |
Representa un recurso usado como JobOutput. |
Job |
Indica que puede volver a intentar el trabajo. Si el reintento no se realiza correctamente, póngase en contacto con Soporte técnico de Azure a través de Azure Portal. |
Job |
Describe el estado de JobOutput. |
Jpg |
Describe la configuración para generar miniaturas JPEG. |
Jpg |
Describe las propiedades para generar una serie de imágenes JPEG a partir del vídeo de entrada. |
Jpg |
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. |
Multi |
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 muxa junto con todos los audios. Los archivos de salida exactos generados se pueden controlar especificando la colección outputFiles. |
Output |
Representa un archivo de salida generado. |
Png |
Describe la configuración para generar miniaturas PNG. |
Png |
Describe las propiedades para generar una serie de imágenes PNG a partir del vídeo de entrada. |
Png |
Describe la configuración para generar una imagen PNG a partir del vídeo de entrada. |
Preset |
Objeto de opciones de configuración opcionales para el codificador. |
Priority |
Establece la prioridad relativa de transformOutputs dentro de una transformación. Esto establece la prioridad que usa el servicio 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 codificarla. El valor predeterminado es Automático |
Select |
Seleccione las pistas de audio de la entrada especificando un atributo y un filtro de atributo. |
Select |
Seleccione las pistas de audio de la entrada especificando un identificador de pista. |
Select |
Seleccione pistas de vídeo de la entrada especificando un atributo y un filtro de atributo. |
Select |
Seleccione pistas de vídeo de la entrada especificando un identificador de pista. |
Standard |
Describe toda la configuración que se va a usar al codificar el vídeo de entrada con el codificador estándar. |
Stretch |
Modo de cambio de tamaño: cómo se cambiará el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
Track |
TrackAttribute para filtrar las pistas por. |
Transport |
Describe las propiedades para generar archivos de vídeo de salida mpeg-2 (ISO/IEC 13818-1). |
Utc |
Especifica la hora del clip como una posición de hora Utc en el archivo multimedia. La hora Utc puede apuntar a una posición diferente en función de si el archivo multimedia se inicia desde una marca de tiempo de cero o no. |
Video |
Describe las propiedades básicas para codificar el vídeo de entrada. |
Video |
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. |
Video |
Describe las propiedades de una superposición de vídeo. |
Video |
Modo de sincronización de vídeo |
Video |
TrackSelection para seleccionar pistas de vídeo. |
AacAudio
Describe la configuración avanzada de codificación de audio de códec de audio (AAC).
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
bitrate |
integer |
Velocidad de bits, en bits por segundo, del audio codificado de salida. |
channels |
integer |
Número de canales en el audio. |
label |
string |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
profile |
Perfil de codificación que se va a usar al codificar audio con AAC. |
|
samplingRate |
integer |
Frecuencia de muestreo que se va a usar para la codificación en hercios. |
AacAudioProfile
Perfil de codificación que se va a usar al codificar audio con AAC.
Nombre | Tipo | Description |
---|---|---|
AacLc |
string |
Especifica que el audio de salida se va a codificar en el perfil de complejidad baja de AAC (AAC-LC). |
HeAacV1 |
string |
Especifica que el audio de salida se va a codificar en el perfil HE-AAC v1. |
HeAacV2 |
string |
Especifica que el audio de salida se va a codificar en el perfil HE-AAC v2. |
AbsoluteClipTime
Especifica el tiempo de recorte como una posición de tiempo absoluta en el archivo multimedia. El tiempo absoluto puede apuntar a una posición diferente en función de si el archivo multimedia se inicia desde una marca de tiempo de cero o no.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
time |
string |
Posición de hora en la escala de tiempo del medio de entrada. Normalmente se especifica como un período de ISO8601. Por ejemplo, PT30S durante 30 segundos. |
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" cambiará el tamaño de los vídeos de entrada a la definición estándar, a la vez que conserva la relación de aspecto adecuada. Solo cambiará el tamaño si el vídeo es de mayor resolución. Por ejemplo, una entrada de 1920x1080 se escalaría a 640x360 antes del procesamiento. Cambiar a "StandardDefinition" reducirá el tiempo necesario para 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 obtener más información). Sin embargo, es posible que no se detecten caras que terminen siendo demasiado pequeñas en el vídeo cambiado.
Nombre | Tipo | Description |
---|---|---|
SourceResolution |
string |
|
StandardDefinition |
string |
AttributeFilter
Tipo de AttributeFilter que se va a aplicar a TrackAttribute para seleccionar las pistas.
Nombre | Tipo | Description |
---|---|---|
All |
string |
Se incluirán todas las pistas. |
Bottom |
string |
La primera pista se incluirá cuando el atributo se ordene en orden ascendente. Por lo general, se usa para seleccionar la velocidad de bits más pequeña. |
Top |
string |
La primera pista se incluirá cuando el atributo se ordene en orden descendente. Por lo general, se usa para seleccionar la velocidad de bits más grande. |
ValueEquals |
string |
Se incluirán todas las pistas que tengan un atributo igual al valor especificado. |
Audio
Define las propiedades comunes para todos los códecs de audio.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
bitrate |
integer |
Velocidad de bits, en bits por segundo, del audio codificado de salida. |
channels |
integer |
Número de canales en el audio. |
label |
string |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
samplingRate |
integer |
Frecuencia de muestreo que se va a usar para la codificación en hercios. |
AudioAnalysisMode
Determina el conjunto de operaciones de análisis de audio que se van a realizar. Si no se especifica, se elegiría El estándar AudioAnalysisMode.
Nombre | Tipo | 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 de Audio Analyzer aplica un conjunto predefinido de operaciones de análisis basadas en IA, incluida la transcripción de voz. Actualmente, el valor predeterminado admite el procesamiento de contenido con una sola pista de audio.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
audioLanguage |
string |
Idioma de la carga de audio en la entrada mediante el formato BCP-47 de "etiqueta de idioma-región" (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 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 revertirí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 van a realizar. Si no se especifica, se elegiría El estándar AudioAnalysisMode. |
AudioOverlay
Describe las propiedades de una superposición de audio.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de 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, en el que 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 durará mientras dure el medio de superposición. |
fadeInDuration |
string |
Duración en la que se atenua la superposición 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 tener ninguna atenuación (igual que PT0S). |
fadeOutDuration |
string |
Duración en la que se atenua la superposición 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 tener ningún atenuado (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 la lista completa de formatos de archivo de audio y vídeo admitidos. |
start |
string |
Posición inicial, con referencia al vídeo de entrada, en el que 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 que la superposición se inicie desde el principio del vídeo de entrada. |
AudioTrackDescriptor
TrackSelection para seleccionar pistas de audio.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
channelMapping |
Designación opcional para pistas de audio de canal único. Se puede usar para combinar las pistas en pistas de audio estéreo o multicanal. |
BlurType
Tipo de desenfoque
Nombre | Tipo | Description |
---|---|---|
Black |
string |
Negro: Filtro de salida negro |
Box |
string |
Cuadro: filtro de depuración, rectángulo de límite solo |
High |
string |
Alto: Confundir filtro de desenfoque |
Low |
string |
Bajo: filtro de desenfoque de coche box-car |
Med |
string |
Med: Filtro de desenfoque gaussiano |
BuiltInStandardEncoderPreset
Describe un valor preestablecido integrado para codificar el vídeo de entrada con el codificador estándar.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
configurations |
Opciones de configuración opcionales para el codificador. Las configuraciones solo se admiten para ContentAwareEncoding y H265ContentAwareEncoding BuiltInStandardEncoderPreset. |
|
presetName |
Valor preestablecido integrado que se va a usar para codificar vídeos. |
ChannelMapping
Designación opcional para pistas de audio de canal único. Se puede usar para combinar las pistas en pistas de audio estéreo o multicanal.
Nombre | Tipo | Description |
---|---|---|
BackLeft |
string |
Canal de atrás a la izquierda. A veces se conoce como canal envolvente izquierdo. |
BackRight |
string |
Canal de atrás a la derecha. A veces se conoce como canal envolvente derecho. |
Center |
string |
Canal central. |
FrontLeft |
string |
Canal izquierdo frontal. |
FrontRight |
string |
Canal frontal derecho. |
LowFrequencyEffects |
string |
Canal de efectos de baja frecuencia. A veces se conoce como subwoofer. |
StereoLeft |
string |
Canal estéreo izquierdo. A veces se conoce como Combinación de abajo izquierda. |
StereoRight |
string |
Canal estéreo derecho. A veces se conoce como Combinación hacia abajo derecha. |
Complexity
Permite configurar los valores del codificador para controlar el equilibrio entre velocidad y calidad. Ejemplo: establezca Complejidad como Velocidad para una codificación más rápida, pero menos eficiencia de compresión.
Nombre | Tipo | Description |
---|---|---|
Balanced |
string |
Configura el codificador para usar las opciones que logran un equilibrio entre velocidad y calidad. |
Quality |
string |
Configura el codificador para usar la configuración optimizada para generar una salida de mayor calidad a costa de un tiempo de codificación general más lento. |
Speed |
string |
Configura el codificador para usar la configuración optimizada para una codificación más rápida. La calidad se sacrifica para reducir el tiempo de codificación. |
CopyAudio
Marca de códec, que indica al codificador que copie la secuencia de bits de audio de entrada.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
label |
string |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
CopyVideo
Marca de códec, que indica al codificador que copie la secuencia de bits de vídeo de entrada sin volver a codificar.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
label |
string |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DDAudio
Describe la configuración de codificación de audio Dolby Digital Audio Codec (AC3). La implementación actual para la compatibilidad con Dolby Digital Audio son: Números de canal de audio en 1(mono), 2(estéreo), 6(5.1side); Frecuencia de muestreo de audio a: 32K/44,1K/48K Hz; Los valores de velocidad de bits de audio como especificación AC3 admiten: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
bitrate |
integer |
Velocidad de bits, en bits por segundo, del audio codificado de salida. |
channels |
integer |
Número de canales en el audio. |
label |
string |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
samplingRate |
integer |
Frecuencia de muestreo que se va a usar para la codificación en hercios. |
Deinterlace
Describe la configuración de desconlazamiento.
Nombre | Tipo | Description |
---|---|---|
mode |
Modo de desinterlazado. El valor predeterminado es AutoPixelAdaptive. |
|
parity |
La paridad de campos para la desenlazamiento, el valor predeterminado es Auto. |
DeinterlaceMode
Modo de desinterlazado. El valor predeterminado es AutoPixelAdaptive.
Nombre | Tipo | Description |
---|---|---|
AutoPixelAdaptive |
string |
Aplique la deslazamiento adaptable de píxeles automático en cada fotograma del vídeo de entrada. |
Off |
string |
Deshabilita la desconlazamiento del vídeo de origen. |
DeinterlaceParity
La paridad de campos para la desenlazamiento, el valor predeterminado es Auto.
Nombre | Tipo | 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 del campo superior del vídeo de entrada. |
EncoderNamedPreset
Valor preestablecido integrado que se va a usar para codificar vídeos.
Nombre | Tipo | Description |
---|---|---|
AACGoodQualityAudio |
string |
Genera un único archivo MP4 que contiene solo audio estéreo AAC codificado en 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 archivos MP4 con alineación GOP mediante la codificación compatible con 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 compatible con 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. |
DDGoodQualityAudio |
string |
Genera un único archivo MP4 que contiene solo audio estéreo DD(Digital Dolby) codificado en 192 kbps. |
H264MultipleBitrate1080p |
string |
Genera un conjunto de 8 archivos MP4 alineados con GOP, que van de 6000 kbps a 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 van desde 3400 kbps hasta 400 kbps y audio AAC estéreo. La resolución comienza a las 720p y baja a 180p. |
H264MultipleBitrateSD |
string |
Genera un conjunto de 5 archivos MP4 alineados con GOP, que van de 1900 kbps a 400 kbps y audio AAC estéreo. La resolución comienza a las 480p y baja a 240p. |
H264SingleBitrate1080p |
string |
Genera un archivo MP4 donde el vídeo está codificado con el códec H.264 a 6750 kbps y un alto 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 un alto 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 un alto 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 archivos MP4 con alineación GOP mediante la codificación compatible con 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 está codificado con el códec H.265 a 3500 kbps y un alto 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 está codificado con el códec H.265 a 9500 kbps y un alto 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 está codificado con el códec H.265 a 1800 kbps y un alto 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.
Nombre | Tipo | Description |
---|---|---|
Cabac |
string |
Codificación de codificación aritmética binaria aritmética contextual (CABAC). |
Cavlc |
string |
Codificación de entropía de longitud variable adaptable de contexto (CAVLC). |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
FaceDetectorPreset
Describe toda la configuración que se va a usar al analizar un vídeo para detectar (y, opcionalmente, censurar) todas las caras presentes.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de 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 las siguientes opciones: 1) Analizar: solo para la detección. Este modo genera un archivo JSON de metadatos que marca las apariencias de las caras en todo el vídeo. Siempre que sea posible, a las apariencias de la misma persona se les asigna el mismo identificador. 2) Combinado: además redactes (desenfoque) caras detectadas. 3) Redact: esto permite un proceso de 2 pasos, lo que permite la reacción 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 identificadores que requieren redacción. |
|
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" cambiará el tamaño de los vídeos de entrada a la definición estándar, a la vez que conserva la relación de aspecto adecuada. Solo cambiará el tamaño si el vídeo es de mayor resolución. Por ejemplo, una entrada de 1920x1080 se escalaría a 640 x 360 antes del procesamiento. Cambiar a "StandardDefinition" reducirá el tiempo necesario para 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 obtener más información). Sin embargo, es posible que no se detecten caras que terminen siendo demasiado pequeñas en el vídeo cambiado. |
FaceRedactorMode
Este modo proporciona la capacidad de elegir entre las siguientes opciones: 1) Analizar: solo para la detección. Este modo genera un archivo JSON de metadatos que marca las apariencias de las caras en todo el vídeo. Siempre que sea posible, a las apariencias de la misma persona se les asigna el mismo identificador. 2) Combinado: además redactes (desenfoque) caras detectadas. 3) Redact: esto permite un proceso de 2 pasos, lo que permite la reacción 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 identificadores que requieren redacción.
Nombre | Tipo | Description |
---|---|---|
Analyze |
string |
El modo de análisis detecta caras y genera un archivo de metadatos con los resultados. Permite la edición del archivo de metadatos antes de que las caras se desenfoquen con el modo Redact. |
Combined |
string |
El modo combinado realiza los pasos Analizar y Redact en un paso al editar las caras analizadas no es deseada. |
Redact |
string |
El modo Redact consume el archivo de metadatos del modo Analizar y redacta las caras encontradas. |
Fade
Describe las propiedades de un efecto Fade aplicado al medio de entrada.
Nombre | Tipo | Description |
---|---|---|
duration |
string |
Duración del efecto de atenuación en el vídeo. El valor puede estar en formato ISO 8601 (por ejemplo, PT05S para atenuar un color durante 5 segundos) o un recuento de fotogramas (por ejemplo, 10 a atenuar 10 fotogramas desde la hora de inicio) o un valor relativo a la duración de la secuencia (por ejemplo, 10 % a atenuar el 10 % de la duración de la secuencia). |
fadeColor |
string |
Color para el fundido de entrada y salida. puede estar en los colores https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords CSS Level1 o en un valor RGB/hexadecimal: por ejemplo: rgb(255,0,0), 0xFF0000 o #FF0000 |
start |
string |
Posición en el vídeo de entrada desde dónde empezar a atenuarse. 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). El valor predeterminado es 0. |
Filters
Describe todas las operaciones de filtrado, como desacoplación, rotación, etc. que se van a aplicar a los medios de entrada antes de la codificación.
Nombre | Tipo | Description |
---|---|---|
crop |
Parámetros de la ventana rectangular con la que recortar el vídeo de entrada. |
|
deinterlace |
La configuración de desconlazamiento. |
|
fadeIn |
Describe las propiedades de un efecto Fade aplicado al medio de entrada. |
|
fadeOut |
Describe las propiedades de un efecto Fade aplicado al medio de entrada. |
|
overlays | Overlay[]: |
Propiedades de superposiciones que se van a aplicar 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 codificarla. El valor predeterminado es Automático |
FromAllInputFile
InputDefinition que busca en todos los archivos proporcionados para seleccionar las pistas especificadas por la propiedad IncludedTracks. Por lo general, se usa con AudioTrackByAttribute y VideoTrackByAttribute para permitir la selección de una sola pista en un conjunto de archivos de entrada.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
includedTracks | TrackDescriptor[]: |
Lista de trackDescriptors que definen los metadatos y la selección de pistas en la entrada. |
FromEachInputFile
InputDefinition que examina cada archivo de entrada proporcionado para seleccionar las pistas especificadas por la propiedad IncludedTracks. Por lo general, se usa con AudioTrackByAttribute y VideoTrackByAttribute para seleccionar pistas de cada archivo especificado.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
includedTracks | TrackDescriptor[]: |
Lista de trackDescriptors que definen los metadatos y la selección de pistas en la entrada. |
H264Complexity
Indica al codificador cómo elegir su configuración de codificación. El valor predeterminado es Equilibrado.
Nombre | Tipo | Description |
---|---|---|
Balanced |
string |
Indica al codificador que use la configuración que logre un equilibrio entre velocidad y calidad. |
Quality |
string |
Indica al codificador que use la configuración optimizada 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 sacrifica para reducir el tiempo de codificación. |
H264Layer
Describe la configuración que se 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.
Nombre | Tipo | Description |
---|---|---|
adaptiveBFrame |
boolean |
Si se van a usar marcos B adaptables o no al codificar esta capa. Si no se especifica, el codificador lo activará siempre que el perfil de vídeo permita su uso. |
bFrames |
integer |
Número de fotogramas B que se van a usar 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). |
crf |
number |
Valor de CRF que se va a usar al codificar esta capa. Esta configuración surte efecto cuando RateControlMode del códec de vídeo se establece en modo CRF. El intervalo de valor de CRF está comprendido entre 0 y 51, donde los valores inferiores darían como resultado una mejor calidad, a costa de tamaños de archivo mayores. Los valores más altos significan más compresión, pero en algún momento se observará la degradación de la calidad. El valor predeterminado es 23. |
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 va a codificar esta capa. El valor puede estar en forma de 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 como entrada. |
label |
string |
Etiqueta alfanumérica de esta capa, que se puede usar en la multiplexación de diferentes capas de vídeo y audio, o en la nomenclatura del 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 asumir el búfer de VBV para rellenar. Si no se especifica, el valor predeterminado es el mismo que la velocidad de bits. |
profile |
Actualmente se admite la línea base, Main, High, High422, High444. El valor predeterminado es Automático. |
|
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 van a usar 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. |
H264RateControlMode
Modo de control de velocidad de vídeo
Nombre | Tipo | Description |
---|---|---|
ABR |
string |
Modo promedio de velocidad de bits (ABR) que alcanza la velocidad de bits de destino: modo predeterminado. |
CBR |
string |
Modo de velocidad de bits constante (CBR) que ajusta las variaciones de velocidad de bits alrededor de la velocidad de bits de destino. |
CRF |
string |
Modo factor de velocidad constante (CRF) que se dirige a una calidad objetiva constante. |
H264Video
Describe todas las propiedades para codificar un vídeo con el códec H.264.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
complexity |
Indica al codificador cómo elegir su configuración de codificación. El valor predeterminado es Equilibrado. |
|
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 |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
layers |
Colección de capas H.264 de salida que va a generar el codificador. |
|
rateControlMode |
Modo de control de velocidad de vídeo |
|
sceneChangeDetection |
boolean |
Si el codificador debe insertar fotogramas clave en los cambios en la escena. Si no se especifica, el valor predeterminado es false. Esta marca debe establecerse en true solo cuando se configura el codificador para generar un solo vídeo de salida. |
stretchMode |
Modo de cambio de tamaño: cómo se cambiará 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 admite la línea base, Main, High, High422, High444. El valor predeterminado es Automático.
Nombre | Tipo | 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 más alto 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 Equilibrado.
Nombre | Tipo | Description |
---|---|---|
Balanced |
string |
Indica al codificador que use la configuración que logre un equilibrio entre velocidad y calidad. |
Quality |
string |
Indica al codificador que use la configuración optimizada para generar una salida de mayor calidad a costa del 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 sacrifica para reducir el tiempo de codificación. |
H265Layer
Describe la configuración que se 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.
Nombre | Tipo | Description |
---|---|---|
adaptiveBFrame |
boolean |
Especifica si se van a usar marcos B adaptables o no al codificar esta capa. Si no se especifica, el codificador lo activará siempre que el perfil de vídeo permita su uso. |
bFrames |
integer |
Número de fotogramas B que se van a usar 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 3 Mbps significa que este valor debe ser 3000000 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). |
crf |
number |
Valor de CRF que se va a usar al codificar esta capa. Esta configuración surte efecto cuando RateControlMode del códec de vídeo se establece en modo CRF. El intervalo de valor de CRF está comprendido entre 0 y 51, donde los valores inferiores darían como resultado una mejor calidad, a costa de tamaños de archivo mayores. Los valores más altos significan más compresión, pero en algún momento se observará la degradación de la calidad. El valor predeterminado es 28. |
frameRate |
string |
Velocidad de fotogramas (en fotogramas por segundo) a la que se va a codificar esta capa. El valor puede estar en forma de 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 como entrada. |
label |
string |
Etiqueta alfanumérica de esta capa, que se puede usar en la multiplexación de diferentes capas de vídeo y audio, o en la nomenclatura del 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 asumir el búfer de VBV para rellenar. Si no se especifica, el valor predeterminado es el mismo que la velocidad de bits. |
profile |
Actualmente se admite Main. El valor predeterminado es Automático. |
|
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 van a usar 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.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de 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 a 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 Equilibrado. |
|
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 |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
layers |
Colección de capas H.265 de salida que va a generar el codificador. |
|
sceneChangeDetection |
boolean |
Especifica si el codificador debe insertar fotogramas clave en los cambios en la escena. Si no se especifica, el valor predeterminado es false. Esta marca debe establecerse en true solo cuando se configura el codificador para generar un solo vídeo de salida. |
stretchMode |
Modo de cambio de tamaño: cómo se cambiará 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 Automático.
Nombre | Tipo | 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) |
Main10 |
string |
Perfil principal 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10) |
Image
Describe las propiedades básicas para generar miniaturas a partir del vídeo de entrada.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de 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 |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
range |
string |
Posición relativa a la hora de inicio preestablecida de transformación en el vídeo de entrada en el que se dejan de generar miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT5M30S para detener en 5 minutos y 30 segundos desde la hora de inicio) o un recuento de fotogramas (por ejemplo, 300 para detener en el fotograma 300 del fotograma en la hora de inicio. Si este valor es 1, significa que solo se produce una miniatura a la hora de inicio) o un valor relativo a la duración de la secuencia (por ejemplo, el 50 % para detener a la mitad de la duración de la secuencia desde la hora 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) o 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, 10 % para una imagen cada 10 % de 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 de paso desde la hora de inicio como la 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 el momento de inicio. Intente seleccionar un valor razonable para Step (Paso) si se espera que la primera miniatura esté cerca de la hora de inicio o establezca el valor de Range en 1 si solo se necesita una miniatura en la hora de inicio. |
stretchMode |
Modo de cambio de tamaño: cómo se cambiará 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.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
filenamePattern |
string |
El patrón de nomenclatura de archivos usado para la creación de archivos de salida. 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 32 primeros caracteres de longitud total. {Extensión}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a miniaturas. {AudioStream}: cadena "Audio" más número de secuencia de audio (comienza desde 1). {Velocidad de bits}: velocidad de bits de audio/vídeo en kbps. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio/vídeo. {Resolución}: resolución de vídeo. Todas las macros no sustitutas se contraerán y se quitarán del nombre de archivo. |
InputFile
InputDefinition para un único archivo. TrackSelections se limita al archivo especificado.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
filename |
string |
Nombre del archivo al que se aplica esta definición de entrada. |
includedTracks | TrackDescriptor[]: |
Lista de trackDescriptors que definen los metadatos y la selección de pistas en la entrada. |
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 esto en AllInsights y la entrada es solo audio, solo se generan conclusiones de audio. Del mismo modo, si la entrada es solo vídeo, solo se generan conclusiones de vídeo. Se recomienda no usar AudioInsightsOnly si espera que algunas de sus entradas sean solo vídeos; o use VideoInsightsOnly si espera que algunas de sus entradas sean solo audio. Los trabajos en estas condiciones generarían errores.
Nombre | Tipo | Description |
---|---|---|
AllInsights |
string |
Genere información sobre audio y vídeo. Se produce un error si se produce un error en Insights de audio o vídeo. |
AudioInsightsOnly |
string |
Generar información solo de audio. Omita el vídeo incluso si está presente. Se produce un error si no hay audio presente. |
VideoInsightsOnly |
string |
Generar información solo de vídeo. Omita el audio si está presente. Se produce un error si no hay ningún vídeo presente. |
InterleaveOutput
Establece el modo de intercalación de la salida para controlar cómo se almacenan el audio y el vídeo en el formato de contenedor. Ejemplo: establezca InterleavedOutput como NonInterleavedOutput para generar salidas de solo audio y solo vídeo en archivos MP4 independientes.
Nombre | Tipo | Description |
---|---|---|
InterleavedOutput |
string |
La salida incluye audio y vídeo. |
NonInterleavedOutput |
string |
La salida es solo vídeo o solo audio. |
Job
Tipo de recurso Job. El progreso y el estado se pueden obtener mediante el sondeo de un trabajo o la suscripción a eventos mediante EventGrid.
Nombre | Tipo | 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.correlationData |
object |
Clave proporcionada por el cliente, pares de valor que se devolverán en eventos de estado Job y JobOutput. |
properties.created |
string |
Fecha y hora UTC en que el cliente ha creado el trabajo, en formato "AAAA-MM-DDThh:mm:ssZ". |
properties.description |
string |
Descripción opcional del trabajo proporcionada por el cliente. |
properties.endTime |
string |
Fecha y hora UTC en la que este trabajo finalizó el procesamiento. |
properties.input | JobInput: |
Las entradas para el trabajo. |
properties.lastModified |
string |
Fecha y hora UTC en que el cliente ha actualizado por última vez el trabajo, en formato "AAAA-MM-DDThh:mm:ssZ". |
properties.outputs | JobOutput[]: |
Las salidas del trabajo. |
properties.priority |
Prioridad con la que se debe procesar el trabajo. Los trabajos con prioridad superior se procesan antes que los trabajos con prioridad inferior. Si no se establece, el valor predeterminado es normal. |
|
properties.startTime |
string |
Fecha y hora UTC en la que este trabajo comenzó a procesarse. |
properties.state |
Estado actual del trabajo. |
|
systemData |
Metadatos del sistema relacionados con este recurso. |
|
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
JobError
Detalles de los errores de JobOutput.
Nombre | Tipo | Description |
---|---|---|
category |
Ayuda con la categorización de errores. |
|
code |
Código de error que describe el error. |
|
details |
Matriz de detalles sobre errores específicos que llevaron a este error notificado. |
|
message |
string |
Representación dependiente del idioma legible del error. |
retry |
Indica que puede volver a intentar el trabajo. Si el reintento no se realiza correctamente, póngase en contacto con Soporte técnico de Azure a través de Azure Portal. |
JobErrorCategory
Ayuda con la categorización de errores.
Nombre | Tipo | Description |
---|---|---|
Account |
string |
El error está relacionado con la información de la cuenta. |
Configuration |
string |
El error está relacionado con la configuración. |
Content |
string |
El error está relacionado con los datos de los archivos de entrada. |
Download |
string |
El error está relacionado con la descarga. |
Service |
string |
El error está relacionado con el servicio. |
Upload |
string |
El error está relacionado con la carga. |
JobErrorCode
Código de error que describe el error.
Nombre | Tipo | Description |
---|---|---|
ConfigurationUnsupported |
string |
Hubo un problema con la combinación de archivos de entrada y las opciones de configuración aplicadas, corrija los valores de configuración y vuelva a intentarlo con la misma entrada, o cambie la entrada para que coincida con la configuración. |
ContentMalformed |
string |
Hubo un problema con el contenido de entrada (por ejemplo: archivos de bytes cero o archivos dañados o no descodables), compruebe los archivos de entrada. |
ContentUnsupported |
string |
Hubo un problema con el formato de la entrada (archivo multimedia no válido o un archivo o códec no admitido), compruebe la validez de los archivos de entrada. |
DownloadNotAccessible |
string |
Al intentar descargar los archivos de entrada, los archivos no eran accesibles, compruebe la disponibilidad del origen. |
DownloadTransientError |
string |
Al intentar descargar los archivos de entrada, se produjo un problema durante la transferencia (servicio de almacenamiento, errores de red), consulte los detalles y compruebe el origen. |
IdentityUnsupported |
string |
Error al comprobar la identidad de la cuenta. Compruebe y corrija las configuraciones de identidad y vuelva a intentarlo. Si no se realiza correctamente, póngase en contacto con el soporte técnico. |
ServiceError |
string |
Error irrecuperable del servicio, póngase en contacto con el soporte técnico. |
ServiceTransientError |
string |
Error transitorio, vuelva a intentarlo si el reintento no se realiza correctamente, póngase en contacto con el soporte técnico. |
UploadNotAccessible |
string |
Al intentar cargar los archivos de salida, el destino no era accesible, compruebe la disponibilidad del destino. |
UploadTransientError |
string |
Al intentar cargar los archivos de salida, se produjo un problema durante la transferencia (servicio de almacenamiento, errores de red), consulte los detalles y compruebe el destino. |
JobErrorDetail
Detalles de los errores de JobOutput.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código que describe el detalle del error. |
message |
string |
Representación legible del error. |
JobInputAsset
Representa un recurso para la entrada en un trabajo.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
assetName |
string |
Nombre del recurso de entrada. |
end | ClipTime: |
Define un punto en la escala de tiempo del medio de entrada en el que finalizará el procesamiento. El valor predeterminado es el final del medio de entrada. |
files |
string[] |
Lista de archivos. Obligatorio para JobInputHttp. Máximo de 4000 caracteres cada uno. Las cadenas de consulta no se devolverán en las respuestas de servicio para evitar la exposición de datos confidenciales. |
inputDefinitions | InputDefinition[]: |
Define una lista de InputDefinitions. Para cada InputDefinition, define una lista de selecciones de seguimiento y metadatos relacionados. |
label |
string |
Etiqueta que se asigna a un JobInputClip, que se usa para satisfacer una referencia utilizada en la transformación. Por ejemplo, se puede crear una transformación para tomar un archivo de imagen con la etiqueta "xyz" y aplicarlo como superposición en el vídeo de entrada antes de codificarlo. Al enviar un trabajo, exactamente uno de los JobInputs debe ser el archivo de imagen y debe tener la etiqueta "xyz". |
start | ClipTime: |
Define un punto en la escala de tiempo del medio de entrada en el que se iniciará el procesamiento. El valor predeterminado es el principio del medio de entrada. |
JobInputClip
Representa los archivos de entrada de un trabajo.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
end | ClipTime: |
Define un punto en la escala de tiempo del medio de entrada en el que finalizará el procesamiento. El valor predeterminado es el final del medio de entrada. |
files |
string[] |
Lista de archivos. Obligatorio para JobInputHttp. Máximo de 4000 caracteres cada uno. Las cadenas de consulta no se devolverán en las respuestas de servicio para evitar la exposición de datos confidenciales. |
inputDefinitions | InputDefinition[]: |
Define una lista de InputDefinitions. Para cada InputDefinition, define una lista de selecciones de seguimiento y metadatos relacionados. |
label |
string |
Etiqueta que se asigna a un JobInputClip, que se usa para satisfacer una referencia utilizada en la transformación. Por ejemplo, se puede crear una transformación para tomar un archivo de imagen con la etiqueta "xyz" y aplicarlo como superposición en el vídeo de entrada antes de codificarlo. Al enviar un trabajo, exactamente uno de los JobInputs debe ser el archivo de imagen y debe tener la etiqueta "xyz". |
start | ClipTime: |
Define un punto en la escala de tiempo del medio de entrada en el que se iniciará el procesamiento. El valor predeterminado es el principio del medio de entrada. |
JobInputHttp
Representa la entrada del trabajo HTTPS.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
baseUri |
string |
URI base para la entrada del trabajo HTTPS. Se concatenará con los nombres de archivo proporcionados. Si no se proporciona ningún URI base, se supone que la lista de archivos proporcionada es URI completo. Longitud máxima de 4000 caracteres. Las cadenas de consulta no se devolverán en las respuestas de servicio para evitar la exposición de datos confidenciales. |
end | ClipTime: |
Define un punto en la escala de tiempo del medio de entrada en el que finalizará el procesamiento. El valor predeterminado es el final del medio de entrada. |
files |
string[] |
Lista de archivos. Obligatorio para JobInputHttp. Máximo de 4000 caracteres cada uno. Las cadenas de consulta no se devolverán en las respuestas de servicio para evitar la exposición de datos confidenciales. |
inputDefinitions | InputDefinition[]: |
Define una lista de InputDefinitions. Para cada InputDefinition, define una lista de selecciones de pista y metadatos relacionados. |
label |
string |
Etiqueta que se asigna a un JobInputClip, que se usa para satisfacer una referencia utilizada en la transformación. Por ejemplo, se puede crear una transformación para tomar un archivo de imagen con la etiqueta "xyz" y aplicarlo como una superposición en el vídeo de entrada antes de codificarse. Al enviar un trabajo, exactamente uno de los jobInputs debe ser el archivo de imagen y debe tener la etiqueta "xyz". |
start | ClipTime: |
Define un punto en la escala de tiempo del medio de entrada en el que se iniciará el procesamiento. El valor predeterminado es el principio del medio de entrada. |
JobInputs
Describe una lista de entradas para un trabajo.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
inputs | JobInput[]: |
Lista de entradas para un trabajo. |
JobInputSequence
Una secuencia contiene una lista ordenada de clips donde cada clip es jobInput. La secuencia se tratará como una sola entrada.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
inputs | JobInputClip[]: |
JobInputs que componen la escala de tiempo. |
JobOutputAsset
Representa un recurso usado como JobOutput.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
assetName |
string |
Nombre del recurso de salida. |
endTime |
string |
Fecha y hora UTC a la que finalizó el procesamiento de esta salida del trabajo. |
error |
Si JobOutput está en el estado Error, contiene los detalles del error. |
|
label |
string |
Etiqueta que se asigna a un JobOutput para ayudar a identificarla de forma única. Esto resulta útil cuando la transformación tiene más de un objeto TransformOutput, en el que el trabajo tiene más de un JobOutput. En tales casos, al enviar el trabajo, agregará dos o más JobOutputs, en el mismo orden que TransformOutputs en la transformación. Posteriormente, al recuperar el trabajo, ya sea a través de eventos o en una solicitud GET, puede usar la etiqueta para identificar fácilmente JobOutput. Si no se proporciona una etiqueta, se usará un valor predeterminado de '{presetName}_{outputIndex}', donde el nombre preestablecido es el nombre del valor preestablecido en el transformOutput correspondiente y el índice de salida es el índice relativo de este JobOutput dentro del trabajo. Tenga en cuenta que este índice es el mismo que el índice relativo del objeto TransformOutput correspondiente dentro de su transformación. |
presetOverride | Preset: |
Valor preestablecido usado para invalidar el valor preestablecido en la salida de transformación correspondiente. |
progress |
integer |
Si JobOutput está en un estado de procesamiento, contiene el porcentaje de finalización del trabajo. El valor es una estimación y no pretende usarse para predecir los tiempos de finalización del trabajo. Para determinar si el jobOutput está completo, use la propiedad State. |
startTime |
string |
Fecha y hora UTC a la que comenzó el procesamiento de esta salida del trabajo. |
state |
Describe el estado de JobOutput. |
JobRetry
Indica que puede volver a intentar el trabajo. Si el reintento no se realiza correctamente, póngase en contacto con Soporte técnico de Azure a través de Azure Portal.
Nombre | Tipo | Description |
---|---|---|
DoNotRetry |
string |
Es necesario investigar el problema y, a continuación, volver a enviar el trabajo con correcciones o reintentar una vez corregido el problema subyacente. |
MayRetry |
string |
El problema se puede resolver después de esperar un período de tiempo y volver a enviar el mismo trabajo. |
JobState
Describe el estado de JobOutput.
Nombre | Tipo | Description |
---|---|---|
Canceled |
string |
El trabajo se canceló. Se trata de un estado final para el trabajo. |
Canceling |
string |
El trabajo está en proceso de cancelación. Se trata de un estado transitorio para el trabajo. |
Error |
string |
El trabajo ha encontrado un error. Se trata de un estado final para el trabajo. |
Finished |
string |
El trabajo ha finalizado. Se trata de un estado final para el trabajo. |
Processing |
string |
El trabajo se está procesando. Se trata de un estado transitorio para el trabajo. |
Queued |
string |
El trabajo está en un estado en cola, esperando a que los recursos estén disponibles. Se trata de un estado transitorio. |
Scheduled |
string |
El trabajo se está programando para ejecutarse en un recurso disponible. Se trata de un estado transitorio, entre los estados en cola y de procesamiento. |
JpgFormat
Describe la configuración para generar miniaturas JPEG.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
filenamePattern |
string |
El patrón de nomenclatura de archivos usado para la creación de archivos de salida. 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 32 primeros caracteres de longitud total. {Extensión}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a miniaturas. {AudioStream}: cadena "Audio" más número de secuencia de audio (comienza desde 1). {Velocidad de bits}: velocidad de bits de audio/vídeo en kbps. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio/vídeo. {Resolución}: resolución de vídeo. Todas las macros no sustitutas se contraerán y se 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.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de 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 |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
layers |
Jpg |
Colección de capas de imagen JPEG de salida que el codificador va a generar. |
range |
string |
Posición relativa a la hora de inicio preestablecida de transformación en el vídeo de entrada en el que se dejan de generar miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT5M30S para detener en 5 minutos y 30 segundos desde la hora de inicio) o un recuento de fotogramas (por ejemplo, 300 para detener en el fotograma 300 del fotograma en la hora de inicio. Si este valor es 1, significa que solo se produce una miniatura a la hora de inicio) o un valor relativo a la duración de la secuencia (por ejemplo, el 50 % para detener a la mitad de la duración de la secuencia desde la hora 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 vaya más allá del 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) o 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, 10 % para una imagen cada 10 % de 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 de paso desde la hora de inicio como la 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 el momento de inicio. Intente seleccionar un valor razonable para Step (Paso) si se espera que la primera miniatura esté cerca de la hora de inicio o establezca el valor de Range en 1 si solo se necesita una miniatura en la hora de inicio. |
stretchMode |
Modo de cambio de tamaño: cómo se cambiará 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.
Nombre | Tipo | Description |
---|---|---|
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 como entrada. |
label |
string |
Etiqueta alfanumérica de esta capa, que se puede usar en la multiplexación de diferentes capas de vídeo y audio, o en la nomenclatura del archivo de salida. |
quality |
integer |
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.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
filenamePattern |
string |
El patrón de nomenclatura de archivos usado para la creación de archivos de salida. 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 32 primeros caracteres de longitud total. {Extensión}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a miniaturas. {AudioStream}: cadena "Audio" más número de secuencia de audio (comienza desde 1). {Velocidad de bits}: velocidad de bits de audio/vídeo en kbps. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio/vídeo. {Resolución}: resolución de vídeo. Todas las macros no sustitutas se contraerán y se quitarán del nombre de archivo. |
outputFiles |
Lista de archivos de salida que se van a generar. Cada entrada de la lista es un conjunto de etiquetas de capa de audio y vídeo que se van a silenciar 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 muxa junto con todos los audios. Los archivos de salida exactos generados se pueden controlar especificando la colección outputFiles.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
filenamePattern |
string |
El patrón de nomenclatura de archivos usado para la creación de archivos de salida. 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 32 primeros caracteres de longitud total. {Extensión}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a miniaturas. {AudioStream}: cadena "Audio" más número de secuencia de audio (comienza desde 1). {Velocidad de bits}: velocidad de bits de audio/vídeo en kbps. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio/vídeo. {Resolución}: resolución de vídeo. Todas las macros no sustitutas se contraerán y se quitarán del nombre de archivo. |
outputFiles |
Lista de archivos de salida que se van a generar. Cada entrada de la lista es un conjunto de etiquetas de capa de audio y vídeo que se van a silenciar juntas. |
OutputFile
Representa un archivo de salida generado.
Nombre | Tipo | Description |
---|---|---|
labels |
string[] |
Lista de etiquetas que describen cómo el codificador debe multiplex vídeo y audio en un archivo de salida. Por ejemplo, si el codificador está produciendo dos capas de vídeo con etiquetas v1 y v2, y una capa de audio con etiqueta a1, una matriz como "[v1, a1]" indica al codificador que genere 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.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
filenamePattern |
string |
El patrón de nomenclatura de archivos usado para la creación de archivos de salida. 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 32 primeros caracteres de longitud total. {Extensión}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a miniaturas. {AudioStream}: cadena "Audio" más número de secuencia de audio (comienza desde 1). {Velocidad de bits}: velocidad de bits de audio/vídeo en kbps. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio/vídeo. {Resolución}: resolución de vídeo. Todas las macros no sustitutas se contraerán y se 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.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de 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 |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
layers |
Png |
Colección de capas de imagen PNG de salida que el codificador va a generar. |
range |
string |
Posición relativa a la hora de inicio preestablecida de transformación en el vídeo de entrada en el que se dejan de generar miniaturas. El valor puede estar en formato ISO 8601 (por ejemplo, PT5M30S para detener en 5 minutos y 30 segundos desde la hora de inicio) o un recuento de fotogramas (por ejemplo, 300 para detener en el fotograma 300 del fotograma en la hora de inicio. Si este valor es 1, significa que solo se produce una miniatura a la hora de inicio) o un valor relativo a la duración de la secuencia (por ejemplo, el 50 % para detener a la mitad de la duración de la secuencia desde la hora 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) o 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, 10 % para una imagen cada 10 % de 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 de paso desde la hora de inicio como la 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 el momento de inicio. Intente seleccionar un valor razonable para Step (Paso) si se espera que la primera miniatura esté cerca de la hora de inicio o establezca el valor de Range en 1 si solo se necesita una miniatura en la hora de inicio. |
stretchMode |
Modo de cambio de tamaño: cómo se cambiará 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.
Nombre | Tipo | Description |
---|---|---|
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 como entrada. |
label |
string |
Etiqueta alfanumérica de esta capa, que se puede usar en la multiplexación de diferentes capas de vídeo y audio, o en la nomenclatura del 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. |
PresetConfigurations
Objeto de opciones de configuración opcionales para el codificador.
Nombre | Tipo | Description |
---|---|---|
complexity |
Permite configurar los valores del codificador para controlar el equilibrio entre velocidad y calidad. Ejemplo: establezca Complejidad como Velocidad para una codificación más rápida, pero menos eficiencia de compresión. |
|
interleaveOutput |
Establece el modo de intercalación de la salida para controlar cómo se almacenan el audio y el vídeo en el formato de contenedor. Ejemplo: establezca InterleavedOutput como NonInterleavedOutput para generar salidas de solo audio y solo vídeo en archivos MP4 independientes. |
|
keyFrameIntervalInSeconds |
number |
Intervalo de fotograma clave en segundos. Ejemplo: establezca KeyFrameIntervalInSeconds en 2 para reducir el almacenamiento en búfer de reproducción para algunos reproductores. |
maxBitrateBps |
integer |
Velocidad de bits máxima en bits por segundo (umbral para la capa de vídeo superior). Ejemplo: establezca MaxBitrateBps en 6000000 para evitar producir salidas de velocidad de bits muy altas para el contenido con alta complejidad. |
maxHeight |
integer |
Alto máximo de las capas de vídeo de salida. Ejemplo: establezca MaxHeight como 720 para generar capas de salida de hasta 720P incluso si la entrada es 4K. |
maxLayers |
integer |
Número máximo de capas de vídeo de salida. Ejemplo: establezca MaxLayers como 4 para asegurarse de que se generan como máximo 4 capas de salida para controlar el costo total del trabajo de codificación. |
minBitrateBps |
integer |
Velocidad de bits mínima en bits por segundo (umbral para la capa de vídeo inferior). Ejemplo: establezca MinBitrateBps en 200000 para tener una capa inferior que cubra a los usuarios con ancho de banda de red bajo. |
minHeight |
integer |
Alto mínimo de las capas de vídeo de salida. Ejemplo: establezca MinHeight en 360 para evitar capas de salida de resoluciones más pequeñas como 180P. |
Priority
Establece la prioridad relativa de transformOutputs dentro de una transformación. Esto establece la prioridad que usa el servicio para procesar TransformOutputs. La prioridad predeterminada es Normal.
Nombre | Tipo | 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 TransformOutput normal y de prioridad 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.
Nombre | Tipo | 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, 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, 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, 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, 50 %). |
Rotation
Rotación, si existe, que se va a aplicar al vídeo de entrada, antes de codificarla. El valor predeterminado es Automático
Nombre | Tipo | Description |
---|---|---|
Auto |
string |
Detecte y gire automáticamente según sea necesario. |
None |
string |
No gire el vídeo. Si el formato de salida lo admite, los metadatos sobre la rotación se mantienen intactos. |
Rotate0 |
string |
No gire 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. |
SelectAudioTrackByAttribute
Seleccione las pistas de audio de la entrada especificando un atributo y un filtro de atributo.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
attribute |
TrackAttribute por el que se van a filtrar las pistas. |
|
channelMapping |
Designación opcional para pistas de audio de canal único. Se puede usar para combinar las pistas en pistas de audio estéreo o multicanal. |
|
filter |
Tipo de AttributeFilter que se va a aplicar a TrackAttribute para seleccionar las pistas. |
|
filterValue |
string |
Valor por el que se van a filtrar las pistas. Solo se usa cuando se especifica AttributeFilter.ValueEquals para la propiedad Filter. |
SelectAudioTrackById
Seleccione las pistas de audio de la entrada especificando un identificador de pista.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
channelMapping |
Designación opcional para pistas de audio de canal único. Se puede usar para combinar las pistas en pistas de audio estéreo o multicanal. |
|
trackId |
integer |
Seguimiento del identificador para seleccionar |
SelectVideoTrackByAttribute
Seleccione pistas de vídeo de la entrada especificando un atributo y un filtro de atributo.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
attribute |
TrackAttribute por el que se van a filtrar las pistas. |
|
filter |
Tipo de AttributeFilter que se va a aplicar a TrackAttribute para seleccionar las pistas. |
|
filterValue |
string |
Valor por el que se van a filtrar las pistas. Solo se usa cuando se especifica AttributeFilter.ValueEquals para la propiedad Filter. Para TrackAttribute.Bitrate, debe ser un valor entero en bits por segundo (por ejemplo, '15000000'). TrackAttribute.Language no es compatible con pistas de vídeo. |
SelectVideoTrackById
Seleccione pistas de vídeo de la entrada especificando un identificador de pista.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
trackId |
integer |
Seguimiento del identificador para seleccionar |
StandardEncoderPreset
Describe toda la configuración que se va a usar al codificar el vídeo de entrada con el codificador estándar.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
codecs | Codec[]: |
Lista de códecs que se van a usar al codificar el vídeo de entrada. |
experimentalOptions |
object |
Diccionario que contiene pares clave-valor para parámetros no expuestos en el propio valor preestablecido |
filters |
Una o varias operaciones de filtrado que se aplican al medio de entrada antes de la codificación. |
|
formats | Format[]: |
Lista de salidas que va a generar el codificador. |
StretchMode
Modo de cambio de tamaño: cómo se cambiará el tamaño del vídeo de entrada para ajustarse a las resoluciones de salida deseadas. El valor predeterminado es AutoSize
Nombre | Tipo | Description |
---|---|---|
AutoFit |
string |
Rellene la salida (con cuadro de letras o cuadro de pilar) 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 solicita 1280x1280, la salida estará en 1280x1280, que contiene un rectángulo interno de 1280x720 en relación de aspecto de 16:9 y las regiones de cuadro de pilar 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 visualizació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 |
Respeta 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 visualización del vídeo de entrada. |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | 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. |
TrackAttribute
TrackAttribute para filtrar las pistas por.
Nombre | Tipo | Description |
---|---|---|
Bitrate |
string |
Velocidad de bits de la pista. |
Language |
string |
Idioma de la pista. |
TransportStreamFormat
Describe las propiedades para generar archivos de vídeo de salida mpeg-2 (ISO/IEC 13818-1).
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
filenamePattern |
string |
El patrón de nomenclatura de archivos usado para la creación de archivos de salida. 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 32 primeros caracteres de longitud total. {Extensión}: la extensión adecuada para este formato. {Label}: etiqueta asignada al códec o capa. {Index}: índice único para miniaturas. Solo se aplica a miniaturas. {AudioStream}: cadena "Audio" más número de secuencia de audio (comienza desde 1). {Velocidad de bits}: velocidad de bits de audio/vídeo en kbps. No es aplicable a las miniaturas. {Codec}: el tipo del códec de audio/vídeo. {Resolución}: resolución de vídeo. Todas las macros no sustitutas se contraerán y se quitarán del nombre de archivo. |
outputFiles |
Lista de archivos de salida que se van a generar. Cada entrada de la lista es un conjunto de etiquetas de capa de audio y vídeo que se van a silenciar juntas. |
UtcClipTime
Especifica la hora del clip como una posición de hora Utc en el archivo multimedia. La hora Utc puede apuntar a una posición diferente en función de si el archivo multimedia se inicia desde una marca de tiempo de cero o no.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
time |
string |
La posición de hora en la escala de tiempo del medio de entrada en función de la hora UTC. |
Video
Describe las propiedades básicas para codificar el vídeo de entrada.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de 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 |
Etiqueta opcional para el códec. La etiqueta se puede usar para controlar el comportamiento de multiplexación. |
stretchMode |
Modo de cambio de tamaño: cómo se cambiará 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.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |
audioLanguage |
string |
Idioma de la carga de audio en la entrada mediante el formato BCP-47 de "etiqueta de idioma-región" (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 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 revertirí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 esto en AllInsights y la entrada es solo audio, solo se generan conclusiones de audio. Del mismo modo, si la entrada es solo vídeo, solo se generan conclusiones de vídeo. Se recomienda no usar AudioInsightsOnly si espera que algunas de sus entradas sean solo vídeos; o use VideoInsightsOnly si espera que algunas de sus entradas sean solo audio. Los trabajos en estas condiciones generarían errores. |
|
mode |
Determina el conjunto de operaciones de análisis de audio que se van a realizar. Si no se especifica, se elegiría El estándar AudioAnalysisMode. |
VideoOverlay
Describe las propiedades de una superposición de vídeo.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de 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 o el vídeo superpuestos. |
|
end |
string |
Posición final, con referencia al vídeo de entrada, en el que 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 durará mientras dure el medio de superposición. |
fadeInDuration |
string |
Duración en la que se atenua la superposición 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 tener ninguna atenuación (igual que PT0S). |
fadeOutDuration |
string |
Duración en la que se atenua la superposición 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 tener ningún atenuado (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 la lista completa de 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 del vídeo de entrada donde se aplica la superposición. |
|
start |
string |
Posición inicial, con referencia al vídeo de entrada, en el que 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 que la superposición se inicie desde el principio del vídeo de entrada. |
VideoSyncMode
Modo de sincronización de vídeo
Nombre | Tipo | 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 quitará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 en 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 de 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 paso a través, pero si la entrada tiene marcos que tienen marcas de tiempo duplicadas, solo se pasa un fotograma a la salida y otros se quitan. 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 en la entrada. |
VideoTrackDescriptor
TrackSelection para seleccionar pistas de vídeo.
Nombre | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Discriminador de tipos derivados. |