Transforms - Create Or Update

Service:

Media Services

API Version:

2022-07-01

Creare o aggiornare la trasformazione
Crea o aggiorna una nuova trasformazione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account di Servizi multimediali.
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione di Azure.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure.
transformName	path	True	string	Nome trasformazione.
api-version	query	True	string	Versione dell'API da usare con la richiesta client.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.outputs	True	TransformOutput[]	Matrice di una o più proprietà TransformOutputs che l'oggetto Transform deve generare.
properties.description		string	Descrizione dettagliata facoltativa dell'oggetto Transform.

Risposte

Nome	Tipo	Descrizione
200 OK	Transform	OK
201 Created	Transform	Data di creazione
Other Status Codes	ErrorResponse	Informazioni dettagliate sull'errore.

Esempio

Create or update a Transform

Sample Request

HTTP

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

{
  "properties": {
    "description": "Example Transform to illustrate create and update.",
    "outputs": [
      {
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  }
}

Java

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

/** Samples for Transforms CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-create.json
     */
    /**
     * Sample code: Create or update a Transform.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createOrUpdateATransform(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .transforms()
            .define("createdTransform")
            .withExistingMediaService("contosoresources", "contosomedia")
            .withDescription("Example Transform to illustrate create and update.")
            .withOutputs(
                Arrays
                    .asList(
                        new TransformOutput()
                            .withPreset(
                                new BuiltInStandardEncoderPreset()
                                    .withPresetName(EncoderNamedPreset.ADAPTIVE_STREAMING))))
            .create();
    }
}

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 transformscreate.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.create_or_update(
        resource_group_name="contosoresources",
        account_name="contosomedia",
        transform_name="createdTransform",
        parameters={
            "properties": {
                "description": "Example Transform to illustrate create and update.",
                "outputs": [
                    {
                        "preset": {
                            "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
                            "presetName": "AdaptiveStreaming",
                        }
                    }
                ],
            }
        },
    )
    print(response)


# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-create.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-create.json
func ExampleTransformsClient_CreateOrUpdate() {
	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().CreateOrUpdate(ctx, "contosoresources", "contosomedia", "createdTransform", armmediaservices.Transform{
		Properties: &armmediaservices.TransformProperties{
			Description: to.Ptr("Example Transform to illustrate create and update."),
			Outputs: []*armmediaservices.TransformOutput{
				{
					Preset: &armmediaservices.BuiltInStandardEncoderPreset{
						ODataType:  to.Ptr("#Microsoft.Media.BuiltInStandardEncoderPreset"),
						PresetName: to.Ptr(armmediaservices.EncoderNamedPresetAdaptiveStreaming),
					},
				}},
		},
	}, 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("createdTransform"),
	// 	Type: to.Ptr("Microsoft.Media/mediaservices/transforms"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform"),
	// 	Properties: &armmediaservices.TransformProperties{
	// 		Description: to.Ptr("Example Transform to illustrate create and update."),
	// 		Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:31.766Z"); return t}()),
	// 		LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:31.766Z"); return t}()),
	// 		Outputs: []*armmediaservices.TransformOutput{
	// 			{
	// 				OnError: to.Ptr(armmediaservices.OnErrorTypeStopProcessingJob),
	// 				Preset: &armmediaservices.BuiltInStandardEncoderPreset{
	// 					ODataType: to.Ptr("#Microsoft.Media.BuiltInStandardEncoderPreset"),
	// 					PresetName: to.Ptr(armmediaservices.EncoderNamedPresetAdaptiveStreaming),
	// 				},
	// 				RelativePriority: to.Ptr(armmediaservices.PriorityNormal),
	// 		}},
	// 	},
	// 	SystemData: &armmediaservices.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:31.766Z"); 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:31.766Z"); 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 Creates or updates a new Transform.
 *
 * @summary Creates or updates a new Transform.
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-create.json
 */
async function createOrUpdateATransform() {
  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 = "createdTransform";
  const parameters = {
    description: "Example Transform to illustrate create and update.",
    outputs: [
      {
        preset: {
          odataType: "#Microsoft.Media.BuiltInStandardEncoderPreset",
          presetName: "AdaptiveStreaming",
        },
      },
    ],
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const result = await client.transforms.createOrUpdate(
    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-create.json
// this example is just showing the usage of "Transforms_CreateOrUpdate" 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 MediaServicesAccountResource created on azure
// for more information of creating MediaServicesAccountResource, please refer to the document of MediaServicesAccountResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contosoresources";
string accountName = "contosomedia";
ResourceIdentifier mediaServicesAccountResourceId = MediaServicesAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
MediaServicesAccountResource mediaServicesAccount = client.GetMediaServicesAccountResource(mediaServicesAccountResourceId);

// get the collection of this MediaTransformResource
MediaTransformCollection collection = mediaServicesAccount.GetMediaTransforms();

// invoke the operation
string transformName = "createdTransform";
MediaTransformData data = new MediaTransformData()
{
    Description = "Example Transform to illustrate create and update.",
    Outputs =
    {
    new MediaTransformOutput(new BuiltInStandardEncoderPreset(EncoderNamedPreset.AdaptiveStreaming))
    },
};
ArmOperation<MediaTransformResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, transformName, data);
MediaTransformResource result = lro.Value;

// 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

Sample Response

Status code:

201

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

Status code:

200

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

Definizioni

Nome	Descrizione
AacAudio	Vengono descritte le impostazioni di codifica audio AAC (Advanced Audio Codec).
AacAudioProfile	Profilo di codifica da usare per la codifica dell'audio con AAC.
AnalysisResolution	Specifica la risoluzione massima in corrispondenza della quale viene analizzato il video. Il comportamento predefinito è "SourceResolution", che manterrà il video di input alla risoluzione originale durante l'analisi. L'uso di "StandardDefinition" ridimensiona i video di input alla definizione standard mantenendo le proporzioni appropriate. Verrà ridimensionato solo se il video è di risoluzione superiore. Ad esempio, un input 1920x1080 viene ridimensionato a 640x360 prima dell'elaborazione. Il passaggio a "StandardDefinition" ridurrà il tempo necessario per elaborare video ad alta risoluzione. Può anche ridurre il costo dell'uso di questo componente (vedere per informazioni https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics dettagliate). Tuttavia, i visi che finiscono per essere troppo piccoli nel video ridimensionato potrebbero non essere rilevati.
Audio	Definisce le proprietà comuni per tutti i codec audio.
AudioAnalysisMode	Determina il set di operazioni di analisi audio da eseguire. Se non specificato, verrà scelto AudioAnalysisMode standard.
AudioAnalyzerPreset	Il set di impostazioni di Audio Analyzer applica un set predefinito di operazioni di analisi basate sull'intelligenza artificiale, inclusa la trascrizione vocale. Attualmente il set di impostazioni supporta l'elaborazione del contenuto con una singola traccia audio.
AudioOverlay	Descrive le proprietà di una sovrapposizione audio.
BlurType	Tipo di sfocatura
BuiltInStandardEncoderPreset	Descrive un set di impostazioni predefinite per codificare il video di input con il codificatore Standard.
Complexity	Consente di configurare le impostazioni del codificatore per controllare l'equilibrio tra velocità e qualità. Esempio: impostare Complessità come velocità per la codifica più veloce, ma meno efficienza di compressione.
CopyAudio	Flag codec, che indica al codificatore di copiare il bitstream audio di input.
CopyVideo	Flag codec, che indica al codificatore di copiare il bitstream video di input senza codificare nuovamente.
createdByType	Tipo di identità che ha creato la risorsa.
DDAudio	Descrive le impostazioni di codifica audio Dolby Digital Audio Codec (AC3). L'implementazione corrente per il supporto di Dolby Digital Audio è: Numeri di canale audio a 1(mono), 2(stereo), 6(5.1side); Frequenza di campionamento audio a: 32K/44,1K/48 K Hz; I valori di velocità in bit audio come specifica AC3 supportano: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 64000 bps.
Deinterlace	Descrive le impostazioni di de-interlacing.
DeinterlaceMode	Modalità di deinterlacing. Impostazione predefinita su AutoPixelAdaptive.
DeinterlaceParity	La parità di campo per la de-interlacing, impostazione predefinita su Auto.
EncoderNamedPreset	Set di impostazioni predefinito da usare per la codifica dei video.
EntropyMode	Modalità entropia da usare per questo livello. Se non specificato, il codificatore sceglie la modalità appropriata per il profilo e il livello.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
FaceDetectorPreset	Descrive tutte le impostazioni da usare durante l'analisi di un video per rilevare (e facoltativamente ridistribuire) tutti i visi presenti.
FaceRedactorMode	Questa modalità consente di scegliere tra le impostazioni seguenti: 1) Analizza - Solo per il rilevamento. Questa modalità genera un file JSON di metadati che contrassegna gli aspetti dei visi in tutto il video. Laddove possibile, agli aspetti della stessa persona viene assegnato lo stesso ID. 2) Combinato- Inoltre, vengono rilevati visi con sfocatura.Where possible, appearances of the same person are assigned the same ID. 2) Combined - Additionally redacts(blurs) detected faces. 3) Redact : consente un processo a 2 passaggi, consentendo la ridistribuzione selettiva di un sottoinsieme di visi rilevati. Accetta il file di metadati da un passaggio di analisi precedente, insieme al video di origine e un sottoinsieme di ID selezionati dall'utente che richiedono la ridistribuzione.
Fade	Descrive le proprietà di un effetto Fade applicato al supporto di input.
Filters	Descrive tutte le operazioni di filtro, ad esempio de-interlacciamento, rotazione e così via, da applicare al supporto di input prima della codifica.
H264Complexity	Indica al codificatore come scegliere le impostazioni di codifica. Il valore predefinito è Bilanciato.
H264Layer	Descrive le impostazioni da usare durante la codifica del video di input in un livello di velocità in bit di output desiderato con il codec video H.264.
H264RateControlMode	Modalità di controllo della frequenza video
H264Video	Descrive tutte le proprietà per la codifica di un video con il codec H.264.
H264VideoProfile	Attualmente sono supportati Baseline, Main, High, High422, High444. Il valore predefinito è Auto.
H265Complexity	Indica al codificatore come scegliere le impostazioni di codifica. La qualità fornirà un rapporto di compressione più elevato, ma a costi più elevati e tempo di calcolo più lungo. La velocità produrrà un file relativamente più grande, ma è più veloce e più economico. Il valore predefinito è Bilanciato.
H265Layer	Descrive le impostazioni da usare quando si codifica il video di input in un livello di velocità di bit di output desiderato con il codec video H.265.
H265Video	Descrive tutte le proprietà per la codifica di un video con il codec H.265.
H265VideoProfile	Attualmente supportiamo Main. Il valore predefinito è Auto.
Image	Descrive le proprietà di base per la generazione di anteprime dal video di input
ImageFormat	Descrive le proprietà di un file di immagine di output.
InsightsType	Definisce il tipo di informazioni dettagliate che si desidera generare il servizio. I valori consentiti sono "AudioInsightsOnly", "VideoInsightsOnly" e "AllInsights". Il valore predefinito è AllInsights. Se si imposta questa opzione su AllInsights e l'input è solo audio, vengono generate solo informazioni audio. Analogamente, se l'input è solo video, vengono generate solo informazioni video. È consigliabile non usare AudioInsightsOnly se si prevede che alcuni degli input siano solo video; o usare VideoInsightsOnly se si prevede che alcuni degli input siano solo audio. I processi in tali condizioni potrebbero essere eseguiti errori.
InterleaveOutput	Imposta la modalità interleave dell'output per controllare la modalità di archiviazione dell'audio e del video nel formato contenitore. Esempio: impostare InterleavedOutput come NonInterleavedOutput per produrre output solo audio e video in file MP4 separati.
JpgFormat	Descrive le impostazioni per la produzione di anteprime JPEG.
JpgImage	Descrive le proprietà per la produzione di una serie di immagini JPEG dal video di input.
JpgLayer	Descrive le impostazioni per produrre un'immagine JPEG dal video di input.
Mp4Format	Descrive le proprietà per un file ISO MP4 di output.
MultiBitrateFormat	Vengono descritte le proprietà per la produzione di una raccolta di file a bitrate multipli allineati a GOP. Il comportamento predefinito consiste nel produrre un file di output per ogni livello video che viene disattivato insieme a tutti gli audio. I file di output esatti prodotti possono essere controllati specificando l'insieme outputFiles.
OnErrorType	Una trasformazione può definire più di un output. Questa proprietà definisce le operazioni che il servizio deve eseguire quando un output ha esito negativo: continuare a produrre altri output o arrestare gli altri output. Lo stato complessivo del processo non riflette gli errori di output specificati con 'ContinueJob'. Il valore predefinito è "StopProcessingJob".
OutputFile	Rappresenta un file di output prodotto.
PngFormat	Descrive le impostazioni per la produzione di anteprime PNG.
PngImage	Descrive le proprietà per la produzione di una serie di immagini PNG dal video di input.
PngLayer	Descrive le impostazioni per produrre un'immagine PNG dal video di input.
PresetConfigurations	Oggetto delle impostazioni di configurazione facoltative per il codificatore.
Priority	Imposta la priorità relativa dei TransformOutputs all'interno di una trasformazione. In questo modo viene impostata la priorità usata dal servizio per l'elaborazione di TransformOutputs. La priorità predefinita è Normale.
Rectangle	Descrive le proprietà di una finestra rettangolare applicata ai supporti di input prima di elaborarla.
Rotation	La rotazione, se presente, da applicare al video di input, prima che venga codificata. Il valore predefinito è Auto
StandardEncoderPreset	Descrive tutte le impostazioni da usare durante la codifica del video di input con il codificatore Standard.
StretchMode	Modalità di ridimensionamento: come verrà ridimensionato il video di input per adattare le risoluzioni di output desiderate. Il valore predefinito è AutoSize
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
Transform	Un oggetto Transform incapsula le regole o le istruzioni per la generazione di output desiderati da supporti di input, ad esempio tramite la transcodatura o l'estrazione di informazioni dettagliate. Dopo aver creato la trasformazione, può essere applicata ai supporti di input creando processi.
TransformOutput	Descrive le proprietà di un oggetto TransformOutput, che sono le regole da applicare durante la generazione dell'output desiderato.
TransportStreamFormat	Descrive le proprietà per la generazione di file video di output MPEG-2 Transport Stream (ISO/IEC 13818-1).
Video	Descrive le proprietà di base per la codifica del video di input.
VideoAnalyzerPreset	Set di impostazioni di analizzatore video che estrae informazioni dettagliate (metadati avanzati) sia dall'audio che dal video e restituisce un file di formato JSON.
VideoOverlay	Descrive le proprietà di una sovrapposizione video.
VideoSyncMode	Modalità di sincronizzazione video

AacAudio

Vengono descritte le impostazioni di codifica audio AAC (Advanced Audio Codec).

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.AacAudio	Il discriminatorio per i tipi derivati.
bitrate	integer	Velocità in bit, in bit al secondo, dell'audio con codifica di output.
channels	integer	Numero di canali nell'audio.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di multiplexing.
profile	AacAudioProfile	Profilo di codifica da usare per la codifica dell'audio con AAC.
samplingRate	integer	Frequenza di campionamento da utilizzare per la codifica inhz.

AacAudioProfile

Profilo di codifica da usare per la codifica dell'audio con AAC.

Nome	Tipo	Descrizione
AacLc	string	Specifica che l'audio di output deve essere codificato nel profilo AAC Low Complexity (AAC-LC).
HeAacV1	string	Specifica che l'audio di output deve essere codificato nel profilo HE-AAC v1.
HeAacV2	string	Specifica che l'audio di output deve essere codificato nel profilo HE-AAC v2.

AnalysisResolution

Specifica la risoluzione massima in corrispondenza della quale viene analizzato il video. Il comportamento predefinito è "SourceResolution", che manterrà il video di input alla risoluzione originale durante l'analisi. L'uso di "StandardDefinition" ridimensiona i video di input alla definizione standard mantenendo le proporzioni appropriate. Verrà ridimensionato solo se il video è di risoluzione superiore. Ad esempio, un input 1920x1080 viene ridimensionato a 640x360 prima dell'elaborazione. Il passaggio a "StandardDefinition" ridurrà il tempo necessario per elaborare video ad alta risoluzione. Può anche ridurre il costo dell'uso di questo componente (vedere per informazioni https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics dettagliate). Tuttavia, i visi che finiscono per essere troppo piccoli nel video ridimensionato potrebbero non essere rilevati.

Nome	Tipo	Descrizione
SourceResolution	string
StandardDefinition	string

Audio

Definisce le proprietà comuni per tutti i codec audio.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.Audio	Discriminazione per i tipi derivati.
bitrate	integer	Velocità in bit, in bit al secondo, dell'audio codificato dall'output.
channels	integer	Numero di canali nell'audio.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di muxing.
samplingRate	integer	Frequenza di campionamento da usare per la codifica in hertz.

AudioAnalysisMode

Determina il set di operazioni di analisi audio da eseguire. Se non specificato, verrà scelto AudioAnalysisMode standard.

Nome	Tipo	Descrizione
Basic	string	Questa modalità esegue la trascrizione vocale e la generazione di un sottotitolo/didascalia VTT. L'output di questa modalità include un file JSON insights che include solo le parole chiave, la trascrizione e le informazioni sulla tempistica. Il rilevamento automatico della lingua e la diarizzazione del parlante non sono inclusi in questa modalità.
Standard	string	Esegue tutte le operazioni incluse nella modalità Basic, eseguendo anche il rilevamento della lingua e la diarizzazione del parlante.

AudioAnalyzerPreset

Il set di impostazioni di Audio Analyzer applica un set predefinito di operazioni di analisi basate sull'intelligenza artificiale, inclusa la trascrizione vocale. Attualmente il set di impostazioni supporta l'elaborazione del contenuto con una singola traccia audio.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.AudioAnalyzerPreset	Discriminazione per i tipi derivati.
audioLanguage	string	Lingua per il payload audio nell'input usando il formato BCP-47 di 'language tag-region' (ad esempio"en-US"). Se si conosce la lingua del contenuto, è consigliabile specificarla. La lingua deve essere specificata in modo esplicito per AudioAnalysisMode::Basic, poiché il rilevamento automatico della lingua non è incluso in modalità di base. Se la lingua non è specificata o impostata su Null, il rilevamento automatico della lingua sceglierà la prima lingua rilevata e utilizzerà la lingua selezionata per la durata del file. Attualmente non supporta il passaggio dinamico tra lingue dopo il rilevamento della prima lingua. Il rilevamento automatico funziona meglio con registrazioni audio con voce chiaramente riconoscibile. Se il rilevamento automatico non riesce a trovare la lingua, la trascrizione avrà il fallback in "en-US". L'elenco delle lingue supportate è disponibile qui: https://go.microsoft.com/fwlink/?linkid=2109463
experimentalOptions	object	Dizionario contenente coppie di valori chiave per i parametri non esposti nel set di impostazioni stesso
mode	AudioAnalysisMode	Determina il set di operazioni di analisi audio da eseguire. Se non specificato, verrà scelto AudioAnalysisMode Standard.

AudioOverlay

Descrive le proprietà di una sovrapposizione audio.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.AudioOverlay	Discriminazione per i tipi derivati.
audioGainLevel	number	Livello di aumento dell'audio nella sovrapposizione. Il valore deve trovarsi nell'intervallo [0, 1.0]. Il valore predefinito è 1.0.
end	string	Posizione finale, con riferimento al video di input, in corrispondenza del quale termina la sovrapposizione. Il valore deve essere in formato ISO 8601. Ad esempio, PT30S per terminare la sovrapposizione a 30 secondi nel video di input. Se non è specificato o il valore è maggiore della durata del video di input, la sovrapposizione verrà applicata fino alla fine del video di input se la durata del supporto di sovrapposizione è maggiore della durata del video di input, altrimenti la sovrapposizione durerà fino alla durata del supporto di sovrapposizione.
fadeInDuration	string	Durata in cui la sovrapposizione si dissolve nel video di input. Il valore deve essere in formato di durata ISO 8601. Se non è specificato il comportamento predefinito, il comportamento predefinito non deve essere predefinito (uguale a PT0S).
fadeOutDuration	string	Durata in cui la sovrapposizione si dissolve dal video di input. Il valore deve essere in formato di durata ISO 8601. Se non è specificato il comportamento predefinito, non deve essere disattivato (uguale a PT0S).
inputLabel	string	Etichetta dell'input del processo da usare come sovrimpressione. L'input deve specificare esattamente un file. È possibile specificare un file di immagine in formato JPG, PNG, GIF o BMP o un file audio (ad esempio un file WAV, MP3, WMA o M4A) o un file video. Per l'elenco completo dei formati di file audio e video supportati, vedere https://aka.ms/mesformats l'elenco completo dei formati di file audio e video supportati.
start	string	Posizione iniziale, con riferimento al video di input, in corrispondenza del quale viene avviata la sovrapposizione. Il valore deve essere in formato ISO 8601. Ad esempio, PT05S per avviare la sovrapposizione a 5 secondi nel video di input. Se non specificato, la sovrapposizione inizia dall'inizio del video di input.

BlurType

Tipo di sfocatura

Nome	Tipo	Descrizione
Black	string	Nero: filtro nero
Box	string	Box: filtro di debug, solo rettangolo di selezione
High	string	Alta: confondere il filtro sfocatura
Low	string	Basso: filtro sfocatura box-car
Med	string	Med: filtro sfocatura gaussiano

BuiltInStandardEncoderPreset

Descrive un set di impostazioni predefinite per codificare il video di input con il codificatore Standard.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.BuiltInStandardEncoderPreset	Discriminazione per i tipi derivati.
configurations	PresetConfigurations	Impostazioni di configurazione facoltative per il codificatore. Le configurazioni sono supportate solo per ContentAwareEncoding e H265ContentAwareEncoding BuiltInStandardEncoderPreset.
presetName	EncoderNamedPreset	Set di impostazioni predefinite da usare per la codifica dei video.

Complexity

Consente di configurare le impostazioni del codificatore per controllare l'equilibrio tra velocità e qualità. Esempio: impostare Complessità come velocità per la codifica più veloce, ma meno efficienza di compressione.

Nome	Tipo	Descrizione
Balanced	string	Configura il codificatore per l'uso delle impostazioni che consentono di bilanciare la velocità e la qualità.
Quality	string	Configura il codificatore per usare le impostazioni ottimizzate per produrre un output di qualità superiore a spese del tempo di codifica complessivo più lento.
Speed	string	Configura il codificatore per usare le impostazioni ottimizzate per la codifica più veloce. La qualità viene sacrificata per ridurre il tempo di codifica.

CopyAudio

Flag codec, che indica al codificatore di copiare il bitstream audio di input.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.CopyAudio	Discriminazione per i tipi derivati.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di muxing.

CopyVideo

Flag codec, che indica al codificatore di copiare il bitstream video di input senza codificare nuovamente.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.CopyVideo	Discriminazione per i tipi derivati.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di muxing.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

DDAudio

Descrive le impostazioni di codifica audio Dolby Digital Audio Codec (AC3). L'implementazione corrente per il supporto di Dolby Digital Audio è: Numeri di canale audio a 1(mono), 2(stereo), 6(5.1side); Frequenza di campionamento audio a: 32K/44,1K/48 K Hz; I valori di velocità in bit audio come specifica AC3 supportano: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 64000 bps.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.DDAudio	Il discriminatorio per i tipi derivati.
bitrate	integer	Velocità in bit, in bit al secondo, dell'audio con codifica di output.
channels	integer	Numero di canali nell'audio.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di multiplexing.
samplingRate	integer	Frequenza di campionamento da utilizzare per la codifica inhz.

Deinterlace

Descrive le impostazioni di de-interlacing.

Nome	Tipo	Descrizione
mode	DeinterlaceMode	Modalità di deinterlacing. Impostazione predefinita su AutoPixelAdaptive.
parity	DeinterlaceParity	La parità di campo per la de-interlacing, impostazione predefinita su Auto.

DeinterlaceMode

Modalità di deinterlacing. Impostazione predefinita su AutoPixelAdaptive.

Nome	Tipo	Descrizione
AutoPixelAdaptive	string	Applicare la delacciatura automatica dei pixel adattivi su ogni fotogramma nel video di input.
Off	string	Disabilita l'interlacciamento del video di origine.

DeinterlaceParity

La parità di campo per la de-interlacing, impostazione predefinita su Auto.

Nome	Tipo	Descrizione
Auto	string	Rilevare automaticamente l'ordine dei campi
BottomFieldFirst	string	Applicare il campo inferiore prima elaborazione del video di input.
TopFieldFirst	string	Applicare prima l'elaborazione del video di input.

EncoderNamedPreset

Set di impostazioni predefinito da usare per la codifica dei video.

Nome	Tipo	Descrizione
AACGoodQualityAudio	string	Produce un singolo file MP4 contenente solo l'audio stereo AAC codificato a 192 kbps.
AdaptiveStreaming	string	Produce un set di file MP4 allineati a GOP con video H.264 e audio AAC stereo. Genera automaticamente una scala a velocità in bit in base alla risoluzione, alla velocità in bit e alla frequenza dei fotogrammi di input. Il set di impostazioni generato automaticamente non supererà mai la risoluzione di input. Ad esempio, se l'input è 720p, l'output rimarrà al massimo 720p.
ContentAwareEncoding	string	Produce un set di MP4 allineati a GOP usando la codifica compatibile con il contenuto. Dato qualsiasi contenuto di input, il servizio esegue un'analisi iniziale leggera del contenuto di input e usa i risultati per determinare il numero ottimale di livelli, le impostazioni di velocità in bit e risoluzione appropriate per il recapito tramite streaming adattivo. Questo set di impostazioni è particolarmente efficace per i video di bassa e media complessità, in cui i file di output saranno a velocità in bit inferiori, ma a una qualità che offre comunque un'esperienza ottimale agli spettatori. L'output conterrà file MP4 con interfoliazione video e audio.
ContentAwareEncodingExperimental	string	Espone un set di impostazioni sperimentale per la codifica compatibile con il contenuto. Dato qualsiasi contenuto di input, il servizio tenta di determinare automaticamente il numero ottimale di livelli, le impostazioni di velocità in bit e risoluzione appropriate per il recapito tramite streaming adattivo. Gli algoritmi sottostanti continueranno a evolversi nel tempo. L'output conterrà file MP4 con interfoliazione video e audio.
CopyAllBitrateNonInterleaved	string	Copiare tutti i flussi video e audio dall'asset di input come file di output audio e video non interleaved. Questo set di impostazioni può essere usato per ritagliare un asset esistente o convertire un gruppo di file MP4 allineati al fotogramma chiave (GOP) come asset che può essere trasmesso.
DDGoodQualityAudio	string	Produce un singolo file MP4 contenente solo audio stereo DD (Digital Dolby) codificato a 192 kbps.
H264MultipleBitrate1080p	string	Produce un set di 8 file MP4 allineati a GOP, compresi tra 6000 kbps e 400 kbps e audio AAC stereo. La risoluzione inizia a 1080p e scende a 180p.
H264MultipleBitrate720p	string	Produce un set di 6 file MP4 allineati a GOP, compresi tra 3400 kbps e 400 kbps e audio AAC stereo. La risoluzione inizia a 720p e scende a 180p.
H264MultipleBitrateSD	string	Produce un set di 5 file MP4 allineati a GOP, compresi tra 1900 kbps e 400 kbps e audio AAC stereo. La risoluzione inizia a 480p e scende a 240p.
H264SingleBitrate1080p	string	Produce un file MP4 in cui il video è codificato con codec H.264 a 6750 kbps e un'altezza dell'immagine di 1080 pixel e l'audio stereo è codificato con codec AAC-LC a 128 kbps.
H264SingleBitrate720p	string	Produce un file MP4 in cui il video è codificato con codec H.264 a 4500 kbps e un'altezza dell'immagine di 720 pixel e l'audio stereo viene codificato con codec AAC-LC a 128 kbps.
H264SingleBitrateSD	string	Produce un file MP4 in cui il video è codificato con codec H.264 a 2200 kbps e un'altezza dell'immagine di 480 pixel e l'audio stereo è codificato con codec AAC-LC a 128 kbps.
H265AdaptiveStreaming	string	Produce un set di file MP4 allineati a GOP con video H.265 e audio AAC stereo. Genera automaticamente una scala a velocità in bit in base alla risoluzione, alla velocità in bit e alla frequenza dei fotogrammi di input. Il set di impostazioni generato automaticamente non supererà mai la risoluzione di input. Ad esempio, se l'input è 720p, l'output rimarrà al massimo 720p.
H265ContentAwareEncoding	string	Produce un set di MP4 allineati a GOP usando la codifica compatibile con il contenuto. Dato qualsiasi contenuto di input, il servizio esegue un'analisi iniziale leggera del contenuto di input e usa i risultati per determinare il numero ottimale di livelli, le impostazioni di velocità in bit e risoluzione appropriate per il recapito tramite streaming adattivo. Questo set di impostazioni è particolarmente efficace per i video di bassa e media complessità, in cui i file di output saranno a velocità in bit inferiori, ma a una qualità che offre comunque un'esperienza ottimale agli spettatori. L'output conterrà file MP4 con interfoliazione video e audio.
H265SingleBitrate1080p	string	Produce un file MP4 in cui il video è codificato con codec H.265 a 3500 kbps e un'altezza dell'immagine di 1080 pixel e l'audio stereo è codificato con codec AAC-LC a 128 kbps.
H265SingleBitrate4K	string	Produce un file MP4 in cui il video è codificato con codec H.265 a 9500 kbps e un'altezza dell'immagine di 2160 pixel e l'audio stereo è codificato con codec AAC-LC a 128 kbps.
H265SingleBitrate720p	string	Produce un file MP4 in cui il video è codificato con codec H.265 a 1800 kbps e un'altezza dell'immagine di 720 pixel e l'audio stereo è codificato con codec AAC-LC a 128 kbps.

EntropyMode

Modalità entropia da usare per questo livello. Se non specificato, il codificatore sceglie la modalità appropriata per il profilo e il livello.

Nome	Tipo	Descrizione
Cabac	string	Codifica entropia aritmetica aritmetica del contesto adattiva.
Cavlc	string	Codifica entropia CAVLC (Context Adaptive Variable Length Coder).

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

FaceDetectorPreset

Descrive tutte le impostazioni da usare durante l'analisi di un video per rilevare (e facoltativamente ridistribuire) tutti i visi presenti.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.FaceDetectorPreset	Discriminazione per i tipi derivati.
blurType	BlurType	Tipo di blur
experimentalOptions	object	Dizionario contenente coppie di valori chiave per i parametri non esposti nel set di impostazioni stesso
mode	FaceRedactorMode	Questa modalità consente di scegliere tra le impostazioni seguenti: 1) Analizza - Solo per il rilevamento. Questa modalità genera un file JSON di metadati che contrassegna le apparenze dei visi nel video. Se possibile, le apparizioni della stessa persona vengono assegnate allo stesso ID. 2) Combinate - Inoltre, redacts(blurs) rilevate visi. 3) Redact: consente un processo a 2 passaggi, consentendo la ridistribuzione selettiva di un subset di visi rilevati. Accetta il file di metadati da un passaggio di analisi precedente, insieme al video di origine e un subset selezionato dall'utente di ID che richiedono la ridistribuzione.
resolution	AnalysisResolution	Specifica la risoluzione massima in corrispondenza della quale viene analizzato il video. Il comportamento predefinito è "SourceResolution", che manterrà il video di input alla risoluzione originale quando analizzato. L'uso di "StandardDefinition" ridimensiona i video di input alla definizione standard mantenendo il rapporto di aspetto appropriato. Verrà ridimensionato solo se il video è di una risoluzione superiore. Ad esempio, un input 1920x1080 viene ridimensionato su 640x360 prima dell'elaborazione. Il passaggio a "StandardDefinition" riduce il tempo necessario per elaborare video a risoluzione elevata. Può anche ridurre il costo dell'uso di questo componente (vedere per informazioni https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics dettagliate). Tuttavia, i visi che finiscono troppo piccoli nel video ridimensionato potrebbero non essere rilevati.

FaceRedactorMode

Questa modalità consente di scegliere tra le impostazioni seguenti: 1) Analizza - Solo per il rilevamento. Questa modalità genera un file JSON di metadati che contrassegna gli aspetti dei visi in tutto il video. Laddove possibile, agli aspetti della stessa persona viene assegnato lo stesso ID. 2) Combinato- Inoltre, vengono rilevati visi con sfocatura.Where possible, appearances of the same person are assigned the same ID. 2) Combined - Additionally redacts(blurs) detected faces. 3) Redact : consente un processo a 2 passaggi, consentendo la ridistribuzione selettiva di un sottoinsieme di visi rilevati. Accetta il file di metadati da un passaggio di analisi precedente, insieme al video di origine e un sottoinsieme di ID selezionati dall'utente che richiedono la ridistribuzione.

Nome	Tipo	Descrizione
Analyze	string	La modalità di analisi rileva i visi e restituisce un file di metadati con i risultati. Consente la modifica del file di metadati prima che i visi vengano sfocati con la modalità Redact.
Combined	string	La modalità combinata esegue i passaggi Analizza e Redact in un unico passaggio quando si modificano i visi analizzati non è desiderato.
Redact	string	La modalità Redact utilizza il file di metadati dalla modalità Di analisi e redatta i visi trovati.

Fade

Descrive le proprietà di un effetto Fade applicato al supporto di input.

Nome	Tipo	Descrizione
duration	string	Durata dell'effetto di dissolvenza nel video. Il valore può essere in formato ISO 8601 (ad esempio PT05S per sadere un colore in/Out durante 5 secondi) o un numero di fotogrammi (ad esempio 10 per sadere 10 fotogrammi dall'ora di inizio) o un valore relativo per la durata del flusso (ad esempio, 10% per sadere il 10% della durata del flusso)
fadeColor	string	Colore per la sade In/Out. può essere sui colori https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords CSS Level1 o un valore RGB/ex: ad esempio rgb(255,0,0), 0xFF0000 o #FF0000
start	string	Posizione nel video di input da cui iniziare la sade. Il valore può essere in formato ISO 8601 (ad esempio PT05S per iniziare a 5 secondi) o un numero di fotogrammi (ad esempio, 10 per iniziare al 10° fotogramma) o un valore relativo per la durata del flusso (ad esempio, il 10% per iniziare al 10% della durata del flusso). Il valore predefinito è 0

Filters

Descrive tutte le operazioni di filtro, ad esempio de-interlacciamento, rotazione e così via, da applicare al supporto di input prima della codifica.

Nome	Tipo	Descrizione
crop	Rectangle	Parametri per la finestra rettangolare con cui ritagliare il video di input.
deinterlace	Deinterlace	Impostazioni di de-interlacciamento.
fadeIn	Fade	Descrive le proprietà di un effetto dissolvenza applicato al supporto di input.
fadeOut	Fade	Descrive le proprietà di un effetto dissolvenza applicato al supporto di input.
overlays	Overlay[]: AudioOverlay[] VideoOverlay[]	Proprietà delle sovrimpressioni da applicare al video di input. Possono trattarsi di sovrimpressione audio, immagine o video.
rotation	Rotation	Rotazione, se presente, da applicare al video di input, prima che venga codificata. Il valore predefinito è Auto

H264Complexity

Indica al codificatore come scegliere le impostazioni di codifica. Il valore predefinito è Bilanciato.

Nome	Tipo	Descrizione
Balanced	string	Indica al codificatore di usare le impostazioni che consentono di ottenere un equilibrio tra velocità e qualità.
Quality	string	Indica al codificatore di usare le impostazioni ottimizzate per produrre un output di qualità superiore a scapito del tempo di codifica complessivo più lento.
Speed	string	Indica al codificatore di usare le impostazioni ottimizzate per una codifica più rapida. La qualità viene sacrificata per ridurre il tempo di codifica.

H264Layer

Descrive le impostazioni da usare durante la codifica del video di input in un livello di velocità in bit di output desiderato con il codec video H.264.

Nome	Tipo	Descrizione
adaptiveBFrame	boolean	Indica se usare o meno fotogrammi B adattivi durante la codifica di questo livello. Se non specificato, il codificatore lo attiva ogni volta che il profilo video ne consente l'uso.
bFrames	integer	Numero di fotogrammi B da utilizzare per la codifica di questo livello. Se non specificato, il codificatore sceglie un numero appropriato in base al profilo e al livello video.
bitrate	integer	Velocità in bit media in bit al secondo in corrispondenza della quale codificare il video di input durante la generazione di questo livello. Questo campo è obbligatorio.
bufferWindow	string	Lunghezza della finestra buffer VBV. Il valore deve essere in formato ISO 8601. Il valore deve essere compreso nell'intervallo [0,1-100] secondi. Il valore predefinito è 5 secondi (ad esempio PT5S).
crf	number	Valore di CRF da utilizzare per la codifica di questo livello. Questa impostazione diventa effettiva quando RateControlMode del codec video è impostato in modalità CRF. L'intervallo di valori CRF è compreso tra 0 e 51, dove i valori più bassi generano una migliore qualità, a scapito di dimensioni file superiori. I valori più alti indicano una maggiore compressione, ma a un certo punto si noterà una riduzione della qualità. Il valore predefinito è 23.
entropyMode	EntropyMode	Modalità entropia da usare per questo livello. Se non specificato, il codificatore sceglie la modalità appropriata per il profilo e il livello.
frameRate	string	Frequenza dei fotogrammi (in fotogrammi al secondo) in corrispondenza della quale codificare questo livello. Il valore può essere sotto forma di M/N dove M e N sono numeri interi (ad esempio 30000/1001) o sotto forma di numero (ad esempio, 30 o 29,97). Il codificatore applica vincoli alle frequenze dei fotogrammi consentite in base al profilo e al livello. Se non è specificato, il codificatore userà la stessa frequenza dei fotogrammi del video di input.
height	string	Altezza del video di output per questo livello. Il valore può essere assoluto (in pixel) o relativo (in percentuale). Ad esempio, il 50% indica che il video di output ha metà del numero di pixel in altezza dell'input.
label	string	Etichetta alfanumerica per questo livello, che può essere usata in multiplexing di diversi livelli video e audio o per denominare il file di output.
level	string	Attualmente è supportato il livello fino alla 6.2. Il valore può essere Auto o un numero corrispondente al profilo H.264. Se non specificato, il valore predefinito è Auto, che consente al codificatore di scegliere il livello appropriato per questo livello.
maxBitrate	integer	Velocità in bit massima (in bit al secondo), in corrispondenza della quale si presuppone che il buffer VBV venga riempito. Se non specificato, per impostazione predefinita viene usato lo stesso valore della velocità in bit.
profile	H264VideoProfile	Attualmente sono supportati Baseline, Main, High, High422, High444. Il valore predefinito è Auto.
referenceFrames	integer	Numero di frame di riferimento da utilizzare durante la codifica di questo livello. Se non specificato, il codificatore determina un numero appropriato in base all'impostazione di complessità del codificatore.
slices	integer	Numero di sezioni da utilizzare durante la codifica di questo livello. Se non specificato, il valore predefinito è zero, il che significa che il codificatore userà una singola sezione per ogni fotogramma.
width	string	Larghezza del video di output per questo livello. Il valore può essere assoluto (in pixel) o relativo (in percentuale). Ad esempio, il 50% indica che il video di output ha metà del numero di pixel di larghezza dell'input.

H264RateControlMode

Modalità di controllo della frequenza video

Nome	Tipo	Descrizione
ABR	string	Modalità ABR (Average Bitrate) che raggiunge la velocità in bit di destinazione: modalità predefinita.
CBR	string	Modalità CBR (Constant Bitrate) che restringe le variazioni di velocità in bit intorno alla velocità in bit di destinazione.
CRF	string	Modalità CRF (Constant Rate Factor) che punta a una qualità soggettiva costante.

H264Video

Descrive tutte le proprietà per la codifica di un video con il codec H.264.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.H264Video	Il discriminatorio per i tipi derivati.
complexity	H264Complexity	Indica al codificatore come scegliere le impostazioni di codifica. Il valore predefinito è Bilanciato.
keyFrameInterval	string	Distanza tra due fotogrammi chiave. Il valore deve essere diverso da zero nell'intervallo [0,5, 20] secondi, specificato nel formato ISO 8601. Il valore predefinito è 2 secondi (PT2S). Si noti che questa impostazione viene ignorata se è impostato VideoSyncMode.Passthrough, in cui il valore KeyFrameInterval seguirà l'impostazione dell'origine di input.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di multiplexing.
layers	H264Layer[]	Raccolta di livelli H.264 di output da produrre dal codificatore.
rateControlMode	H264RateControlMode	Modalità di controllo della frequenza video
sceneChangeDetection	boolean	Indica se il codificatore deve inserire fotogrammi chiave in corrispondenza delle modifiche della scena. Se non specificato, il valore predefinito è false. Questo flag deve essere impostato su true solo quando il codificatore è configurato per produrre un singolo video di output.
stretchMode	StretchMode	Modalità di ridimensionamento: modalità di ridimensionamento del video di input in base alle risoluzioni di output desiderate. Il valore predefinito è AutoSize
syncMode	VideoSyncMode	Modalità di sincronizzazione video

H264VideoProfile

Attualmente sono supportati Baseline, Main, High, High422, High444. Il valore predefinito è Auto.

Nome	Tipo	Descrizione
Auto	string	Indica al codificatore di determinare automaticamente il profilo H.264 appropriato.
Baseline	string	Profilo di base
High	string	Profilo elevato.
High422	string	Profilo alto 4:2:2.
High444	string	Profilo predittivo 4:4:4 elevato.
Main	string	Profilo principale

H265Complexity

Indica al codificatore come scegliere le impostazioni di codifica. La qualità fornirà un rapporto di compressione più elevato, ma a costi più elevati e tempo di calcolo più lungo. La velocità produrrà un file relativamente più grande, ma è più veloce e più economico. Il valore predefinito è Bilanciato.

Nome	Tipo	Descrizione
Balanced	string	Indica al codificatore di usare le impostazioni che consentono di ottenere un equilibrio tra velocità e qualità.
Quality	string	Indica al codificatore di usare le impostazioni ottimizzate per produrre un output di qualità superiore a spese del tempo di codifica complessivo più lento.
Speed	string	Indica al codificatore di usare le impostazioni ottimizzate per la codifica più veloce. La qualità viene sacrificata per ridurre il tempo di codifica.

H265Layer

Descrive le impostazioni da usare quando si codifica il video di input in un livello di velocità di bit di output desiderato con il codec video H.265.

Nome	Tipo	Descrizione
adaptiveBFrame	boolean	Specifica se usare o meno fotogrammi B adattivi durante la codifica di questo livello. Se non specificato, il codificatore lo attiva ogni volta che il profilo video ne consente l'uso.
bFrames	integer	Numero di fotogrammi B da utilizzare per la codifica di questo livello. Se non specificato, il codificatore sceglie un numero appropriato in base al profilo e al livello video.
bitrate	integer	Velocità in bit media in bit al secondo in corrispondenza della quale codificare il video di input durante la generazione di questo livello. Ad esempio: una velocità in bit di destinazione di 3000 Kbps o 3 Mbps indica che questo valore deve essere 30000000 Questo è un campo obbligatorio.
bufferWindow	string	Lunghezza della finestra buffer VBV. Il valore deve essere in formato ISO 8601. Il valore deve essere compreso nell'intervallo [0,1-100] secondi. Il valore predefinito è 5 secondi (ad esempio PT5S).
crf	number	Valore di CRF da utilizzare per la codifica di questo livello. Questa impostazione diventa effettiva quando RateControlMode del codec video è impostato in modalità CRF. L'intervallo di valori CRF è compreso tra 0 e 51, dove i valori più bassi generano una migliore qualità, a scapito di dimensioni file superiori. I valori più alti indicano una maggiore compressione, ma a un certo punto si noterà una riduzione della qualità. Il valore predefinito è 28.
frameRate	string	Frequenza dei fotogrammi (in fotogrammi al secondo) in corrispondenza della quale codificare questo livello. Il valore può essere sotto forma di M/N dove M e N sono numeri interi (ad esempio 30000/1001) o sotto forma di numero (ad esempio, 30 o 29,97). Il codificatore applica vincoli alle frequenze dei fotogrammi consentite in base al profilo e al livello. Se non è specificato, il codificatore userà la stessa frequenza dei fotogrammi del video di input.
height	string	Altezza del video di output per questo livello. Il valore può essere assoluto (in pixel) o relativo (in percentuale). Ad esempio, il 50% indica che il video di output ha metà del numero di pixel in altezza dell'input.
label	string	Etichetta alfanumerica per questo livello, che può essere usata in multiplexing di diversi livelli video e audio o per denominare il file di output.
level	string	Attualmente è supportato il livello fino alla 6.2. Il valore può essere Auto o un numero corrispondente al profilo H.265. Se non specificato, il valore predefinito è Auto, che consente al codificatore di scegliere il livello appropriato per questo livello.
maxBitrate	integer	Velocità in bit massima (in bit al secondo), in corrispondenza della quale si presuppone che il buffer VBV venga riempito. Se non specificato, per impostazione predefinita viene usato lo stesso valore della velocità in bit.
profile	H265VideoProfile	Attualmente supportiamo Main. Il valore predefinito è Auto.
referenceFrames	integer	Numero di frame di riferimento da utilizzare durante la codifica di questo livello. Se non specificato, il codificatore determina un numero appropriato in base all'impostazione di complessità del codificatore.
slices	integer	Numero di sezioni da utilizzare durante la codifica di questo livello. Se non specificato, il valore predefinito è zero, il che significa che il codificatore userà una singola sezione per ogni fotogramma.
width	string	Larghezza del video di output per questo livello. Il valore può essere assoluto (in pixel) o relativo (in percentuale). Ad esempio, il 50% indica che il video di output ha metà del numero di pixel di larghezza dell'input.

H265Video

Descrive tutte le proprietà per la codifica di un video con il codec H.265.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.H265Video	Discriminazione per i tipi derivati.
complexity	H265Complexity	Indica al codificatore come scegliere le impostazioni di codifica. La qualità fornirà un rapporto di compressione più elevato, ma a costi più elevati e tempo di calcolo più lungo. La velocità produrrà un file relativamente più grande, ma è più veloce e più economico. Il valore predefinito è Bilanciato.
keyFrameInterval	string	Distanza tra due fotogrammi chiave. Il valore deve essere diverso da zero nell'intervallo [0,5, 20] secondi, specificato in formato ISO 8601. Il valore predefinito è 2 secondi(PT2S). Si noti che questa impostazione viene ignorata se è impostato VideoSyncMode.Pass through, in cui il valore KeyFrameInterval seguirà l'impostazione di origine di input.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di muxing.
layers	H265Layer[]	Raccolta di livelli H.265 di output da produrre dal codificatore.
sceneChangeDetection	boolean	Specifica se il codificatore deve inserire fotogrammi chiave in fase di modifica della scena. Se non specificato, il valore predefinito è false. Questo flag deve essere impostato su true solo quando il codificatore è configurato per produrre un singolo video di output.
stretchMode	StretchMode	Modalità di ridimensionamento: come verrà ridimensionato il video di input per adattare le risoluzioni di output desiderate. Il valore predefinito è AutoSize
syncMode	VideoSyncMode	Modalità di sincronizzazione video

H265VideoProfile

Attualmente supportiamo Main. Il valore predefinito è Auto.

Nome	Tipo	Descrizione
Auto	string	Indica al codificatore di determinare automaticamente il profilo H.265 appropriato.
Main	string	Profilo principale (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier)
Main10	string	Profilo principale 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10)

Image

Descrive le proprietà di base per la generazione di anteprime dal video di input

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.Image	Il discriminatorio per i tipi derivati.
keyFrameInterval	string	Distanza tra due fotogrammi chiave. Il valore deve essere diverso da zero nell'intervallo [0,5, 20] secondi, specificato nel formato ISO 8601. Il valore predefinito è 2 secondi (PT2S). Si noti che questa impostazione viene ignorata se è impostato VideoSyncMode.Passthrough, in cui il valore KeyFrameInterval seguirà l'impostazione dell'origine di input.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di multiplexing.
range	string	Posizione relativa alla trasformazione dell'ora di inizio predefinita nel video di input in cui interrompere la generazione di anteprime. Il valore può essere in formato ISO 8601 (ad esempio, PT5M30S per arrestarsi a 5 minuti e 30 secondi dall'ora di inizio) o un numero di fotogrammi (ad esempio, 300 per arrestarsi al 300° fotogramma dal frame all'ora di inizio). Se questo valore è 1, significa produrre una sola anteprima all'ora di inizio) o un valore relativo alla durata del flusso (ad esempio, il 50% per arrestarsi a metà della durata del flusso dall'ora di inizio). Il valore predefinito è 100%, che significa arrestarsi alla fine del flusso.
start	string	Posizione nel video di input da cui iniziare a generare anteprime. Il valore può essere in formato ISO 8601 (ad esempio PT05S per iniziare a 5 secondi) o un numero di fotogrammi (ad esempio, 10 per iniziare al 10° fotogramma) o un valore relativo alla durata del flusso (ad esempio, 10% per iniziare al 10% della durata del flusso). Supporta anche una macro {Best}, che indica al codificatore di selezionare l'anteprima migliore dai primi secondi del video e produrrà solo un'anteprima, indipendentemente dalle altre impostazioni per Step e Range. Il valore predefinito è la macro {Best}.
step	string	Intervalli in cui vengono generate le anteprime. Il valore può essere in formato ISO 8601 (ad esempio PT05S per un'immagine ogni 5 secondi) o un numero di fotogrammi (ad esempio, 30 per un'immagine ogni 30 fotogrammi) o un valore relativo alla durata del flusso (ad esempio, 10% per un'immagine ogni 10% della durata del flusso). Nota: il valore del passaggio influirà sulla prima anteprima generata, che potrebbe non essere esattamente quella specificata all'ora di inizio predefinita della trasformazione. Ciò è dovuto al codificatore, che tenta di selezionare l'anteprima migliore tra l'ora di inizio e la posizione passaggio dall'ora di inizio come primo output. Poiché il valore predefinito è 10%, significa che se il flusso ha una durata prolungata, la prima anteprima generata potrebbe essere lontana da quella specificata all'ora di inizio. Provare a selezionare un valore ragionevole per Step se la prima anteprima è prevista vicino all'ora di inizio o impostare Valore intervallo su 1 se è necessaria una sola anteprima all'ora di inizio.
stretchMode	StretchMode	Modalità di ridimensionamento: modalità di ridimensionamento del video di input in base alle risoluzioni di output desiderate. Il valore predefinito è AutoSize
syncMode	VideoSyncMode	Modalità di sincronizzazione video

ImageFormat

Descrive le proprietà di un file di immagine di output.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.ImageFormat	Il discriminatorio per i tipi derivati.
filenamePattern	string	Modello di denominazione dei file utilizzato per la creazione di file di output. Nel nome file sono supportate le macro seguenti: {Basename} - Macro di espansione che userà il nome del file video di input. Se il nome di base (il suffisso del file non è incluso) del file video di input è composto da meno di 32 caratteri, verrà usato il nome di base dei file video di input. Se la lunghezza del nome di base del file video di input supera i 32 caratteri, il nome di base viene troncato ai primi 32 caratteri in lunghezza totale. {Extension} - Estensione appropriata per questo formato. {Label} - Etichetta assegnata al codec/livello. {Index} - Indice univoco per le anteprime. Applicabile solo alle anteprime. {AudioStream} - stringa "Audio" più numero di flusso audio(a partire da 1). {Bitrate} - Velocità in bit audio/video in kbps. Non applicabile alle anteprime. {Codec} - Tipo di codec audio/video. {Resolution} - Risoluzione video. Tutte le macro non inviate verranno compresse e rimosse dal nome file.

InsightsType

Definisce il tipo di informazioni dettagliate che si desidera generare il servizio. I valori consentiti sono "AudioInsightsOnly", "VideoInsightsOnly" e "AllInsights". Il valore predefinito è AllInsights. Se si imposta questa opzione su AllInsights e l'input è solo audio, vengono generate solo informazioni audio. Analogamente, se l'input è solo video, vengono generate solo informazioni video. È consigliabile non usare AudioInsightsOnly se si prevede che alcuni degli input siano solo video; o usare VideoInsightsOnly se si prevede che alcuni degli input siano solo audio. I processi in tali condizioni potrebbero essere eseguiti errori.

Nome	Tipo	Descrizione
AllInsights	string	Generare informazioni dettagliate sia audio che video. Ha esito negativo se audio o video Insights non riesce.
AudioInsightsOnly	string	Generare solo informazioni dettagliate sull'audio. Ignorare il video anche se presente. Non riesce se non è presente alcun audio.
VideoInsightsOnly	string	Generare solo informazioni dettagliate sul video. Ignorare l'audio se presente. Non riesce se non è presente alcun video.

InterleaveOutput

Imposta la modalità interleave dell'output per controllare la modalità di archiviazione dell'audio e del video nel formato contenitore. Esempio: impostare InterleavedOutput come NonInterleavedOutput per produrre output solo audio e video in file MP4 separati.

Nome	Tipo	Descrizione
InterleavedOutput	string	L'output include sia audio che video.
NonInterleavedOutput	string	L'output è solo video o audio.

JpgFormat

Descrive le impostazioni per la produzione di anteprime JPEG.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.JpgFormat	Il discriminatorio per i tipi derivati.
filenamePattern	string	Modello di denominazione dei file utilizzato per la creazione di file di output. Nel nome file sono supportate le macro seguenti: {Basename} - Macro di espansione che userà il nome del file video di input. Se il nome di base (il suffisso del file non è incluso) del file video di input è composto da meno di 32 caratteri, verrà usato il nome di base dei file video di input. Se la lunghezza del nome di base del file video di input supera i 32 caratteri, il nome di base viene troncato ai primi 32 caratteri in lunghezza totale. {Extension} - Estensione appropriata per questo formato. {Label} - Etichetta assegnata al codec/livello. {Index} - Indice univoco per le anteprime. Applicabile solo alle anteprime. {AudioStream} - stringa "Audio" più numero di flusso audio(a partire da 1). {Bitrate} - Velocità in bit audio/video in kbps. Non applicabile alle anteprime. {Codec} - Tipo di codec audio/video. {Resolution} - Risoluzione video. Tutte le macro non inviate verranno compresse e rimosse dal nome file.

JpgImage

Descrive le proprietà per la produzione di una serie di immagini JPEG dal video di input.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.JpgImage	Il discriminatorio per i tipi derivati.
keyFrameInterval	string	Distanza tra due fotogrammi chiave. Il valore deve essere diverso da zero nell'intervallo [0,5, 20] secondi, specificato nel formato ISO 8601. Il valore predefinito è 2 secondi (PT2S). Si noti che questa impostazione viene ignorata se è impostato VideoSyncMode.Passthrough, in cui il valore KeyFrameInterval seguirà l'impostazione dell'origine di input.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di multiplexing.
layers	JpgLayer[]	Raccolta di livelli di immagine JPEG di output da produrre dal codificatore.
range	string	Posizione relativa alla trasformazione dell'ora di inizio predefinita nel video di input in cui interrompere la generazione di anteprime. Il valore può essere in formato ISO 8601 (ad esempio, PT5M30S per arrestarsi a 5 minuti e 30 secondi dall'ora di inizio) o un numero di fotogrammi (ad esempio, 300 per arrestarsi al 300° fotogramma dal frame all'ora di inizio). Se questo valore è 1, significa produrre una sola anteprima all'ora di inizio) o un valore relativo alla durata del flusso (ad esempio, il 50% per arrestarsi a metà della durata del flusso dall'ora di inizio). Il valore predefinito è 100%, che significa arrestarsi alla fine del flusso.
spriteColumn	integer	Imposta il numero di colonne utilizzate nell'immagine sprite dell'anteprima. Il numero di righe viene calcolato automaticamente e viene generato un file VTT con i mapping delle coordinate per ogni anteprima nello sprite. Nota: questo valore deve essere un numero intero positivo ed è consigliabile un valore appropriato in modo che la risoluzione dell'immagine di output non superi il limite massimo di risoluzione pixel JPEG 65535x65535.
start	string	Posizione nel video di input da cui iniziare a generare anteprime. Il valore può essere in formato ISO 8601 (ad esempio PT05S per iniziare a 5 secondi) o un numero di fotogrammi (ad esempio, 10 per iniziare al 10° fotogramma) o un valore relativo alla durata del flusso (ad esempio, 10% per iniziare al 10% della durata del flusso). Supporta anche una macro {Best}, che indica al codificatore di selezionare l'anteprima migliore dai primi secondi del video e produrrà solo un'anteprima, indipendentemente dalle altre impostazioni per Step e Range. Il valore predefinito è la macro {Best}.
step	string	Intervalli in cui vengono generate le anteprime. Il valore può essere in formato ISO 8601 (ad esempio PT05S per un'immagine ogni 5 secondi) o un numero di fotogrammi (ad esempio, 30 per un'immagine ogni 30 fotogrammi) o un valore relativo alla durata del flusso (ad esempio, 10% per un'immagine ogni 10% della durata del flusso). Nota: il valore del passaggio influirà sulla prima anteprima generata, che potrebbe non essere esattamente quella specificata all'ora di inizio predefinita della trasformazione. Ciò è dovuto al codificatore, che tenta di selezionare l'anteprima migliore tra l'ora di inizio e la posizione passaggio dall'ora di inizio come primo output. Poiché il valore predefinito è 10%, significa che se il flusso ha una durata prolungata, la prima anteprima generata potrebbe essere lontana da quella specificata all'ora di inizio. Provare a selezionare un valore ragionevole per Step se la prima anteprima è prevista vicino all'ora di inizio o impostare Valore intervallo su 1 se è necessaria una sola anteprima all'ora di inizio.
stretchMode	StretchMode	Modalità di ridimensionamento: modalità di ridimensionamento del video di input in base alle risoluzioni di output desiderate. Il valore predefinito è AutoSize
syncMode	VideoSyncMode	Modalità di sincronizzazione video

JpgLayer

Descrive le impostazioni per produrre un'immagine JPEG dal video di input.

Nome	Tipo	Descrizione
height	string	Altezza del video di output per questo livello. Il valore può essere assoluto (in pixel) o relativo (in percentuale). Ad esempio, il 50% indica che il video di output ha metà del numero di pixel in altezza dell'input.
label	string	Etichetta alfanumerica per questo livello, che può essere usata in multiplexing di diversi livelli video e audio o per denominare il file di output.
quality	integer	Qualità della compressione dell'output JPEG. L'intervallo è compreso tra 0 e 100 e il valore predefinito è 70.
width	string	Larghezza del video di output per questo livello. Il valore può essere assoluto (in pixel) o relativo (in percentuale). Ad esempio, il 50% indica che il video di output ha metà del numero di pixel di larghezza dell'input.

Mp4Format

Descrive le proprietà per un file ISO MP4 di output.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.Mp4Format	Il discriminatorio per i tipi derivati.
filenamePattern	string	Modello di denominazione dei file utilizzato per la creazione di file di output. Nel nome file sono supportate le macro seguenti: {Basename} - Macro di espansione che userà il nome del file video di input. Se il nome di base (il suffisso del file non è incluso) del file video di input è composto da meno di 32 caratteri, verrà usato il nome di base dei file video di input. Se la lunghezza del nome di base del file video di input supera i 32 caratteri, il nome di base viene troncato ai primi 32 caratteri in lunghezza totale. {Extension} - Estensione appropriata per questo formato. {Label} - Etichetta assegnata al codec/livello. {Index} - Indice univoco per le anteprime. Applicabile solo alle anteprime. {AudioStream} - stringa "Audio" più numero di flusso audio(a partire da 1). {Bitrate} - Velocità in bit audio/video in kbps. Non applicabile alle anteprime. {Codec} - Tipo di codec audio/video. {Resolution} - Risoluzione video. Tutte le macro non inviate verranno compresse e rimosse dal nome file.
outputFiles	OutputFile[]	Elenco di file di output da produrre. Ogni voce nell'elenco è un set di etichette di livello audio e video da spostare insieme.

MultiBitrateFormat

Vengono descritte le proprietà per la produzione di una raccolta di file a bitrate multipli allineati a GOP. Il comportamento predefinito consiste nel produrre un file di output per ogni livello video che viene disattivato insieme a tutti gli audio. I file di output esatti prodotti possono essere controllati specificando l'insieme outputFiles.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.MultiBitrateFormat	Il discriminatorio per i tipi derivati.
filenamePattern	string	Modello di denominazione dei file utilizzato per la creazione di file di output. Nel nome file sono supportate le macro seguenti: {Basename} - Macro di espansione che userà il nome del file video di input. Se il nome di base (il suffisso del file non è incluso) del file video di input è composto da meno di 32 caratteri, verrà usato il nome di base dei file video di input. Se la lunghezza del nome di base del file video di input supera i 32 caratteri, il nome di base viene troncato ai primi 32 caratteri in lunghezza totale. {Extension} - Estensione appropriata per questo formato. {Label} - Etichetta assegnata al codec/livello. {Index} - Indice univoco per le anteprime. Applicabile solo alle anteprime. {AudioStream} - stringa "Audio" più numero di flusso audio(a partire da 1). {Bitrate} - Velocità in bit audio/video in kbps. Non applicabile alle anteprime. {Codec} - Tipo di codec audio/video. {Resolution} - Risoluzione video. Tutte le macro non inviate verranno compresse e rimosse dal nome file.
outputFiles	OutputFile[]	Elenco di file di output da produrre. Ogni voce nell'elenco è un set di etichette di livello audio e video da spostare insieme.

OnErrorType

Una trasformazione può definire più di un output. Questa proprietà definisce le operazioni che il servizio deve eseguire quando un output ha esito negativo: continuare a produrre altri output o arrestare gli altri output. Lo stato complessivo del processo non riflette gli errori di output specificati con 'ContinueJob'. Il valore predefinito è "StopProcessingJob".

Nome	Tipo	Descrizione
ContinueJob	string	Indica al servizio che se questo transformOutput ha esito negativo, consentire a qualsiasi altro transformOutput di continuare.
StopProcessingJob	string	Indica al servizio che, se questo TransformOutput ha esito negativo, è possibile arrestare qualsiasi altro TransformOutput incompleto.

OutputFile

Rappresenta un file di output prodotto.

Nome	Tipo	Descrizione
labels	string[]	Elenco di etichette che descrivono come il codificatore deve eseguire il multiplex video e l'audio in un file di output. Ad esempio, se il codificatore produce due livelli video con etichette v1 e v2 e un livello audio con etichetta a1, una matrice come "[v1, a1]" indica al codificatore di produrre un file di output con la traccia video rappresentata da v1 e la traccia audio rappresentata da a1.

PngFormat

Descrive le impostazioni per la produzione di anteprime PNG.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.PngFormat	Il discriminatorio per i tipi derivati.
filenamePattern	string	Modello di denominazione dei file utilizzato per la creazione di file di output. Le macro seguenti sono supportate nel nome del file: {Basename} - Macro di espansione che userà il nome del file video di input. Se il nome di base(il suffisso del file non è incluso) del file video di input è inferiore a 32 caratteri, verrà usato il nome di base dei file video di input. Se la lunghezza del nome di base del file video di input supera i 32 caratteri, il nome di base viene troncato ai primi 32 caratteri in lunghezza totale. {Extension} - Estensione appropriata per questo formato. {Label} : etichetta assegnata al codec/livello. {Index} - Indice univoco per le anteprime. Applicabile solo alle anteprime. {AudioStream} - stringa "Audio" più numero di flusso audio(a partire da 1). {Bitrate} - Velocità in bit audio/video in kbps. Non applicabile alle anteprime. {Codec} - Tipo di codec audio/video. {Resolution} - Risoluzione video. Tutte le macro non autorizzate verranno compresse e rimosse dal nome file.

PngImage

Descrive le proprietà per la produzione di una serie di immagini PNG dal video di input.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.PngImage	Il discriminatorio per i tipi derivati.
keyFrameInterval	string	Distanza tra due fotogrammi chiave. Il valore deve essere diverso da zero nell'intervallo [0,5, 20] secondi, specificato nel formato ISO 8601. Il valore predefinito è 2 secondi (PT2S). Si noti che questa impostazione viene ignorata se è impostato VideoSyncMode.Passthrough, in cui il valore KeyFrameInterval seguirà l'impostazione dell'origine di input.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di multiplexing.
layers	PngLayer[]	Raccolta di livelli immagine PNG di output da produrre dal codificatore.
range	string	Posizione relativa alla trasformazione dell'ora di inizio predefinita nel video di input in cui interrompere la generazione di anteprime. Il valore può essere in formato ISO 8601 (ad esempio, PT5M30S per arrestarsi a 5 minuti e 30 secondi dall'ora di inizio) o un numero di fotogrammi (ad esempio, 300 per arrestarsi al 300° fotogramma dal frame all'ora di inizio). Se questo valore è 1, significa produrre una sola anteprima all'ora di inizio) o un valore relativo alla durata del flusso (ad esempio, il 50% per arrestarsi a metà della durata del flusso dall'ora di inizio). Il valore predefinito è 100%, che significa arrestarsi alla fine del flusso.
start	string	Posizione nel video di input da cui iniziare a generare anteprime. Il valore può essere in formato ISO 8601 (ad esempio PT05S per iniziare a 5 secondi) o un numero di fotogrammi (ad esempio, 10 per iniziare al 10° fotogramma) o un valore relativo alla durata del flusso (ad esempio, 10% per iniziare al 10% della durata del flusso). Supporta anche una macro {Best}, che indica al codificatore di selezionare l'anteprima migliore dai primi secondi del video e produrrà solo un'anteprima, indipendentemente dalle altre impostazioni per Step e Range. Il valore predefinito è la macro {Best}.
step	string	Intervalli in cui vengono generate le anteprime. Il valore può essere in formato ISO 8601 (ad esempio PT05S per un'immagine ogni 5 secondi) o un numero di fotogrammi (ad esempio, 30 per un'immagine ogni 30 fotogrammi) o un valore relativo alla durata del flusso (ad esempio, 10% per un'immagine ogni 10% della durata del flusso). Nota: il valore del passaggio influirà sulla prima anteprima generata, che potrebbe non essere esattamente quella specificata all'ora di inizio predefinita della trasformazione. Ciò è dovuto al codificatore, che tenta di selezionare l'anteprima migliore tra l'ora di inizio e la posizione passaggio dall'ora di inizio come primo output. Poiché il valore predefinito è 10%, significa che se il flusso ha una durata prolungata, la prima anteprima generata potrebbe essere lontana da quella specificata all'ora di inizio. Provare a selezionare un valore ragionevole per Step se la prima anteprima è prevista vicino all'ora di inizio o impostare Valore intervallo su 1 se è necessaria una sola anteprima all'ora di inizio.
stretchMode	StretchMode	Modalità di ridimensionamento: modalità di ridimensionamento del video di input in base alle risoluzioni di output desiderate. Il valore predefinito è AutoSize
syncMode	VideoSyncMode	Modalità di sincronizzazione video

PngLayer

Descrive le impostazioni per produrre un'immagine PNG dal video di input.

Nome	Tipo	Descrizione
height	string	Altezza del video di output per questo livello. Il valore può essere assoluto (in pixel) o relativo (in percentuale). Ad esempio, il 50% indica che il video di output ha metà del numero di pixel in altezza dell'input.
label	string	Etichetta alfanumerica per questo livello, che può essere usata in multiplexing di diversi livelli video e audio o per denominare il file di output.
width	string	Larghezza del video di output per questo livello. Il valore può essere assoluto (in pixel) o relativo (in percentuale). Ad esempio, il 50% indica che il video di output ha metà del numero di pixel di larghezza dell'input.

PresetConfigurations

Oggetto delle impostazioni di configurazione facoltative per il codificatore.

Nome	Tipo	Descrizione
complexity	Complexity	Consente di configurare le impostazioni del codificatore per controllare l'equilibrio tra velocità e qualità. Esempio: impostare Complessità come Velocità per una codifica più veloce, ma meno efficienza di compressione.
interleaveOutput	InterleaveOutput	Imposta la modalità interleave dell'output per controllare la modalità di archiviazione dell'audio e del video nel formato contenitore. Esempio: impostare InterleavedOutput come NonInterleavedOutput per produrre output solo audio e solo video in file MP4 separati.
keyFrameIntervalInSeconds	number	Intervallo fotogrammi chiave in secondi. Esempio: impostare KeyFrameIntervalInSeconds su 2 per ridurre il buffer di riproduzione per alcuni lettori.
maxBitrateBps	integer	Velocità massima in bit al secondo (soglia per il livello video superiore). Esempio: impostare MaxBitrateBps su 6000000 per evitare di produrre output a velocità in bit molto elevata per il contenuto con complessità elevata.
maxHeight	integer	Altezza massima dei livelli video di output. Esempio: impostare MaxHeight su 720 per produrre livelli di output fino a 720P anche se l'input è 4K.
maxLayers	integer	Numero massimo di livelli video di output. Esempio: impostare MaxLayers su 4 per assicurarsi che vengano prodotti al massimo 4 livelli di output per controllare il costo complessivo del processo di codifica.
minBitrateBps	integer	Velocità minima in bit al secondo (soglia per il livello video inferiore). Esempio: impostare MinBitrateBps su 200000 per avere un livello inferiore che copre gli utenti con larghezza di banda di rete ridotta.
minHeight	integer	Altezza minima dei livelli video di output. Esempio: impostare MinHeight su 360 per evitare livelli di output di risoluzioni più piccole come 180P.

Priority

Imposta la priorità relativa dei TransformOutputs all'interno di una trasformazione. In questo modo viene impostata la priorità usata dal servizio per l'elaborazione di TransformOutputs. La priorità predefinita è Normale.

Nome	Tipo	Descrizione
High	string	Usato per TransformOutputs che deve avere la precedenza su altri.
Low	string	Usato per TransformOutputs che può essere generato dopo TransformOutputs normale e ad alta priorità.
Normal	string	Usato per TransformOutputs che può essere generato con priorità normale.

Rectangle

Descrive le proprietà di una finestra rettangolare applicata ai supporti di input prima di elaborarla.

Nome	Tipo	Descrizione
height	string	Altezza dell'area rettangolare in pixel. Questo può essere un valore di pixel assoluto (ad esempio 100) o rispetto alle dimensioni del video (ad esempio, 50%).
left	string	Numero di pixel dal margine sinistro. Questo può essere un valore di pixel assoluto (ad esempio 100) o rispetto alle dimensioni del video (ad esempio, 50%).
top	string	Numero di pixel dal margine superiore. Questo può essere un valore di pixel assoluto (ad esempio 100) o rispetto alle dimensioni del video (ad esempio, 50%).
width	string	Larghezza dell'area rettangolare in pixel. Questo può essere un valore di pixel assoluto (ad esempio 100) o rispetto alle dimensioni del video (ad esempio, 50%).

Rotation

La rotazione, se presente, da applicare al video di input, prima che venga codificata. Il valore predefinito è Auto

Nome	Tipo	Descrizione
Auto	string	Rilevare e ruotare automaticamente in base alle esigenze.
None	string	Non ruotare il video. Se il formato di output lo supporta, tutti i metadati relativi alla rotazione vengono mantenuti intatti.
Rotate0	string	Non ruotare il video ma rimuovere i metadati relativi alla rotazione.
Rotate180	string	Ruotare a 180 gradi in senso orario.
Rotate270	string	Ruotare a 270 gradi in senso orario.
Rotate90	string	Ruotare a 90 gradi in senso orario.

StandardEncoderPreset

Descrive tutte le impostazioni da usare durante la codifica del video di input con il codificatore Standard.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.StandardEncoderPreset	Discriminazione per i tipi derivati.
codecs	Codec[]: AacAudio[] Audio[] CopyAudio[] CopyVideo[] DDAudio[] H264Video[] H265Video[] Image[] JpgImage[] PngImage[] Video[]	Elenco di codec da usare durante la codifica del video di input.
experimentalOptions	object	Dizionario contenente coppie di valori chiave per i parametri non esposti nel set di impostazioni stesso
filters	Filters	Una o più operazioni di filtro applicate al supporto di input prima della codifica.
formats	Format[]: ImageFormat[] JpgFormat[] Mp4Format[] MultiBitrateFormat[] PngFormat[] TransportStreamFormat[]	Elenco di output da produrre dal codificatore.

StretchMode

Modalità di ridimensionamento: come verrà ridimensionato il video di input per adattare le risoluzioni di output desiderate. Il valore predefinito è AutoSize

Nome	Tipo	Descrizione
AutoFit	string	Eseguire il pad dell'output (con casella di posta o colonna) per rispettare la risoluzione dell'output, assicurandosi che l'area video attiva nell'output abbia lo stesso rapporto di aspetto dell'input. Ad esempio, se l'input è 1920x1080 e il set di impostazioni di codifica richiede 1280x1280, l'output sarà a 1280x1280, che contiene un rettangolo interno pari a 1280x720 a proporzioni pari a 16:9 e le aree della casella di colonna 280 pixel a sinistra e destra.
AutoSize	string	Eseguire l'override della risoluzione dell'output e modificarla in modo che corrisponda al rapporto di aspetto visualizzato dell'input, senza spaziatura interna. Ad esempio, se l'input è 1920x1080 e il set di impostazioni di codifica richiede 1280x1280, il valore nel set di impostazioni viene sottoposto a override e l'output sarà a 1280x720, che mantiene il rapporto di aspetto di input 16:9.
None	string	Rispettare rigorosamente la risoluzione dell'output senza considerare le proporzioni dei pixel o le proporzioni dello schermo del video di input.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione di risorse (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima risorsa.

Transform

Un oggetto Transform incapsula le regole o le istruzioni per la generazione di output desiderati da supporti di input, ad esempio tramite la transcodatura o l'estrazione di informazioni dettagliate. Dopo aver creato la trasformazione, può essere applicata ai supporti di input creando processi.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	nome della risorsa.
properties.created	string	Data e ora UTC in cui l'oggetto Transform è stato creato, nel formato"AAAA-MM-GGhh:mm:ssZ".
properties.description	string	Descrizione dettagliata facoltativa dell'oggetto Transform.
properties.lastModified	string	Data e ora UTC in cui l'oggetto Transform è stato aggiornato, nel formato"AAAA-MM-GGhh:mm:ssZ".
properties.outputs	TransformOutput[]	Matrice di una o più proprietà TransformOutputs che l'oggetto Transform deve generare.
systemData	systemData	Metadati di sistema relativi a questa risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TransformOutput

Descrive le proprietà di un oggetto TransformOutput, che sono le regole da applicare durante la generazione dell'output desiderato.

Nome	Tipo	Descrizione
onError	OnErrorType	Una trasformazione può definire più di un output. Questa proprietà definisce le operazioni che il servizio deve eseguire quando un output ha esito negativo: continuare a produrre altri output o arrestare gli altri output. Lo stato complessivo del processo non riflette gli errori di output specificati con 'ContinueJob'. Il valore predefinito è "StopProcessingJob".
preset	Preset: AudioAnalyzerPreset BuiltInStandardEncoderPreset FaceDetectorPreset StandardEncoderPreset VideoAnalyzerPreset	Impostazione predefinita che descrive le operazioni che verranno usate per modificare, transcodificare o estrarre informazioni dettagliate dal file di origine per generare l'output.
relativePriority	Priority	Imposta la priorità relativa dei TransformOutputs all'interno di una trasformazione. In questo modo viene impostata la priorità usata dal servizio per l'elaborazione di TransformOutputs. La priorità predefinita è Normale.

TransportStreamFormat

Descrive le proprietà per la generazione di file video di output MPEG-2 Transport Stream (ISO/IEC 13818-1).

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.TransportStreamFormat	Il discriminatorio per i tipi derivati.
filenamePattern	string	Modello di denominazione dei file utilizzato per la creazione di file di output. Nel nome file sono supportate le macro seguenti: {Basename} - Macro di espansione che userà il nome del file video di input. Se il nome di base (il suffisso del file non è incluso) del file video di input è composto da meno di 32 caratteri, verrà usato il nome di base dei file video di input. Se la lunghezza del nome di base del file video di input supera i 32 caratteri, il nome di base viene troncato ai primi 32 caratteri in lunghezza totale. {Extension} - Estensione appropriata per questo formato. {Label} - Etichetta assegnata al codec/livello. {Index} - Indice univoco per le anteprime. Applicabile solo alle anteprime. {AudioStream} - stringa "Audio" più numero di flusso audio(a partire da 1). {Bitrate} - Velocità in bit audio/video in kbps. Non applicabile alle anteprime. {Codec} - Tipo di codec audio/video. {Resolution} - Risoluzione video. Tutte le macro non inviate verranno compresse e rimosse dal nome file.
outputFiles	OutputFile[]	Elenco di file di output da produrre. Ogni voce nell'elenco è un set di etichette di livello audio e video da spostare insieme.

Video

Descrive le proprietà di base per la codifica del video di input.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.Video	Discriminazione per i tipi derivati.
keyFrameInterval	string	Distanza tra due fotogrammi chiave. Il valore deve essere diverso da zero nell'intervallo [0,5, 20] secondi, specificato in formato ISO 8601. Il valore predefinito è 2 secondi(PT2S). Si noti che questa impostazione viene ignorata se è impostato VideoSyncMode.Pass through, in cui il valore KeyFrameInterval seguirà l'impostazione di origine di input.
label	string	Etichetta facoltativa per il codec. L'etichetta può essere usata per controllare il comportamento di muxing.
stretchMode	StretchMode	Modalità di ridimensionamento: come verrà ridimensionato il video di input per adattare le risoluzioni di output desiderate. Il valore predefinito è AutoSize
syncMode	VideoSyncMode	Modalità di sincronizzazione video

VideoAnalyzerPreset

Set di impostazioni di analizzatore video che estrae informazioni dettagliate (metadati avanzati) sia dall'audio che dal video e restituisce un file di formato JSON.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.VideoAnalyzerPreset	Il discriminatorio per i tipi derivati.
audioLanguage	string	Lingua per il payload audio nell'input usando il formato BCP-47 di 'language tag-region' (ad esempio"en-US"). Se si conosce la lingua del contenuto, è consigliabile specificarla. La lingua deve essere specificata in modo esplicito per AudioAnalysisMode::Basic, poiché il rilevamento automatico della lingua non è incluso in modalità di base. Se la lingua non è specificata o impostata su Null, il rilevamento automatico della lingua sceglierà la prima lingua rilevata e utilizzerà la lingua selezionata per la durata del file. Attualmente non supporta il passaggio dinamico tra lingue dopo il rilevamento della prima lingua. Il rilevamento automatico funziona meglio con le registrazioni audio con riconoscimento vocale chiaramente riconoscibile. Se il rilevamento automatico non riesce a trovare la lingua, la trascrizione fallback in "en-US". L'elenco delle lingue supportate è disponibile qui: https://go.microsoft.com/fwlink/?linkid=2109463
experimentalOptions	object	Dizionario contenente coppie chiave-valore per i parametri non esposti nel set di impostazioni stesso
insightsToExtract	InsightsType	Definisce il tipo di informazioni dettagliate che si desidera che il servizio generi. I valori consentiti sono "AudioInsightsOnly", "VideoInsightsOnly" e "AllInsights". Il valore predefinito è AllInsights. Se si imposta questa opzione su AllInsights e l'input è solo audio, vengono generate solo informazioni audio. Analogamente, se l'input è solo video, vengono generate solo informazioni video. È consigliabile non usare AudioInsightsOnly se si prevede che alcuni degli input siano solo video; o usare VideoInsightsOnly se si prevede che alcuni degli input siano solo audio. I processi in tali condizioni potrebbero essere eseguiti errori.
mode	AudioAnalysisMode	Determina il set di operazioni di analisi audio da eseguire. Se non specificato, verrà scelto AudioAnalysisMode standard.

VideoOverlay

Descrive le proprietà di una sovrapposizione video.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Media.VideoOverlay	Discriminazione per i tipi derivati.
audioGainLevel	number	Livello di aumento dell'audio nella sovrapposizione. Il valore deve trovarsi nell'intervallo [0, 1.0]. Il valore predefinito è 1.0.
cropRectangle	Rectangle	Finestra rettangolare facoltativa usata per ritagliare l'immagine di sovrapposizione o il video.
end	string	Posizione finale, con riferimento al video di input, in corrispondenza del quale termina la sovrapposizione. Il valore deve essere in formato ISO 8601. Ad esempio, PT30S per terminare la sovrapposizione a 30 secondi nel video di input. Se non è specificato o il valore è maggiore della durata del video di input, la sovrapposizione verrà applicata fino alla fine del video di input se la durata del supporto di sovrapposizione è maggiore della durata del video di input, altrimenti la sovrapposizione durerà fino alla durata del supporto di sovrapposizione.
fadeInDuration	string	Durata in cui la sovrapposizione si dissolve nel video di input. Il valore deve essere in formato di durata ISO 8601. Se non è specificato il comportamento predefinito, il comportamento predefinito non deve essere predefinito (uguale a PT0S).
fadeOutDuration	string	Durata in cui la sovrapposizione si dissolve dal video di input. Il valore deve essere in formato di durata ISO 8601. Se non è specificato il comportamento predefinito, non deve essere disattivato (uguale a PT0S).
inputLabel	string	Etichetta dell'input del processo da usare come sovrimpressione. L'input deve specificare esattamente un file. È possibile specificare un file di immagine in formato JPG, PNG, GIF o BMP o un file audio (ad esempio un file WAV, MP3, WMA o M4A) o un file video. Per l'elenco completo dei formati di file audio e video supportati, vedere https://aka.ms/mesformats l'elenco completo dei formati di file audio e video supportati.
opacity	number	Opacità della sovrapposizione. Si tratta di un valore nell'intervallo [0 - 1.0]. Il valore predefinito è 1.0 che significa che la sovrapposizione è opaca.
position	Rectangle	Posizione nel video di input in cui viene applicata la sovrapposizione.
start	string	Posizione iniziale, con riferimento al video di input, in corrispondenza del quale viene avviata la sovrapposizione. Il valore deve essere in formato ISO 8601. Ad esempio, PT05S per avviare la sovrapposizione a 5 secondi nel video di input. Se non specificato, la sovrapposizione inizia dall'inizio del video di input.

VideoSyncMode

Modalità di sincronizzazione video

Nome	Tipo	Descrizione
Auto	string	Si tratta del metodo predefinito. Sceglie tra Cfr e Vfr a seconda delle funzionalità muxer. Per il formato di output MP4, la modalità predefinita è Cfr.
Cfr	string	I fotogrammi di input verranno ripetuti e/o eliminati in base alle esigenze per ottenere esattamente la frequenza di fotogrammi costanti richiesta. Consigliato quando la frequenza dei fotogrammi di output viene impostata in modo esplicito su un valore specificato
Passthrough	string	I timestamp di presentazione nei frame vengono passati dal file di input al writer di file di output. Consigliato quando l'origine di input ha la frequenza dei fotogrammi variabile e tenta di produrre più livelli per lo streaming adattivo nell'output che ha allineato i limiti GOP. Nota: se due o più fotogrammi nell'input hanno timestamp duplicati, l'output avrà anche lo stesso comportamento
Vfr	string	Analogamente alla modalità Pass through, ma se l'input ha fotogrammi con timestamp duplicati, viene passato un solo frame all'output e altri vengono eliminati. Consigliato quando si prevede che il numero di fotogrammi di output sia uguale al numero di fotogrammi di input. Ad esempio, l'output viene usato per calcolare una metrica di qualità come PSNR rispetto all'input