Transforms - Update

Servicio:

Media Services

Versión de la API:

2022-07-01

Actualizar transformación
Novedades una transformación.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
accountName	path	True	string	Nombre de la cuenta de Media Services.
resourceGroupName	path	True	string	Nombre del grupo de recursos dentro de la suscripción de Azure.
subscriptionId	path	True	string	Identificador único de una suscripción de Microsoft Azure.
transformName	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.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.outputs	True	TransformOutput[]	Una matriz de uno o más elementos TransformOutputs que debe generar la transformación.
properties.description		string	Una descripción detallada opcional de la transformación.

Respuestas

Nombre	Tipo	Description
200 OK	Transform	Aceptar
Other Status Codes	ErrorResponse	Información detallada del error.

Ejemplos

Update a Transform.

Solicitud de ejemplo

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/transformToUpdate?api-version=2022-07-01

{
  "properties": {
    "description": "Example transform to illustrate update.",
    "outputs": [
      {
        "relativePriority": "High",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "H264MultipleBitrate720p"
        }
      }
    ]
  }
}

Java

import com.azure.resourcemanager.mediaservices.models.BuiltInStandardEncoderPreset;
import com.azure.resourcemanager.mediaservices.models.EncoderNamedPreset;
import com.azure.resourcemanager.mediaservices.models.Priority;
import com.azure.resourcemanager.mediaservices.models.Transform;
import com.azure.resourcemanager.mediaservices.models.TransformOutput;
import java.util.Arrays;

/**
 * Samples for Transforms Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-
     * update.json
     */
    /**
     * Sample code: Update a Transform.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void updateATransform(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        Transform resource = manager.transforms()
            .getWithResponse("contosoresources", "contosomedia", "transformToUpdate", com.azure.core.util.Context.NONE)
            .getValue();
        resource.update().withDescription("Example transform to illustrate update.")
            .withOutputs(Arrays.asList(new TransformOutput().withRelativePriority(Priority.HIGH).withPreset(
                new BuiltInStandardEncoderPreset().withPresetName(EncoderNamedPreset.H264MULTIPLE_BITRATE720P))))
            .apply();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.media import AzureMediaServices

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-media
# USAGE
    python transformsupdate.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = AzureMediaServices(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.transforms.update(
        resource_group_name="contosoresources",
        account_name="contosomedia",
        transform_name="transformToUpdate",
        parameters={
            "properties": {
                "description": "Example transform to illustrate update.",
                "outputs": [
                    {
                        "preset": {
                            "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
                            "presetName": "H264MultipleBitrate720p",
                        },
                        "relativePriority": "High",
                    }
                ],
            }
        },
    )
    print(response)


# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-update.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armmediaservices_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/mediaservices/armmediaservices/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/e7bf3adfa2d5e5cdbb804eec35279501794f461c/specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-update.json
func ExampleTransformsClient_Update() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmediaservices.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewTransformsClient().Update(ctx, "contosoresources", "contosomedia", "transformToUpdate", armmediaservices.Transform{
		Properties: &armmediaservices.TransformProperties{
			Description: to.Ptr("Example transform to illustrate update."),
			Outputs: []*armmediaservices.TransformOutput{
				{
					Preset: &armmediaservices.BuiltInStandardEncoderPreset{
						ODataType:  to.Ptr("#Microsoft.Media.BuiltInStandardEncoderPreset"),
						PresetName: to.Ptr(armmediaservices.EncoderNamedPresetH264MultipleBitrate720P),
					},
					RelativePriority: to.Ptr(armmediaservices.PriorityHigh),
				}},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Transform = armmediaservices.Transform{
	// 	Name: to.Ptr("transformToUpdate"),
	// 	Type: to.Ptr("Microsoft.Media/mediaservices/transforms"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/transformToUpdate"),
	// 	Properties: &armmediaservices.TransformProperties{
	// 		Description: to.Ptr("Example transform to illustrate update."),
	// 		Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:32.143Z"); return t}()),
	// 		LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:32.145Z"); return t}()),
	// 		Outputs: []*armmediaservices.TransformOutput{
	// 			{
	// 				OnError: to.Ptr(armmediaservices.OnErrorTypeStopProcessingJob),
	// 				Preset: &armmediaservices.BuiltInStandardEncoderPreset{
	// 					ODataType: to.Ptr("#Microsoft.Media.BuiltInStandardEncoderPreset"),
	// 					PresetName: to.Ptr(armmediaservices.EncoderNamedPresetH264MultipleBitrate720P),
	// 				},
	// 				RelativePriority: to.Ptr(armmediaservices.PriorityHigh),
	// 		}},
	// 	},
	// 	SystemData: &armmediaservices.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:32.143Z"); return t}()),
	// 		CreatedBy: to.Ptr("contoso@microsoft.com"),
	// 		CreatedByType: to.Ptr(armmediaservices.CreatedByTypeUser),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:32.145Z"); return t}()),
	// 		LastModifiedBy: to.Ptr("contoso@microsoft.com"),
	// 		LastModifiedByType: to.Ptr(armmediaservices.CreatedByTypeUser),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { AzureMediaServices } = require("@azure/arm-mediaservices");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates a Transform.
 *
 * @summary Updates a Transform.
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-update.json
 */
async function updateATransform() {
  const subscriptionId =
    process.env["MEDIASERVICES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MEDIASERVICES_RESOURCE_GROUP"] || "contosoresources";
  const accountName = "contosomedia";
  const transformName = "transformToUpdate";
  const parameters = {
    description: "Example transform to illustrate update.",
    outputs: [
      {
        preset: {
          odataType: "#Microsoft.Media.BuiltInStandardEncoderPreset",
          presetName: "H264MultipleBitrate720p",
        },
        relativePriority: "High",
      },
    ],
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const result = await client.transforms.update(
    resourceGroupName,
    accountName,
    transformName,
    parameters
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Media;
using Azure.ResourceManager.Media.Models;

// Generated from example definition: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-update.json
// this example is just showing the usage of "Transforms_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this MediaTransformResource created on azure
// for more information of creating MediaTransformResource, please refer to the document of MediaTransformResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contosoresources";
string accountName = "contosomedia";
string transformName = "transformToUpdate";
ResourceIdentifier mediaTransformResourceId = MediaTransformResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, transformName);
MediaTransformResource mediaTransform = client.GetMediaTransformResource(mediaTransformResourceId);

// invoke the operation
MediaTransformData data = new MediaTransformData()
{
    Description = "Example transform to illustrate update.",
    Outputs =
    {
    new MediaTransformOutput(new BuiltInStandardEncoderPreset(EncoderNamedPreset.H264MultipleBitrate720P))
    {
    RelativePriority = MediaJobPriority.High,
    }
    },
};
MediaTransformResource result = await mediaTransform.UpdateAsync(data);

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MediaTransformData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "name": "transformToUpdate",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/transformToUpdate",
  "type": "Microsoft.Media/mediaservices/transforms",
  "properties": {
    "created": "2022-10-17T23:14:32.1435128Z",
    "description": "Example transform to illustrate update.",
    "lastModified": "2022-10-17T23:14:32.1455494Z",
    "outputs": [
      {
        "onError": "StopProcessingJob",
        "relativePriority": "High",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "H264MultipleBitrate720p"
        }
      }
    ]
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:32.1435128Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:32.1455494Z"
  }
}

Definiciones

Nombre	Description
AacAudio	Describe la configuración avanzada de codificación de audio de códec de audio (AAC).
AacAudioProfile	Perfil de codificación que se va a usar al codificar audio con AAC.
AnalysisResolution	Especifica la resolución máxima en la que se analiza el vídeo. El comportamiento predeterminado es "SourceResolution", que mantendrá el vídeo de entrada en su resolución original cuando se analice. El uso de "StandardDefinition" 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 terminan siendo demasiado pequeñas en el vídeo cambiado.
Audio	Define las propiedades comunes para todos los códecs de audio.
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.
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.
AudioOverlay	Describe las propiedades de una superposición de audio.
BlurType	Tipo de desenfoque
BuiltInStandardEncoderPreset	Describe un valor preestablecido integrado para codificar el vídeo de entrada con el codificador estándar.
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.
CopyAudio	Marca de códec, que indica al codificador que copie la secuencia de bits de audio de entrada.
CopyVideo	Marca de códec, que indica al codificador que copie la secuencia de bits de vídeo de entrada sin volver a codificar.
createdByType	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.
DeinterlaceMode	Modo de desinterlazado. El valor predeterminado es AutoPixelAdaptive.
DeinterlaceParity	La paridad de campo para desenlazar, el valor predeterminado es Auto.
EncoderNamedPreset	Valor preestablecido integrado que se usará para codificar vídeos.
EntropyMode	Modo de entropía que se va a usar para esta capa. Si no se especifica, el codificador elige el modo adecuado para el perfil y el nivel.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
FaceDetectorPreset	Describe toda la configuración que se va a usar al analizar un vídeo con el fin de detectar (y, opcionalmente, redactar) todas las caras presentes.
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) Combinada: además, se detectan caras redactadas (desenfoques). 3) Censurar: esto permite un proceso de 2 pasos, lo que permite una redacció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 la reacción.
Fade	Describe las propiedades de un efecto Fade aplicado al medio de entrada.
Filters	Describe todas las operaciones de filtrado, como la desteroperabilidad, la rotación, etc. que se van a aplicar al medio de entrada antes de la codificación.
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.
H264RateControlMode	Modo de control de velocidad de vídeo
H264Video	Describe todas las propiedades para codificar un vídeo con el códec H.264.
H264VideoProfile	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 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.
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.
H265VideoProfile	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.
ImageFormat	Describe las propiedades de un archivo de imagen de salida.
InsightsType	Define el tipo de información que desea que genere el servicio. Los valores permitidos son "AudioInsightsOnly", "VideoInsightsOnly" y "AllInsights". El valor predeterminado es AllInsights. Si establece esto en AllInsights y la entrada es solo audio, solo se generan conclusiones de audio. Del mismo modo, si la entrada es solo de 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 las entradas sean solo audio. Los trabajos en estas condiciones generarían errores.
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 de solo vídeo en archivos MP4 independientes.
JpgFormat	Describe la configuración para generar miniaturas JPEG.
JpgImage	Describe las propiedades para generar una serie de imágenes JPEG a partir del vídeo de entrada.
JpgLayer	Describe la configuración para generar una imagen JPEG a partir del vídeo de entrada.
Mp4Format	Describe las propiedades de un archivo MP4 ISO de salida.
MultiBitrateFormat	Describe las propiedades para generar una colección de archivos de velocidad de bits múltiple alineados con GOP. El comportamiento predeterminado es generar un archivo de salida para cada capa de vídeo que se muxa junto con todos los audios. Los archivos de salida exactos generados se pueden controlar especificando la colección outputFiles.
OnErrorType	Una transformación puede definir más de una salida. Esta propiedad define lo que debe hacer el servicio cuando se produce un error en una salida, ya sea continuar generando otras salidas o detener las otras salidas. El estado general del trabajo no reflejará los errores de las salidas especificadas con "ContinueJob". El valor predeterminado es "StopProcessingJob".
OutputFile	Representa un archivo de salida generado.
PngFormat	Describe la configuración para generar miniaturas PNG.
PngImage	Describe las propiedades para generar una serie de imágenes PNG a partir del vídeo de entrada.
PngLayer	Describe la configuración para generar una imagen PNG a partir del vídeo de entrada.
PresetConfigurations	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 codificarse. El valor predeterminado es Automático
StandardEncoderPreset	Describe toda la configuración que se va a usar al codificar el vídeo de entrada con el codificador estándar.
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
systemData	Metadatos relacionados con la creación y la última modificación del recurso.
Transform	Una transformación encapsula las reglas o instrucciones para generar salidas deseadas a partir de medios de entrada, como transcodificación o mediante la extracción de información. Una vez creada la transformación, se puede aplicar a los medios de entrada mediante la creación de trabajos.
TransformOutput	Describe las propiedades de transformOutput, que son las reglas que se van a aplicar al generar la salida deseada.
TransportStreamFormat	Describe las propiedades para generar archivos de vídeo de salida MPEG-2 (ISO/IEC 13818-1).
Video	Describe las propiedades básicas para codificar el vídeo de entrada.
VideoAnalyzerPreset	Un valor preestablecido del analizador de vídeo que extrae información (metadatos enriquecidos) de audio y vídeo, y genera un archivo de formato JSON.
VideoOverlay	Describe las propiedades de una superposición de vídeo.
VideoSyncMode	Modo de sincronización de vídeo

AacAudio

Describe la configuración avanzada de codificación de audio de códec de audio (AAC).

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Media.AacAudio	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 la muxación.
profile	AacAudioProfile	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.

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 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 terminan siendo demasiado pequeñas en el vídeo cambiado.

Nombre	Tipo	Description
SourceResolution	string
StandardDefinition	string

Audio

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

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Media.Audio	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.Media.AudioAnalyzerPreset	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	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.

AudioOverlay

Describe las propiedades de una superposición de audio.

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Media.AudioOverlay	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, donde finaliza la superposición. El valor debe estar en formato ISO 8601. Por ejemplo, PT30S para finalizar la superposición en 30 segundos en el vídeo de entrada. Si no se especifica o el valor es mayor que la duración del vídeo de entrada, la superposición se aplicará hasta el final del vídeo de entrada si la duración del medio de superposición es mayor que la duración del vídeo de entrada, de lo contrario, la superposición durará mientras dure el medio de superposición.
fadeInDuration	string	Duración en la que la superposición se atenua en el vídeo de entrada. El valor debe estar en formato de duración ISO 8601. Si no se especifica, el comportamiento predeterminado es no tener ninguna atenuación (igual que PT0S).
fadeOutDuration	string	La duración en la que la superposición desaparece del vídeo de entrada. El valor debe estar en formato de duración ISO 8601. Si no se especifica, el comportamiento predeterminado es no tener ninguna atenuación (igual que PT0S).
inputLabel	string	Etiqueta de la entrada del trabajo que se va a usar como superposición. La entrada debe especificar exactamente un archivo. Puede especificar un archivo de imagen en formato JPG, PNG, GIF o BMP, un archivo de audio (por ejemplo, un archivo WAV, MP3, WMA o M4A) o un archivo de vídeo. Consulte https://aka.ms/mesformats para obtener la lista completa de 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, la superposición comienza desde el principio del vídeo de entrada.

BlurType

Tipo de desenfoque

Nombre	Tipo	Description
Black	string	Negro: Filtro de salida negro
Box	string	Box: filtro de depuración, solo rectángulo de selección
High	string	Alta: Confundir filtro de desenfoque
Low	string	Bajo: filtro de desenfoque de coche de caja
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.Media.BuiltInStandardEncoderPreset	Discriminador de tipos derivados.
configurations	PresetConfigurations	Opciones de configuración opcionales para el codificador. Las configuraciones solo se admiten para ContentAwareEncoding y H265ContentAwareEncoding BuiltInStandardEncoderPreset.
presetName	EncoderNamedPreset	Valor preestablecido integrado que se va a usar para codificar vídeos.

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 las opciones optimizadas 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.Media.CopyAudio	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.Media.CopyVideo	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.Media.DDAudio	Discriminador de tipos derivados.
bitrate	integer	Velocidad de bits, en bits por segundo, del audio codificado en la 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 la muxació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	DeinterlaceMode	Modo de desinterlazado. El valor predeterminado es AutoPixelAdaptive.
parity	DeinterlaceParity	La paridad de campo para desenlazar, el valor predeterminado es Auto.

DeinterlaceMode

Modo de desinterlazado. El valor predeterminado es AutoPixelAdaptive.

Nombre	Tipo	Description
AutoPixelAdaptive	string	Aplique el desacolamiento adaptable de píxeles automático en cada fotograma del vídeo de entrada.
Off	string	Deshabilita la desteroperabilidad del vídeo de origen.

DeinterlaceParity

La paridad de campo para desenlazar, 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	Aplicar el primer procesamiento de campo superior del vídeo de entrada.

EncoderNamedPreset

Valor preestablecido integrado que se 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 solo contiene audio estéreo DD(Digital Dolby) codificado en 192 kbps.
H264MultipleBitrate1080p	string	Genera un conjunto de 8 archivos MP4 alineados con GOP, que van desde 6000 kbps hasta 400 kbps y audio AAC estéreo. La resolución comienza en 1080p y baja a 180p.
H264MultipleBitrate720p	string	Genera un conjunto de 6 archivos MP4 alineados con GOP, que van desde 3400 kbps a 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 se codifica 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 se codifica 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 se codifica 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 se codifica 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 se codifica 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 se codifica 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	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

FaceDetectorPreset

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

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Media.FaceDetectorPreset	Discriminador de tipos derivados.
blurType	BlurType	Tipo de desenfoque
experimentalOptions	object	Diccionario que contiene pares clave-valor para parámetros no expuestos en el propio valor preestablecido
mode	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.
resolution	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.

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) Combinada: además, se detectan caras redactadas (desenfoques). 3) Censurar: esto permite un proceso de 2 pasos, lo que permite una redacció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 la reacción.

Nombre	Tipo	Description
Analyze	string	El modo de análisis detecta caras y genera un archivo de metadatos con los resultados. Permite editar el archivo de metadatos antes de que las caras se desenfoquen con el modo Redact.
Combined	string	El modo combinado realiza los pasos Analizar y Redactar en un paso cuando no se desea editar las caras analizadas.
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 la desteroperabilidad, la rotación, etc. que se van a aplicar al medio de entrada antes de la codificación.

Nombre	Tipo	Description
crop	Rectangle	Parámetros de la ventana rectangular con la que se va a recortar el vídeo de entrada.
deinterlace	Deinterlace	Configuración de desconlazamiento.
fadeIn	Fade	Describe las propiedades de un efecto Fade aplicado al medio de entrada.
fadeOut	Fade	Describe las propiedades de un efecto Fade aplicado al medio de entrada.
overlays	Overlay[]: AudioOverlay[] VideoOverlay[]	Propiedades de superposiciones que se van a aplicar al vídeo de entrada. Pueden ser superposiciones de audio, imagen o vídeo.
rotation	Rotation	Rotación, si existe, que se va a aplicar al vídeo de entrada, antes de codificarse. El valor predeterminado es Automático

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	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	H264VideoProfile	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.Media.H264Video	Discriminador de tipos derivados.
complexity	H264Complexity	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	H264Layer[]	Colección de capas H.264 de salida que va a generar el codificador.
rateControlMode	H264RateControlMode	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	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	VideoSyncMode	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 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.

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.

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	H265VideoProfile	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.Media.H265Video	Discriminador de tipos derivados.
complexity	H265Complexity	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	H265Layer[]	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	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	VideoSyncMode	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.Media.Image	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	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	VideoSyncMode	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.Media.ImageFormat	Discriminador de tipos derivados.
filenamePattern	string	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: {Nombre Base}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {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 y vídeo en kbps. No es aplicable a las miniaturas. {Codec}: tipo del códec de audio/vídeo. {Resolution} - La resolución de vídeo. Todas las macros no heredadas se contraerán y se quitarán del nombre de archivo.

InsightsType

Define el tipo de información que desea que genere el servicio. Los valores permitidos son "AudioInsightsOnly", "VideoInsightsOnly" y "AllInsights". El valor predeterminado es AllInsights. Si establece esto en AllInsights y la entrada es solo audio, solo se generan conclusiones de audio. Del mismo modo, si la entrada es solo de 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 las entradas sean solo audio. Los trabajos en estas condiciones generarían errores.

Nombre	Tipo	Description
AllInsights	string	Genere tanto información de audio como de vídeo. Se produce un error si se produce un error en Insights de audio o vídeo.
AudioInsightsOnly	string	Genere solo información de audio. Omita el vídeo incluso si está presente. Se produce un error si no hay ningún audio presente.
VideoInsightsOnly	string	Genere solo información 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 de 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 de vídeo o solo audio.

JpgFormat

Describe la configuración para generar miniaturas JPEG.

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Media.JpgFormat	Discriminador de tipos derivados.
filenamePattern	string	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: {Nombre Base}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {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 y vídeo en kbps. No es aplicable a las miniaturas. {Codec}: tipo del códec de audio/vídeo. {Resolution} - La resolución de vídeo. Todas las macros no heredadas 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.Media.JpgImage	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	JpgLayer[]	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	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	VideoSyncMode	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.Media.Mp4Format	Discriminador de tipos derivados.
filenamePattern	string	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: {Nombre Base}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {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 y vídeo en kbps. No es aplicable a las miniaturas. {Codec}: tipo del códec de audio/vídeo. {Resolution} - La resolución de vídeo. Todas las macros no heredadas se contraerán y se quitarán del nombre de archivo.
outputFiles	OutputFile[]	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 muxar 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.Media.MultiBitrateFormat	Discriminador de tipos derivados.
filenamePattern	string	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: {Nombre Base}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {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 y vídeo en kbps. No es aplicable a las miniaturas. {Codec}: tipo del códec de audio/vídeo. {Resolution} - La resolución de vídeo. Todas las macros no heredadas se contraerán y se quitarán del nombre de archivo.
outputFiles	OutputFile[]	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 muxar juntas.

OnErrorType

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

Nombre	Tipo	Description
ContinueJob	string	Indica al servicio que si se produce un error en transformOutput, permita que continúe cualquier otro objeto TransformOutput.
StopProcessingJob	string	Indica al servicio que si se produce un error en transformOutput, se puede detener cualquier otro transformOutput incompleto.

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.Media.PngFormat	Discriminador de tipos derivados.
filenamePattern	string	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.Media.PngImage	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	PngLayer[]	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	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	VideoSyncMode	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 el nombre 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	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	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 de 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 en 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 en 4 para asegurarse de que se producen 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 abarque 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 las 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 codificarse. 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.

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.Media.StandardEncoderPreset	Discriminador de tipos derivados.
codecs	Codec[]: AacAudio[] Audio[] CopyAudio[] CopyVideo[] DDAudio[] H264Video[] H265Video[] Image[] JpgImage[] PngImage[] Video[]	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	Filters	Una o varias operaciones de filtrado que se aplican al medio de entrada antes de la codificación.
formats	Format[]: ImageFormat[] JpgFormat[] Mp4Format[] MultiBitrateFormat[] PngFormat[] TransportStreamFormat[]	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 el cuadro de letras o el cuadro de pilar) para respetar la resolución de salida, a la vez 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 será de 1280 x 1280, que contiene un rectángulo interno de 1280x720 en relación de aspecto de 16:9 y las regiones del cuadro de pilar 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	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	createdByType	Tipo de identidad que modificó por última vez el recurso.

Transform

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

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.created	string	La fecha y hora UTC cuando se creó la transformación, en formato "AAAA-MM-DDThh:mm:ssZ".
properties.description	string	Una descripción detallada opcional de la transformación.
properties.lastModified	string	La fecha y hora UTC cuando se actualizó la transformación por última vez, en formato "AAAA-MM-DDThh:mm:ssZ".
properties.outputs	TransformOutput[]	Una matriz de uno o más elementos TransformOutputs que debe generar la transformación.
systemData	systemData	Metadatos del sistema relacionados con este recurso.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TransformOutput

Describe las propiedades de transformOutput, que son las reglas que se van a aplicar al generar la salida deseada.

Nombre	Tipo	Description
onError	OnErrorType	Una transformación puede definir más de una salida. Esta propiedad define lo que debe hacer el servicio cuando se produce un error en una salida, ya sea continuar generando otras salidas o detener las otras salidas. El estado general del trabajo no reflejará los errores de las salidas especificadas con "ContinueJob". El valor predeterminado es "StopProcessingJob".
preset	Preset: AudioAnalyzerPreset BuiltInStandardEncoderPreset FaceDetectorPreset StandardEncoderPreset VideoAnalyzerPreset	Valor preestablecido que describe las operaciones que se usarán para modificar, transcodificar o extraer información del archivo de origen para generar la salida.
relativePriority	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.

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.Media.TransportStreamFormat	Discriminador de tipos derivados.
filenamePattern	string	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: {Nombre Base}: una macro de expansión que usará el nombre del archivo de vídeo de entrada. Si el nombre base (el sufijo de archivo no está incluido) del archivo de vídeo de entrada tiene menos de 32 caracteres, se usará el nombre base de los archivos de vídeo de entrada. Si la longitud del nombre base del archivo de vídeo de entrada supera los 32 caracteres, el nombre base se trunca a los primeros 32 caracteres de longitud total. {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 y vídeo en kbps. No es aplicable a las miniaturas. {Codec}: tipo del códec de audio/vídeo. {Resolution} - La resolución de vídeo. Todas las macros no heredadas se contraerán y se quitarán del nombre de archivo.
outputFiles	OutputFile[]	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 muxar juntas.

Video

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

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Media.Video	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	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	VideoSyncMode	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.Media.VideoAnalyzerPreset	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 se reservaría en "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	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.
mode	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.

VideoOverlay

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

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Media.VideoOverlay	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	Rectangle	Ventana rectangular opcional que se usa para recortar la imagen o el vídeo de superposición.
end	string	Posición final, con referencia al vídeo de entrada, donde finaliza la superposición. El valor debe estar en formato ISO 8601. Por ejemplo, PT30S para finalizar la superposición en 30 segundos en el vídeo de entrada. Si no se especifica o el valor es mayor que la duración del vídeo de entrada, la superposición se aplicará hasta el final del vídeo de entrada si la duración del medio de superposición es mayor que la duración del vídeo de entrada, de lo contrario, la superposición durará mientras dure el medio de superposición.
fadeInDuration	string	Duración en la que la superposición se atenua en el vídeo de entrada. El valor debe estar en formato de duración ISO 8601. Si no se especifica, el comportamiento predeterminado es no tener ninguna atenuación (igual que PT0S).
fadeOutDuration	string	La duración en la que la superposición desaparece del vídeo de entrada. El valor debe estar en formato de duración ISO 8601. Si no se especifica, el comportamiento predeterminado es no tener ninguna atenuación (igual que PT0S).
inputLabel	string	Etiqueta de la entrada del trabajo que se va a usar como superposición. La entrada debe especificar exactamente un archivo. Puede especificar un archivo de imagen en formato JPG, PNG, GIF o BMP, un archivo de audio (por ejemplo, un archivo WAV, MP3, WMA o M4A) o un archivo de vídeo. Consulte https://aka.ms/mesformats para obtener la lista completa de 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	Rectangle	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, la superposición comienza 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 capacidades del muxer. Para el formato de salida MP4, el modo predeterminado es Cfr.
Cfr	string	Los fotogramas de entrada se repetirán o 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 los fotogramas se pasan desde el archivo de entrada al escritor de archivos de salida. Se recomienda cuando el origen de entrada tiene velocidad de fotogramas variable y está intentando generar varias capas para el streaming adaptable en la salida que tienen límites 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.