Transforms - Create Or Update

Usługa:

Media Services

Wersja interfejsu API:

2022-07-01

Tworzenie lub aktualizowanie przekształcenia
Tworzy lub aktualizuje nową transformację.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string	Nazwa konta usługi Media Services.
resourceGroupName	path	True	string	Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
subscriptionId	path	True	string	Unikatowy identyfikator subskrypcji platformy Microsoft Azure.
transformName	path	True	string	Nazwa przekształcenia.
api-version	query	True	string	Wersja interfejsu API do użycia z żądaniem klienta.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties.outputs	True	TransformOutput[]	Tablica z co najmniej jedną tabelą TransformOutputs, którą powinna wygenerować transformacja.
properties.description		string	Opcjonalny pełny opis przekształcenia.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Transform	OK
201 Created	Transform	Utworzone
Other Status Codes	ErrorResponse	Szczegółowe informacje o błędzie.

Przykłady

Create or update a Transform

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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"
  }
}

Kod stanu:

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"
  }
}

Definicje

Nazwa	Opis
AacAudio	Opisuje ustawienia kodowania audio Advanced Audio Codec (AAC).
AacAudioProfile	Profil kodowania, który ma być używany podczas kodowania dźwięku za pomocą usługi AAC.
AnalysisResolution	Określa maksymalną rozdzielczość, w której jest analizowane wideo. Domyślnym zachowaniem jest "SourceResolution", który zachowa wejściowy film wideo w oryginalnej rozdzielczości podczas analizowania. Użycie opcji "StandardDefinition" spowoduje zmianę rozmiaru wejściowych filmów wideo na standardową definicję przy zachowaniu odpowiedniego współczynnika proporcji. Zmiana rozmiaru będzie zmieniana tylko wtedy, gdy wideo ma wyższą rozdzielczość. Na przykład dane wejściowe 1920x1080 zostaną przeskalowane do 640x360 przed przetworzeniem. Przełączenie na "StandardDefinition" skróci czas przetwarzania wideo o wysokiej rozdzielczości. Może również zmniejszyć koszt korzystania z tego składnika (zobacz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics szczegółowe informacje). Jednak twarze, które są zbyt małe w zmienionym rozmiarze wideo, mogą nie zostać wykryte.
Audio	Definiuje wspólne właściwości wszystkich koderów audio.
AudioAnalysisMode	Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrana opcja Standard AudioAnalysisMode.
AudioAnalyzerPreset	Ustawienie wstępne analizatora audio stosuje wstępnie zdefiniowany zestaw operacji analizy opartych na sztucznej inteligencji, w tym transkrypcję mowy. Obecnie ustawienie wstępne obsługuje przetwarzanie zawartości za pomocą pojedynczej ścieżki audio.
AudioOverlay	Opisuje właściwości nakładki audio.
BlurType	Typ rozmycia
BuiltInStandardEncoderPreset	Opisuje wbudowane ustawienie wstępne kodowania wejściowego wideo za pomocą kodera standardowego.
Complexity	Umożliwia skonfigurowanie ustawień kodera w celu kontrolowania równowagi między szybkością a jakością. Przykład: ustaw wartość Złożoność jako Szybkość, aby przyspieszyć kodowanie, ale zmniejszyć wydajność kompresji.
CopyAudio	Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego audio.
CopyVideo	Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego wideo bez ponownego kodowania.
createdByType	Typ tożsamości, która utworzyła zasób.
DDAudio	Opisuje ustawienia kodowania dźwięku dolby Digital Audio Codec (AC3). Bieżąca implementacja obsługi dźwięku cyfrowego dolby to: numery kanałów audio na 1((mono), 2(stereo), 6(5.1side); Częstotliwość próbkowania audio na poziomie: 32K/44,1K/48K Hz; Wartości szybkości transmisji bitów audio jako specyfikacja AC3 obsługują: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 64000 bps.
Deinterlace	Opisuje ustawienia usuwania przeplotów.
DeinterlaceMode	Tryb deinterlacingu. Wartość domyślna to AutoPixelAdaptive.
DeinterlaceParity	Parzystość pól dla usuwania przeplotu domyślnie to Auto.
EncoderNamedPreset	Wbudowane ustawienie wstępne, które ma być używane do kodowania filmów wideo.
EntropyMode	Tryb entropii, który ma być używany dla tej warstwy. Jeśli nie zostanie określony, koder wybierze tryb odpowiedni dla profilu i poziomu.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
FaceDetectorPreset	Opisuje wszystkie ustawienia, które mają być używane podczas analizowania wideo w celu wykrycia (i opcjonalnie redagowania) wszystkich obecnych twarzy.
FaceRedactorMode	Ten tryb umożliwia wybór między następującymi ustawieniami: 1) Analizowanie — tylko do wykrywania. Ten tryb generuje metadanych wyglądy plików JSON twarzy w całym filmie wideo. Tam, gdzie to możliwe, do tej samej osoby przypisano ten sam identyfikator. 2) Połączone — dodatkowo wykrywane twarze są redacts (rozmycia). 3) Redact — umożliwia to proces 2-przekazywania, co umożliwia selektywne redagowanie podzestawu wykrytych twarzy. Pobiera on plik metadanych z poprzedniego przebiegu analizy wraz ze źródłowym filmem wideo oraz podzbiorem identyfikatorów wybranych przez użytkownika, które wymagają ponownego przeprowadzenia analizy.
Fade	Opisuje właściwości efektu zanikania zastosowanego do nośnika wejściowego.
Filters	Opisuje wszystkie operacje filtrowania, takie jak usuwanie przeplotu, rotacja itp., które mają być stosowane do nośnika wejściowego przed kodowaniem.
H264Complexity	Informuje koder, jak wybrać jego ustawienia kodowania. Wartość domyślna to Zrównoważony.
H264Layer	Opisuje ustawienia, które mają być używane podczas kodowania wejściowego wideo do żądanej warstwy szybkości transmisji bitów wyjściowych za pomocą kodera-dekodera wideo H.264.
H264RateControlMode	Tryb sterowania szybkością wideo
H264Video	Opisuje wszystkie właściwości kodowania wideo za pomocą kodera-dekodera H.264.
H264VideoProfile	Obecnie obsługujemy plan bazowy, main, high, high422, High444. Wartość domyślna to Auto.
H265Complexity	Informuje koder, jak wybrać jego ustawienia kodowania. Jakość zapewni wyższy współczynnik kompresji, ale przy wyższym koszcie i dłuższym czasie obliczeniowym. Szybkość będzie produkować stosunkowo większy plik, ale jest szybszy i bardziej ekonomiczny. Wartość domyślna to Zrównoważony.
H265Layer	Opisuje ustawienia, które mają być używane podczas kodowania wejściowego wideo do żądanej warstwy szybkości transmisji bitów wyjściowych za pomocą kodera-dekodera wideo H.265.
H265Video	Opisuje wszystkie właściwości kodowania wideo za pomocą kodera-dekodera H.265.
H265VideoProfile	Obecnie obsługujemy program Main. Wartość domyślna to Auto.
Image	Opisuje podstawowe właściwości generowania miniatur z wejściowego klipu wideo
ImageFormat	Opisuje właściwości pliku obrazu wyjściowego.
InsightsType	Definiuje typ szczegółowych informacji, które mają być generowane przez usługę. Dozwolone wartości to "AudioInsightsOnly", "VideoInsightsOnly" i "AllInsights". Wartość domyślna to AllInsights. Jeśli ustawisz tę opcję na wartość AllInsights, a dane wejściowe są tylko audio, generowane są tylko szczegółowe informacje o dźwięku. Podobnie, jeśli dane wejściowe są tylko wideo, generowane są tylko szczegółowe informacje wideo. Zaleca się, aby nie używać elementu AudioInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko wideo; lub użyj usługi VideoInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko audio. Twoje zadania w takich warunkach spowodują błąd.
InterleaveOutput	Ustawia tryb przeplotu danych wyjściowych, aby kontrolować sposób przechowywania dźwięku i wideo w formacie kontenera. Przykład: ustaw wartość InterleavedOutput jako NonInterleavedOutput, aby wygenerować dane wyjściowe tylko do audio i wideo w oddzielnych plikach MP4.
JpgFormat	Opisuje ustawienia tworzenia miniatur JPEG.
JpgImage	Opisuje właściwości tworzenia serii obrazów JPEG z wejściowego wideo.
JpgLayer	Opisuje ustawienia służące do tworzenia obrazu JPEG z wejściowego wideo.
Mp4Format	Opisuje właściwości wyjściowego pliku ISO MP4.
MultiBitrateFormat	Opisuje właściwości tworzenia kolekcji plików o wielu szybkościach transmisji bitów wyrównywane przez usługę GOP. Domyślnym zachowaniem jest wygenerowanie jednego pliku wyjściowego dla każdej warstwy wideo, która jest muxed razem ze wszystkimi dźwiękami. Dokładne utworzone pliki wyjściowe można kontrolować, określając kolekcję outputFiles.
OnErrorType	Przekształcenie może definiować więcej niż jedno dane wyjściowe. Ta właściwość określa, co usługa powinna zrobić, gdy jedno wyjście zakończy się niepowodzeniem — kontynuuj tworzenie innych danych wyjściowych lub zatrzymaj inne dane wyjściowe. Ogólny stan zadania nie będzie odzwierciedlał błędów danych wyjściowych określonych za pomocą polecenia "ContinueJob". Wartość domyślna to "StopProcessingJob".
OutputFile	Reprezentuje wygenerowany plik wyjściowy.
PngFormat	Opisuje ustawienia tworzenia miniatur PNG.
PngImage	Opisuje właściwości tworzenia serii obrazów PNG z wejściowego wideo.
PngLayer	Opisuje ustawienia służące do tworzenia obrazu PNG z wejściowego wideo.
PresetConfigurations	Obiekt opcjonalnych ustawień konfiguracji kodera.
Priority	Ustawia względny priorytet funkcji TransformOutputs w ramach przekształcenia. Powoduje to ustawienie priorytetu używanego przez usługę do przetwarzania funkcji TransformOutputs. Domyślny priorytet to Normalny.
Rectangle	Opisuje właściwości okna prostokątnego zastosowanego do nośnika wejściowego przed jego przetworzeniem.
Rotation	Rotacja, jeśli w ogóle, ma zostać zastosowana do wejściowego wideo, zanim zostanie zakodowana. Wartość domyślna to Auto
StandardEncoderPreset	Opisuje wszystkie ustawienia, które mają być używane podczas kodowania wejściowego wideo za pomocą kodera standardowego.
StretchMode	Tryb zmiany rozmiaru — sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to AutoSize
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Transform	Transform hermetyzuje reguły lub instrukcje dotyczące generowania żądanych danych wyjściowych z nośnika wejściowego, takich jak transkodowanie lub wyodrębnianie szczegółowych informacji. Po utworzeniu przekształcenia można go zastosować do nośnika wejściowego, tworząc zadania.
TransformOutput	Opisuje właściwości elementu TransformOutput, które są regułami, które mają być stosowane podczas generowania żądanych danych wyjściowych.
TransportStreamFormat	Opisuje właściwości generowania strumienia transportowego MPEG-2 (ISO/IEC 13818-1) wyjściowych plików wideo.
Video	Opisuje podstawowe właściwości kodowania wejściowego wideo.
VideoAnalyzerPreset	Ustawienie wstępne analizatora wideo, które wyodrębnia szczegółowe informacje (rozbudowane metadane) zarówno z audio, jak i wideo, i generuje plik formatu JSON.
VideoOverlay	Opisuje właściwości nakładki wideo.
VideoSyncMode	Tryb synchronizacji wideo

AacAudio

Opisuje ustawienia kodowania audio Advanced Audio Codec (AAC).

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.AacAudio	Dyskryminator typów pochodnych.
bitrate	integer	Szybkość transmisji bitów w bitach na sekundę z zakodowanego dźwięku wyjściowego.
channels	integer	Liczba kanałów w dźwięku.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxing.
profile	AacAudioProfile	Profil kodowania, który ma być używany podczas kodowania dźwięku za pomocą funkcji AAC.
samplingRate	integer	Częstotliwość próbkowania używana do kodowania w hertz.

AacAudioProfile

Profil kodowania, który ma być używany podczas kodowania dźwięku za pomocą usługi AAC.

Nazwa	Typ	Opis
AacLc	string	Określa, że dźwięk wyjściowy ma być zakodowany w profilu AAC Low Complexity (AAC-LC).
HeAacV1	string	Określa, że dźwięk wyjściowy ma być zakodowany w profilu HE-AAC v1.
HeAacV2	string	Określa, że dźwięk wyjściowy ma być zakodowany w profilu HE-AAC v2.

AnalysisResolution

Określa maksymalną rozdzielczość, w której jest analizowane wideo. Domyślnym zachowaniem jest "SourceResolution", który zachowa wejściowy film wideo w oryginalnej rozdzielczości podczas analizowania. Użycie opcji "StandardDefinition" spowoduje zmianę rozmiaru wejściowych filmów wideo na standardową definicję przy zachowaniu odpowiedniego współczynnika proporcji. Zmiana rozmiaru będzie zmieniana tylko wtedy, gdy wideo ma wyższą rozdzielczość. Na przykład dane wejściowe 1920x1080 zostaną przeskalowane do 640x360 przed przetworzeniem. Przełączenie na "StandardDefinition" skróci czas przetwarzania wideo o wysokiej rozdzielczości. Może również zmniejszyć koszt korzystania z tego składnika (zobacz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics szczegółowe informacje). Jednak twarze, które są zbyt małe w zmienionym rozmiarze wideo, mogą nie zostać wykryte.

Nazwa	Typ	Opis
SourceResolution	string
StandardDefinition	string

Audio

Definiuje wspólne właściwości wszystkich koderów audio.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.Audio	Dyskryminator typów pochodnych.
bitrate	integer	Szybkość transmisji bitów w bitach na sekundę z zakodowanego dźwięku wyjściowego.
channels	integer	Liczba kanałów w dźwięku.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxingu.
samplingRate	integer	Częstotliwość próbkowania używana do kodowania w hertz.

AudioAnalysisMode

Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrana opcja Standard AudioAnalysisMode.

Nazwa	Typ	Opis
Basic	string	Ten tryb wykonuje transkrypcję zamiany mowy na tekst i generowanie pliku podtytułu/podpis VTT. Dane wyjściowe tego trybu obejmują plik JSON szczegółowych informacji, w tym tylko słowa kluczowe, transkrypcję i informacje o chronometrażu. Automatyczne wykrywanie języka i diaryzacja osoby mówiącej nie są uwzględniane w tym trybie.
Standard	string	Wykonuje wszystkie operacje zawarte w trybie Podstawowym, dodatkowo wykonując wykrywanie języka i diaryzacja osoby mówiącej.

AudioAnalyzerPreset

Ustawienie wstępne analizatora audio stosuje wstępnie zdefiniowany zestaw operacji analizy opartych na sztucznej inteligencji, w tym transkrypcję mowy. Obecnie ustawienie wstępne obsługuje przetwarzanie zawartości za pomocą pojedynczej ścieżki audio.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.AudioAnalyzerPreset	Dyskryminator typów pochodnych.
audioLanguage	string	Język ładunku audio w danych wejściowych przy użyciu formatu BCP-47 "language tag-region" (np. "en-US"). Jeśli znasz język zawartości, zaleca się jej określenie. Język musi być określony jawnie dla AudioAnalysisMode::Basic, ponieważ automatyczne wykrywanie języka nie jest uwzględniane w trybie podstawowym. Jeśli język nie jest określony lub ustawiony na wartość null, automatyczne wykrywanie języka wybierze pierwszy wykryty język i przetworzy go przy użyciu wybranego języka na czas trwania pliku. Obecnie nie obsługuje dynamicznego przełączania między językami po wykryciu pierwszego języka. Automatyczne wykrywanie działa najlepiej w przypadku nagrań audio z wyraźnie rozpoznawalną mową. Jeśli automatyczne wykrywanie nie znajdzie języka, transkrypcja wróci do "en-US". Lista obsługiwanych języków jest dostępna tutaj: https://go.microsoft.com/fwlink/?linkid=2109463
experimentalOptions	object	Słownik zawierający pary wartości klucza dla parametrów, które nie są widoczne w samym ustawieniu wstępnym
mode	AudioAnalysisMode	Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrana opcja Standard AudioAnalysisMode.

AudioOverlay

Opisuje właściwości nakładki audio.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.AudioOverlay	Dyskryminator typów pochodnych.
audioGainLevel	number	Poziom zysku dźwięku w nakładce. Wartość powinna znajdować się w zakresie [0, 1.0]. Wartość domyślna to 1.0.
end	string	Położenie końcowe z odwołaniem do wejściowego wideo, na którym kończy się nakładka. Wartość powinna być w formacie ISO 8601. Na przykład PT30S, aby zakończyć nakładkę na 30 sekund w wejściowym filmie wideo. Jeśli nie zostanie określona lub wartość jest większa niż czas trwania wejściowego wideo, nakładka zostanie zastosowana do końca wejściowego wideo, jeśli czas trwania nośnika nakładki jest większy niż czas trwania wejściowego wideo, w przeciwnym razie nakładka będzie trwać tak długo, jak długo trwa czas trwania nośnika nakładki.
fadeInDuration	string	Czas trwania, przez który nakładka zanika na wejściowym filmie wideo. Wartość powinna być w formacie czasu trwania ISO 8601. Jeśli nie określono domyślnego zachowania, nie ma zanikania (tak samo jak PT0S).
fadeOutDuration	string	Czas trwania, przez który nakładka zanika z wejściowego wideo. Wartość powinna być w formacie czasu trwania ISO 8601. Jeśli nie określono domyślnego zachowania, nie ma zanikania (tak samo jak PT0S).
inputLabel	string	Etykieta danych wejściowych zadania, które mają być używane jako nakładka. Dane wejściowe muszą określać dokładnie jeden plik. Można określić plik obrazu w formacie JPG, PNG, GIF lub BMP albo pliku audio (takiego jak plik WAV, MP3, WMA lub M4A) albo plik wideo. Zobacz https://aka.ms/mesformats pełną listę obsługiwanych formatów plików audio i wideo.
start	string	Pozycja początkowa, z odwołaniem do wejściowego wideo, na którym rozpoczyna się nakładka. Wartość powinna być w formacie ISO 8601. Na przykład PT05S, aby uruchomić nakładkę na 5 sekund do wejściowego wideo. Jeśli nie określono nakładki, rozpoczyna się od początku wejściowego wideo.

BlurType

Typ rozmycia

Nazwa	Typ	Opis
Black	string	Czarny: Filtr zaciemniania
Box	string	Pole: filtr debugowania, tylko pole ograniczenia
High	string	Wysoki: mylące filtr rozmycia
Low	string	Niski: filtr rozmycia samochodu pudełkowego
Med	string	Med: Filtr rozmycia Gaussian

BuiltInStandardEncoderPreset

Opisuje wbudowane ustawienie wstępne kodowania wejściowego wideo za pomocą kodera standardowego.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.BuiltInStandardEncoderPreset	Dyskryminator typów pochodnych.
configurations	PresetConfigurations	Opcjonalne ustawienia konfiguracji kodera. Konfiguracje są obsługiwane tylko w przypadku elementów ContentAwareEncoding i H265ContentAwareEncoding BuiltInStandardEncoderPreset.
presetName	EncoderNamedPreset	Wbudowane ustawienie wstępne, które ma być używane do kodowania filmów wideo.

Complexity

Umożliwia skonfigurowanie ustawień kodera w celu kontrolowania równowagi między szybkością a jakością. Przykład: ustaw wartość Złożoność jako Szybkość, aby przyspieszyć kodowanie, ale zmniejszyć wydajność kompresji.

Nazwa	Typ	Opis
Balanced	string	Konfiguruje koder do używania ustawień, które zapewniają równowagę między szybkością i jakością.
Quality	string	Konfiguruje koder tak, aby używał ustawień zoptymalizowanych pod kątem generowania danych wyjściowych o wyższej jakości kosztem wolniejszego ogólnego czasu kodowania.
Speed	string	Konfiguruje koder do używania ustawień zoptymalizowanych pod kątem szybszego kodowania. Jakość jest poświęcana w celu skrócenia czasu kodowania.

CopyAudio

Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego audio.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.CopyAudio	Dyskryminator typów pochodnych.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxingu.

CopyVideo

Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego wideo bez ponownego kodowania.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.CopyVideo	Dyskryminator typów pochodnych.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxingu.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

DDAudio

Opisuje ustawienia kodowania dźwięku dolby Digital Audio Codec (AC3). Bieżąca implementacja obsługi dźwięku cyfrowego dolby to: numery kanałów audio na 1((mono), 2(stereo), 6(5.1side); Częstotliwość próbkowania audio na poziomie: 32K/44,1K/48K Hz; Wartości szybkości transmisji bitów audio jako specyfikacja AC3 obsługują: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 64000 bps.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.DDAudio	Dyskryminujący dla typów pochodnych.
bitrate	integer	Szybkość transmisji bitów w bitach na sekundę w danych wyjściowych zakodowanych audio.
channels	integer	Liczba kanałów w dźwięku.
label	string	Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.
samplingRate	integer	Częstotliwość próbkowania do użycia do kodowania w hertz.

Deinterlace

Opisuje ustawienia usuwania przeplotów.

Nazwa	Typ	Opis
mode	DeinterlaceMode	Tryb deinterlacingu. Wartość domyślna to AutoPixelAdaptive.
parity	DeinterlaceParity	Parzystość pól dla usuwania przeplotu domyślnie to Auto.

DeinterlaceMode

Tryb deinterlacingu. Wartość domyślna to AutoPixelAdaptive.

Nazwa	Typ	Opis
AutoPixelAdaptive	string	Zastosuj automatyczne adaptacyjne przeplatanie pikseli na każdej klatce w wejściowym filmie wideo.
Off	string	Wyłącza usuwanie przeplotu źródłowego wideo.

DeinterlaceParity

Parzystość pól dla usuwania przeplotu domyślnie to Auto.

Nazwa	Typ	Opis
Auto	string	Automatyczne wykrywanie kolejności pól
BottomFieldFirst	string	Najpierw zastosuj dolne pole przetwarzania wejściowego wideo.
TopFieldFirst	string	Zastosuj pierwsze przetwarzanie danych wejściowych wideo z pierwszego pola górnego.

EncoderNamedPreset

Wbudowane ustawienie wstępne, które ma być używane do kodowania filmów wideo.

Nazwa	Typ	Opis
AACGoodQualityAudio	string	Tworzy pojedynczy plik MP4 zawierający tylko dźwięk stereo AAC zakodowany na 192 kb/s.
AdaptiveStreaming	string	Tworzy zestaw plików MP4 wyrównanych GOP z wideo H.264 i dźwięk stereo AAC. Automatycznie generuje drabinę szybkości transmisji bitów w oparciu o rozdzielczość danych wejściowych, szybkość transmisji bitów i szybkość klatek. Automatycznie generowane ustawienie wstępne nigdy nie przekroczy rozdzielczości danych wejściowych. Jeśli na przykład dane wejściowe mają wartość 720p, dane wyjściowe pozostaną w najlepszym stanie 720p.
ContentAwareEncoding	string	Tworzy zestaw plików MP4 dostosowanych do protokołu GOP przy użyciu kodowania obsługującego zawartość. Biorąc pod uwagę dowolną zawartość wejściową, usługa wykonuje początkową lekką analizę zawartości wejściowej i używa wyników do określenia optymalnej liczby warstw, odpowiedniej szybkości transmisji bitów i ustawień rozdzielczości na potrzeby dostarczania przez adaptacyjne przesyłanie strumieniowe. To ustawienie wstępne jest szczególnie skuteczne w przypadku filmów wideo o niskiej i średniej złożoności, gdzie pliki wyjściowe będą mieć niższą szybkość bitów, ale przy jakości, która nadal zapewnia dobre środowisko dla osób przeglądających. Dane wyjściowe będą zawierać pliki MP4 z przeplotem wideo i audio.
ContentAwareEncodingExperimental	string	Uwidacznia eksperymentalne ustawienie wstępne kodowania obsługującego zawartość. Biorąc pod uwagę dowolną zawartość wejściową, usługa próbuje automatycznie określić optymalną liczbę warstw, odpowiednią szybkość transmisji bitów i ustawienia rozdzielczości do dostarczania przez adaptacyjne przesyłanie strumieniowe. Podstawowe algorytmy będą nadal ewoluować wraz z upływem czasu. Dane wyjściowe będą zawierać pliki MP4 z przeplotem wideo i audio.
CopyAllBitrateNonInterleaved	string	Skopiuj wszystkie strumienie wideo i audio z zasobu wejściowego jako nieprzeplatane pliki wyjściowe wideo i audio. To ustawienie wstępne może służyć do przycinania istniejącego elementu zawartości lub konwertowania grupy plików MP4 wyrównanych do grupy klawiszy (GOP) jako elementu zawartości, który można przesyłać strumieniowo.
DDGoodQualityAudio	string	Tworzy pojedynczy plik MP4 zawierający tylko dźwięk stereo DD(Digital Dolby) zakodowany na 192 kb/s.
H264MultipleBitrate1080p	string	Tworzy zestaw plików MP4 wyrównanych z 8 GOP, od 6000 kb/s do 400 kb/s i dźwięk stereo AAC. Rozdzielczość zaczyna się od 1080p i spada do 180p.
H264MultipleBitrate720p	string	Tworzy zestaw plików MP4 wyrównanych do 6 GOP, od 3400 kb/s do 400 kb/s i dźwięk stereo AAC. Rozdzielczość zaczyna się od 720p i spada do 180p.
H264MultipleBitrateSD	string	Tworzy zestaw plików MP4 wyrównanych do 5 GOP, od 1900 kb/s do 400 kb/s i dźwięk stereo AAC. Rozdzielczość zaczyna się od 480p i spada do 240p.
H264SingleBitrate1080p	string	Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera-dekodera H.264 o rozmiarze 6750 kb/s i wysokości obrazu 1080 pikseli, a dźwięk stereo jest kodowany za pomocą kodera kodera AAC-LC o rozmiarze 128 kb/s.
H264SingleBitrate720p	string	Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera-dekodera H.264 o rozmiarze 4500 kb/s i wysokości obrazu 720 pikseli, a dźwięk stereo jest kodowany za pomocą kodera-dekodera AAC-LC o rozmiarze 128 kb/s.
H264SingleBitrateSD	string	Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera-dekodera H.264 o rozmiarze 2200 kb/s i wysokości obrazu 480 pikseli, a dźwięk stereo jest kodowany za pomocą kodera-dekodera AAC-LC o rozmiarze 128 kb/s.
H265AdaptiveStreaming	string	Tworzy zestaw plików MP4 wyrównanych GOP z wideo H.265 i dźwięk stereo AAC. Automatycznie generuje drabinę szybkości transmisji bitów w oparciu o rozdzielczość danych wejściowych, szybkość transmisji bitów i szybkość klatek. Automatycznie generowane ustawienie wstępne nigdy nie przekroczy rozdzielczości danych wejściowych. Jeśli na przykład dane wejściowe mają wartość 720p, dane wyjściowe pozostaną w najlepszym stanie 720p.
H265ContentAwareEncoding	string	Tworzy zestaw plików MP4 dostosowanych do protokołu GOP przy użyciu kodowania obsługującego zawartość. Biorąc pod uwagę dowolną zawartość wejściową, usługa wykonuje początkową lekką analizę zawartości wejściowej i używa wyników do określenia optymalnej liczby warstw, odpowiedniej szybkości transmisji bitów i ustawień rozdzielczości na potrzeby dostarczania przez adaptacyjne przesyłanie strumieniowe. To ustawienie wstępne jest szczególnie skuteczne w przypadku filmów wideo o niskiej i średniej złożoności, gdzie pliki wyjściowe będą mieć niższą szybkość bitów, ale przy jakości, która nadal zapewnia dobre środowisko dla osób przeglądających. Dane wyjściowe będą zawierać pliki MP4 z przeplotem wideo i audio.
H265SingleBitrate1080p	string	Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera-dekodera H.265 o rozmiarze 3500 kb/s i wysokości obrazu 1080 pikseli, a dźwięk stereo jest kodowany za pomocą kodera kodera AAC-LC o rozmiarze 128 kb/s.
H265SingleBitrate4K	string	Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera-dekodera H.265 o rozmiarze 9500 kb/s i wysokości obrazu 2160 pikseli, a dźwięk stereo jest kodowany za pomocą kodera-dekodera AAC-LC o rozmiarze 128 kb/s.
H265SingleBitrate720p	string	Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera-dekodera H.265 o rozmiarze 1800 kb/s i wysokości obrazu 720 pikseli, a dźwięk stereo jest kodowany za pomocą kodera-dekodera AAC-LC o rozmiarze 128 kb/s.

EntropyMode

Tryb entropii, który ma być używany dla tej warstwy. Jeśli nie zostanie określony, koder wybierze tryb odpowiedni dla profilu i poziomu.

Nazwa	Typ	Opis
Cabac	string	Kodowanie entropii entropii adaptacyjnej binarnej (CABAC) z adaptacyjną wartością binarną.
Cavlc	string	Kodowanie entropii z adaptacyjną długością zmiennej kontekstowej (CAVLC).

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

FaceDetectorPreset

Opisuje wszystkie ustawienia, które mają być używane podczas analizowania wideo w celu wykrycia (i opcjonalnie redagowania) wszystkich obecnych twarzy.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.FaceDetectorPreset	Dyskryminator typów pochodnych.
blurType	BlurType	Typ rozmycia
experimentalOptions	object	Słownik zawierający pary wartości klucza dla parametrów, które nie są widoczne w samym ustawieniu wstępnym
mode	FaceRedactorMode	Ten tryb umożliwia wybór między następującymi ustawieniami: 1) Analizowanie — tylko do wykrywania. Ten tryb generuje metadanych wyglądy plików JSON twarzy w całym filmie wideo. Tam, gdzie to możliwe, do tej samej osoby przypisano ten sam identyfikator. 2) Połączone — dodatkowo wykrywane twarze są redacts (rozmycia). 3) Redact — umożliwia to proces 2-przekazywania, co umożliwia selektywne redagowanie podzestawu wykrytych twarzy. Pobiera on plik metadanych z poprzedniego przebiegu analizy wraz ze źródłowym filmem wideo oraz podzbiorem identyfikatorów wybranych przez użytkownika, które wymagają ponownego przeprowadzenia analizy.
resolution	AnalysisResolution	Określa maksymalną rozdzielczość, w której jest analizowane wideo. Domyślnym zachowaniem jest "SourceResolution", który zachowa wejściowy film wideo w oryginalnej rozdzielczości podczas analizowania. Użycie opcji "StandardDefinition" spowoduje zmianę rozmiaru wejściowych filmów wideo na standardową definicję przy zachowaniu odpowiedniego współczynnika proporcji. Zmiana rozmiaru będzie zmieniana tylko wtedy, gdy wideo ma wyższą rozdzielczość. Na przykład dane wejściowe 1920x1080 zostaną przeskalowane do 640x360 przed przetworzeniem. Przełączenie na "StandardDefinition" skróci czas przetwarzania wideo o wysokiej rozdzielczości. Może również zmniejszyć koszt korzystania z tego składnika (zobacz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics szczegółowe informacje). Jednak twarze, które są zbyt małe w zmienionym rozmiarze wideo, mogą nie zostać wykryte.

FaceRedactorMode

Ten tryb umożliwia wybór między następującymi ustawieniami: 1) Analizowanie — tylko do wykrywania. Ten tryb generuje metadanych wyglądy plików JSON twarzy w całym filmie wideo. Tam, gdzie to możliwe, do tej samej osoby przypisano ten sam identyfikator. 2) Połączone — dodatkowo wykrywane twarze są redacts (rozmycia). 3) Redact — umożliwia to proces 2-przekazywania, co umożliwia selektywne redagowanie podzestawu wykrytych twarzy. Pobiera on plik metadanych z poprzedniego przebiegu analizy wraz ze źródłowym filmem wideo oraz podzbiorem identyfikatorów wybranych przez użytkownika, które wymagają ponownego przeprowadzenia analizy.

Nazwa	Typ	Opis
Analyze	string	Tryb analizy wykrywa twarze i generuje plik metadanych z wynikami. Umożliwia edytowanie pliku metadanych przed rozmyciem twarzy w trybie redact.
Combined	string	Tryb połączony wykonuje kroki Analizy i Redact w jednym przebiegu podczas edytowania przeanalizowanych twarzy nie jest pożądane.
Redact	string	Tryb redact używa pliku metadanych z trybu analizy i redaguje znalezione twarze.

Fade

Opisuje właściwości efektu zanikania zastosowanego do nośnika wejściowego.

Nazwa	Typ	Opis
duration	string	Czas trwania efektu zanikania w filmie wideo. Wartość może być w formacie ISO 8601 (na przykład PT05S w celu zanikania koloru w ciągu 5 sekund) lub liczby ramek (na przykład 10 do zanikania 10 ramek od czasu rozpoczęcia) lub względnej wartości czasu trwania strumienia (na przykład 10% do zanikania 10% czasu trwania strumienia)
fadeColor	string	Kolor zanikania/wyjętego. może to być kolor https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords na poziomie CSS1 lub wartość RGB/szesnastkowy: np. rgb(255,0,0), 0xFF0000 lub #FF0000
start	string	Pozycja w wejściowym filmie wideo, z którego ma zacząć zanikać. Wartość może być w formacie ISO 8601 (na przykład PT05S, aby rozpocząć się od 5 sekund) lub liczbę ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względną wartość czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Wartość domyślna to 0

Filters

Opisuje wszystkie operacje filtrowania, takie jak usuwanie przeplotu, rotacja itp., które mają być stosowane do nośnika wejściowego przed kodowaniem.

Nazwa	Typ	Opis
crop	Rectangle	Parametry okna prostokątnego, za pomocą którego ma być przycinane wejściowe wideo.
deinterlace	Deinterlace	Ustawienia usuwania przeplotów.
fadeIn	Fade	Opisuje właściwości efektu zanikania zastosowanego do nośnika wejściowego.
fadeOut	Fade	Opisuje właściwości efektu zanikania zastosowanego do nośnika wejściowego.
overlays	Overlay[]: AudioOverlay[] VideoOverlay[]	Właściwości nakładek do zastosowania do wejściowego klipu wideo. Mogą to być nakładki audio, obrazu lub wideo.
rotation	Rotation	Rotacja, jeśli w ogóle, ma zostać zastosowana do wejściowego wideo, zanim zostanie zakodowana. Wartość domyślna to Auto

H264Complexity

Informuje koder, jak wybrać jego ustawienia kodowania. Wartość domyślna to Zrównoważony.

Nazwa	Typ	Opis
Balanced	string	Informuje koder o użyciu ustawień, które zapewniają równowagę między szybkością a jakością.
Quality	string	Informuje koder o użyciu ustawień zoptymalizowanych pod kątem generowania danych wyjściowych o wyższej jakości kosztem wolniejszego ogólnego czasu kodowania.
Speed	string	Informuje koder o użyciu ustawień zoptymalizowanych pod kątem szybszego kodowania. Jakość jest poświęcana w celu skrócenia czasu kodowania.

H264Layer

Opisuje ustawienia, które mają być używane podczas kodowania wejściowego wideo do żądanej warstwy szybkości transmisji bitów wyjściowych za pomocą kodera-dekodera wideo H.264.

Nazwa	Typ	Opis
adaptiveBFrame	boolean	Czy należy używać adaptacyjnych ramek B podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder włączy go za każdym razem, gdy profil wideo zezwoli na jego użycie.
bFrames	integer	Liczba ramek B do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder wybierze odpowiedni numer na podstawie profilu i poziomu wideo.
bitrate	integer	Średnia szybkość transmisji bitów w bitach na sekundę, w której ma być kodowane wejściowe wideo podczas generowania tej warstwy. To pole jest wymagane.
bufferWindow	string	Długość okna buforu VBV. Wartość powinna być w formacie ISO 8601. Wartość powinna znajdować się w zakresie [0,1–100] sekund. Wartość domyślna to 5 sekund (na przykład PT5S).
crf	number	Wartość CRF do użycia podczas kodowania tej warstwy. To ustawienie ma zastosowanie, gdy tryb RateControlMode kodera-dekodera wideo jest ustawiany w trybie CRF. Zakres wartości CRF wynosi od 0 do 51, gdzie niższe wartości spowodują lepszą jakość kosztem większych rozmiarów plików. Wyższe wartości oznaczają większą kompresję, ale w pewnym momencie zostanie zauważona degradacja jakości. Wartość domyślna to 23.
entropyMode	EntropyMode	Tryb entropii, który ma być używany dla tej warstwy. Jeśli nie zostanie określony, koder wybiera tryb odpowiedni dla profilu i poziomu.
frameRate	string	Szybkość ramki (w klatkach na sekundę), przy której ma być kodowana ta warstwa. Wartość może być w postaci M/N, gdzie M i N są liczbami całkowitymi (na przykład 30000/1001) lub w postaci liczby (na przykład 30 lub 29,97). Koder wymusza ograniczenia dotyczące dozwolonych szybkości klatek na podstawie profilu i poziomu. Jeśli nie zostanie określony, koder będzie używać tej samej szybkości klatek co wejściowy film wideo.
height	string	Wysokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę pikseli wysokości jako dane wejściowe.
label	string	Etykieta alfanumeryczna dla tej warstwy, która może być używana w multipleksowaniu różnych warstw wideo i audio lub w nazewnictwie pliku wyjściowego.
level	string	Obecnie obsługujemy poziom do 6.2. Wartość może być automatyczna lub liczba zgodna z profilem H.264. Jeśli nie zostanie określony, wartość domyślna to Auto, co umożliwia koderowi wybranie poziomu odpowiedniego dla tej warstwy.
maxBitrate	integer	Maksymalna szybkość transmisji bitów (w bitach na sekundę), przy której należy założyć ponowne wypełnienie buforu VBV. Jeśli nie zostanie określony, wartość domyślna to ta sama co szybkość transmisji bitów.
profile	H264VideoProfile	Obecnie obsługujemy linię bazową, Main, High, High422, High444. Wartość domyślna to Auto.
referenceFrames	integer	Liczba ramek referencyjnych do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder określa odpowiednią liczbę na podstawie ustawienia złożoności kodera.
slices	integer	Liczba wycinków, które mają być używane podczas kodowania tej warstwy. Jeśli nie zostanie określony, wartość domyślna to zero, co oznacza, że koder będzie używać pojedynczego wycinka dla każdej ramki.
width	string	Szerokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że dane wyjściowe wideo mają połowę pikseli szerokości jako dane wejściowe.

H264RateControlMode

Tryb sterowania szybkością wideo

Nazwa	Typ	Opis
ABR	string	Średni tryb szybkości transmisji bitów (ABR), który osiąga docelową szybkość transmisji bitów: tryb domyślny.
CBR	string	Tryb stałej szybkości transmisji bitów (CBR), który zaostrza różnice szybkości transmisji bitów wokół docelowej szybkości transmisji bitów.
CRF	string	Tryb współczynnika stałej szybkości (CRF), który jest przeznaczony dla stałej subiektywnej jakości.

H264Video

Opisuje wszystkie właściwości kodowania wideo za pomocą kodera-dekodera H.264.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.H264Video	Dyskryminator typów pochodnych.
complexity	H264Complexity	Informuje koder, jak wybrać jego ustawienia kodowania. Wartość domyślna to Zrównoważony.
keyFrameInterval	string	Odległość między dwiema ramkami klucza. Wartość powinna być inna niż zero w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxingu.
layers	H264Layer[]	Kolekcja wyjściowych warstw H.264, które mają być tworzone przez koder.
rateControlMode	H264RateControlMode	Tryb sterowania szybkością wideo
sceneChangeDetection	boolean	Określa, czy koder powinien wstawić klatki klawiszy w scenie zmienia się. Jeśli nie zostanie określony, wartość domyślna to false. Ta flaga powinna być ustawiona na wartość true tylko wtedy, gdy koder jest skonfigurowany do tworzenia pojedynczego wyjściowego wideo.
stretchMode	StretchMode	Tryb zmiany rozmiaru — sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to AutoSize
syncMode	VideoSyncMode	Tryb synchronizacji wideo

H264VideoProfile

Obecnie obsługujemy plan bazowy, main, high, high422, High444. Wartość domyślna to Auto.

Nazwa	Typ	Opis
Auto	string	Informuje koder o automatycznym określeniu odpowiedniego profilu H.264.
Baseline	string	Profil punktu odniesienia
High	string	Wysoki profil.
High422	string	Wysoki profil 4:2:2.
High444	string	Wysoki profil predykcyjny 4:4:4.
Main	string	Profil główny

H265Complexity

Informuje koder, jak wybrać jego ustawienia kodowania. Jakość zapewni wyższy współczynnik kompresji, ale przy wyższym koszcie i dłuższym czasie obliczeniowym. Szybkość będzie produkować stosunkowo większy plik, ale jest szybszy i bardziej ekonomiczny. Wartość domyślna to Zrównoważony.

Nazwa	Typ	Opis
Balanced	string	Informuje koder o użyciu ustawień, które zapewniają równowagę między szybkością a jakością.
Quality	string	Informuje koder o użyciu ustawień zoptymalizowanych pod kątem generowania danych wyjściowych o wyższej jakości kosztem wolniejszego ogólnego czasu kodowania.
Speed	string	Informuje koder o użyciu ustawień zoptymalizowanych pod kątem szybszego kodowania. Jakość jest poświęcana w celu skrócenia czasu kodowania.

H265Layer

Opisuje ustawienia, które mają być używane podczas kodowania wejściowego wideo do żądanej warstwy szybkości transmisji bitów wyjściowych za pomocą kodera-dekodera wideo H.265.

Nazwa	Typ	Opis
adaptiveBFrame	boolean	Określa, czy podczas kodowania tej warstwy mają być używane adaptacyjne ramki B. Jeśli nie zostanie określony, koder włączy go za każdym razem, gdy profil wideo zezwoli na jego użycie.
bFrames	integer	Liczba ramek B do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder wybierze odpowiedni numer na podstawie profilu i poziomu wideo.
bitrate	integer	Średnia szybkość transmisji bitów w bitach na sekundę, w której ma być kodowane wejściowe wideo podczas generowania tej warstwy. Na przykład: docelowa szybkość transmisji bitów 3000 Kb/s lub 3 Mb/s oznacza, że ta wartość powinna wynosić 3000000. Jest to pole wymagane.
bufferWindow	string	Długość okna buforu VBV. Wartość powinna być w formacie ISO 8601. Wartość powinna znajdować się w zakresie [0,1–100] sekund. Wartość domyślna to 5 sekund (na przykład PT5S).
crf	number	Wartość CRF do użycia podczas kodowania tej warstwy. To ustawienie ma zastosowanie, gdy tryb RateControlMode kodera-dekodera wideo jest ustawiany w trybie CRF. Zakres wartości CRF wynosi od 0 do 51, gdzie niższe wartości spowodują lepszą jakość kosztem większych rozmiarów plików. Wyższe wartości oznaczają większą kompresję, ale w pewnym momencie zostanie zauważona degradacja jakości. Wartość domyślna to 28.
frameRate	string	Szybkość ramki (w klatkach na sekundę), przy której ma być kodowana ta warstwa. Wartość może być w postaci M/N, gdzie M i N są liczbami całkowitymi (na przykład 30000/1001) lub w postaci liczby (na przykład 30 lub 29,97). Koder wymusza ograniczenia dotyczące dozwolonych szybkości klatek na podstawie profilu i poziomu. Jeśli nie zostanie określony, koder będzie używać tej samej szybkości klatek co wejściowy film wideo.
height	string	Wysokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę pikseli wysokości jako dane wejściowe.
label	string	Etykieta alfanumeryczna dla tej warstwy, która może być używana w multipleksowaniu różnych warstw wideo i audio lub w nazewnictwie pliku wyjściowego.
level	string	Obecnie obsługujemy poziom do 6.2. Wartość może być automatyczna lub liczba zgodna z profilem H.265. Jeśli nie zostanie określony, wartość domyślna to Auto, co umożliwia koderowi wybranie poziomu odpowiedniego dla tej warstwy.
maxBitrate	integer	Maksymalna szybkość transmisji bitów (w bitach na sekundę), przy której należy założyć ponowne wypełnienie buforu VBV. Jeśli nie zostanie określony, wartość domyślna to ta sama co szybkość transmisji bitów.
profile	H265VideoProfile	Obecnie obsługujemy główną. Wartość domyślna to Auto.
referenceFrames	integer	Liczba ramek referencyjnych do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder określa odpowiednią liczbę na podstawie ustawienia złożoności kodera.
slices	integer	Liczba wycinków, które mają być używane podczas kodowania tej warstwy. Jeśli nie zostanie określony, wartość domyślna to zero, co oznacza, że koder będzie używać pojedynczego wycinka dla każdej ramki.
width	string	Szerokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że dane wyjściowe wideo mają połowę pikseli szerokości jako dane wejściowe.

H265Video

Opisuje wszystkie właściwości kodowania wideo za pomocą kodera-dekodera H.265.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.H265Video	Dyskryminator typów pochodnych.
complexity	H265Complexity	Informuje koder, jak wybrać jego ustawienia kodowania. Jakość zapewni wyższy współczynnik kompresji, ale przy wyższym koszcie i dłuższym czasie obliczeniowym. Szybkość będzie produkować stosunkowo większy plik, ale jest szybszy i bardziej ekonomiczny. Wartość domyślna to Zrównoważony.
keyFrameInterval	string	Odległość między dwiema ramkami klucza. Wartość powinna być inna niż zero w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxingu.
layers	H265Layer[]	Kolekcja wyjściowych warstw H.265, które mają być tworzone przez koder.
sceneChangeDetection	boolean	Określa, czy koder powinien wstawić klatki kluczowe w scenie zmiany. Jeśli nie zostanie określony, wartość domyślna to false. Ta flaga powinna być ustawiona na wartość true tylko wtedy, gdy koder jest skonfigurowany do tworzenia pojedynczego wyjściowego wideo.
stretchMode	StretchMode	Tryb zmiany rozmiaru — sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to AutoSize
syncMode	VideoSyncMode	Tryb synchronizacji wideo

H265VideoProfile

Obecnie obsługujemy program Main. Wartość domyślna to Auto.

Nazwa	Typ	Opis
Auto	string	Informuje koder o automatycznym określeniu odpowiedniego profilu H.265.
Main	string	Profil główny (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier)
Main10	string	Profil główny 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10)

Image

Opisuje podstawowe właściwości generowania miniatur z wejściowego klipu wideo

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.Image	Dyskryminator typów pochodnych.
keyFrameInterval	string	Odległość między dwiema ramkami klucza. Wartość powinna być inna niż zero w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxingu.
range	string	Pozycja względem przekształcenia wstępnie ustawionego czasu rozpoczęcia w wejściowym filmie wideo, w którym należy zatrzymać generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT5M30S zatrzymać się na 5 minut i 30 sekund od czasu rozpoczęcia) lub liczbę ramek (na przykład 300, aby zatrzymać się na 300 ramce z ramki w czasie rozpoczęcia. Jeśli ta wartość to 1, oznacza to tylko utworzenie jednej miniatury w czasie rozpoczęcia) lub względną wartość czasu trwania strumienia (na przykład 50%, aby zatrzymać się w połowie czasu trwania strumienia od czasu rozpoczęcia). Wartość domyślna to 100%, co oznacza zatrzymanie na końcu strumienia.
start	string	Pozycja w wejściowym filmie wideo, z którego należy rozpocząć generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT05S, aby rozpocząć się od 5 sekund) lub liczbę ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względną wartość czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Obsługuje również makro {Best}, które nakazuje koderowi wybranie najlepszej miniatury z pierwszych kilku sekund filmu wideo i utworzenie tylko jednej miniatury, niezależnie od innych ustawień kroków i zakresu. Wartość domyślna to makro {Best}.
step	string	Interwały, w których są generowane miniatury. Wartość może mieć format ISO 8601 (na przykład PT05S dla jednego obrazu co 5 sekund) lub liczbę ramek (na przykład 30 dla jednego obrazu co 30 ramek) lub względną wartość czasu trwania strumienia (na przykład 10% dla jednego obrazu co 10% czasu trwania strumienia). Uwaga: wartość kroku będzie mieć wpływ na pierwszą wygenerowaną miniaturę, która może nie być dokładnie określona w ustawieniu początkowym przekształcenia. Jest to spowodowane koderem, który próbuje wybrać najlepszą miniaturę między godziną rozpoczęcia a pozycją Krok od godziny rozpoczęcia jako pierwsze dane wyjściowe. Ponieważ wartość domyślna to 10%, oznacza to, że jeśli strumień ma długi czas trwania, pierwsza wygenerowana miniatura może być daleko od tej określonej w czasie rozpoczęcia. Spróbuj wybrać rozsądną wartość kroku, jeśli pierwsza miniatura jest oczekiwana blisko czasu rozpoczęcia, lub ustaw wartość zakresu na 1, jeśli tylko jedna miniatura jest potrzebna w czasie rozpoczęcia.
stretchMode	StretchMode	Tryb zmiany rozmiaru — sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to AutoSize
syncMode	VideoSyncMode	Tryb synchronizacji wideo

ImageFormat

Opisuje właściwości pliku obrazu wyjściowego.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.ImageFormat	Dyskryminujący dla typów pochodnych.
filenamePattern	string	Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.

InsightsType

Definiuje typ szczegółowych informacji, które mają być generowane przez usługę. Dozwolone wartości to "AudioInsightsOnly", "VideoInsightsOnly" i "AllInsights". Wartość domyślna to AllInsights. Jeśli ustawisz tę opcję na wartość AllInsights, a dane wejściowe są tylko audio, generowane są tylko szczegółowe informacje o dźwięku. Podobnie, jeśli dane wejściowe są tylko wideo, generowane są tylko szczegółowe informacje wideo. Zaleca się, aby nie używać elementu AudioInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko wideo; lub użyj usługi VideoInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko audio. Twoje zadania w takich warunkach spowodują błąd.

Nazwa	Typ	Opis
AllInsights	string	Generuj zarówno szczegółowe informacje dotyczące dźwięku, jak i wideo. Niepowodzenie, jeśli szczegółowe informacje o dźwięku lub wideo nie powiedzą się.
AudioInsightsOnly	string	Generowanie szczegółowych informacji dotyczących tylko dźwięku. Ignoruj wideo, nawet jeśli istnieje. Kończy się niepowodzeniem, jeśli nie ma dźwięku.
VideoInsightsOnly	string	Generuj tylko szczegółowe informacje dotyczące wideo. Ignoruj dźwięk, jeśli istnieje. Kończy się niepowodzeniem, jeśli nie ma wideo.

InterleaveOutput

Ustawia tryb przeplotu danych wyjściowych, aby kontrolować sposób przechowywania dźwięku i wideo w formacie kontenera. Przykład: ustaw wartość InterleavedOutput jako NonInterleavedOutput, aby wygenerować dane wyjściowe tylko do audio i wideo w oddzielnych plikach MP4.

Nazwa	Typ	Opis
InterleavedOutput	string	Dane wyjściowe obejmują zarówno audio, jak i wideo.
NonInterleavedOutput	string	Dane wyjściowe są tylko do wideo lub tylko do audio.

JpgFormat

Opisuje ustawienia tworzenia miniatur JPEG.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.JpgFormat	Dyskryminujący dla typów pochodnych.
filenamePattern	string	Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.

JpgImage

Opisuje właściwości tworzenia serii obrazów JPEG z wejściowego wideo.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.JpgImage	Dyskryminator typów pochodnych.
keyFrameInterval	string	Odległość między dwiema ramkami klucza. Wartość powinna być inna niż zero w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxingu.
layers	JpgLayer[]	Kolekcja wyjściowych warstw obrazów JPEG, które mają być tworzone przez koder.
range	string	Pozycja względem przekształcenia wstępnie ustawionego czasu rozpoczęcia w wejściowym filmie wideo, w którym należy zatrzymać generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT5M30S zatrzymać się na 5 minut i 30 sekund od czasu rozpoczęcia) lub liczbę ramek (na przykład 300, aby zatrzymać się na 300 ramce z ramki w czasie rozpoczęcia. Jeśli ta wartość to 1, oznacza to tylko utworzenie jednej miniatury w czasie rozpoczęcia) lub względną wartość czasu trwania strumienia (na przykład 50%, aby zatrzymać się w połowie czasu trwania strumienia od czasu rozpoczęcia). Wartość domyślna to 100%, co oznacza zatrzymanie na końcu strumienia.
spriteColumn	integer	Ustawia liczbę kolumn używanych na obrazie sprite miniatury. Liczba wierszy jest obliczana automatycznie, a plik VTT jest generowany przy użyciu mapowań współrzędnych dla każdej miniatury w skrite. Uwaga: ta wartość powinna być dodatnią liczbą całkowitą i zalecana jest właściwa wartość, aby rozdzielczość obrazu wyjściowego nie przekraczała maksymalnego limitu rozdzielczości pikseli JPEG 65535x65535.
start	string	Pozycja w wejściowym filmie wideo, z którego należy rozpocząć generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT05S, aby rozpocząć się od 5 sekund) lub liczbę ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względną wartość czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Obsługuje również makro {Best}, które nakazuje koderowi wybranie najlepszej miniatury z pierwszych kilku sekund filmu wideo i utworzenie tylko jednej miniatury, niezależnie od innych ustawień kroków i zakresu. Wartość domyślna to makro {Best}.
step	string	Interwały, w których są generowane miniatury. Wartość może mieć format ISO 8601 (na przykład PT05S dla jednego obrazu co 5 sekund) lub liczbę ramek (na przykład 30 dla jednego obrazu co 30 ramek) lub względną wartość czasu trwania strumienia (na przykład 10% dla jednego obrazu co 10% czasu trwania strumienia). Uwaga: wartość kroku będzie mieć wpływ na pierwszą wygenerowaną miniaturę, która może nie być dokładnie określona w ustawieniu początkowym przekształcenia. Jest to spowodowane koderem, który próbuje wybrać najlepszą miniaturę między godziną rozpoczęcia a pozycją Krok od godziny rozpoczęcia jako pierwsze dane wyjściowe. Ponieważ wartość domyślna to 10%, oznacza to, że jeśli strumień ma długi czas trwania, pierwsza wygenerowana miniatura może być daleko od tej określonej w czasie rozpoczęcia. Spróbuj wybrać rozsądną wartość kroku, jeśli pierwsza miniatura jest oczekiwana blisko czasu rozpoczęcia, lub ustaw wartość zakresu na 1, jeśli tylko jedna miniatura jest potrzebna w czasie rozpoczęcia.
stretchMode	StretchMode	Tryb zmiany rozmiaru — sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to AutoSize
syncMode	VideoSyncMode	Tryb synchronizacji wideo

JpgLayer

Opisuje ustawienia służące do tworzenia obrazu JPEG z wejściowego wideo.

Nazwa	Typ	Opis
height	string	Wysokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę pikseli wysokości jako dane wejściowe.
label	string	Etykieta alfanumeryczna dla tej warstwy, która może być używana w multipleksowaniu różnych warstw wideo i audio lub w nazewnictwie pliku wyjściowego.
quality	integer	Jakość kompresji danych wyjściowych JPEG. Zakres wynosi od 0 do 100, a wartość domyślna to 70.
width	string	Szerokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że dane wyjściowe wideo mają połowę pikseli szerokości jako dane wejściowe.

Mp4Format

Opisuje właściwości wyjściowego pliku ISO MP4.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.Mp4Format	Dyskryminujący dla typów pochodnych.
filenamePattern	string	Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.
outputFiles	OutputFile[]	Lista plików wyjściowych do utworzenia. Każdy wpis na liście jest zestawem etykiet warstw audio i wideo, które mają być połączone ze sobą.

MultiBitrateFormat

Opisuje właściwości tworzenia kolekcji plików o wielu szybkościach transmisji bitów wyrównywane przez usługę GOP. Domyślnym zachowaniem jest wygenerowanie jednego pliku wyjściowego dla każdej warstwy wideo, która jest muxed razem ze wszystkimi dźwiękami. Dokładne utworzone pliki wyjściowe można kontrolować, określając kolekcję outputFiles.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.MultiBitrateFormat	Dyskryminujący dla typów pochodnych.
filenamePattern	string	Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.
outputFiles	OutputFile[]	Lista plików wyjściowych do utworzenia. Każdy wpis na liście jest zestawem etykiet warstw audio i wideo, które mają być połączone ze sobą.

OnErrorType

Przekształcenie może definiować więcej niż jedno dane wyjściowe. Ta właściwość określa, co usługa powinna zrobić, gdy jedno wyjście zakończy się niepowodzeniem — kontynuuj tworzenie innych danych wyjściowych lub zatrzymaj inne dane wyjściowe. Ogólny stan zadania nie będzie odzwierciedlał błędów danych wyjściowych określonych za pomocą polecenia "ContinueJob". Wartość domyślna to "StopProcessingJob".

Nazwa	Typ	Opis
ContinueJob	string	Informuje usługę, że jeśli ta funkcja TransformOutput ulegnie awarii, zezwól na kontynuowanie dowolnego innego elementu TransformOutput.
StopProcessingJob	string	Informuje usługę, że jeśli ta funkcja TransformOutput ulegnie awarii, wszystkie inne niekompletne obiekty TransformOutput można zatrzymać.

OutputFile

Reprezentuje wygenerowany plik wyjściowy.

Nazwa	Typ	Opis
labels	string[]	Lista etykiet opisujących sposób, w jaki koder powinien multipleksować wideo i dźwięk w pliku wyjściowym. Jeśli na przykład koder tworzy dwie warstwy wideo z etykietami w wersji 1 i v2, a jedna warstwa audio z etykietą a1, tablica podobna do "[v1, a1]" informuje koder o utworzeniu pliku wyjściowego z ścieżką wideo reprezentowaną przez v1 i ścieżkę dźwiękową reprezentowaną przez a1.

PngFormat

Opisuje ustawienia tworzenia miniatur PNG.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.PngFormat	Dyskryminujący dla typów pochodnych.
filenamePattern	string	Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo ma długość krótszą niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa bazowa jest obcięta do pierwszych 32 znaków w całkowitej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera-warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" i liczba strumienia audio (zacznij od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ kodera-dekodera audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodsubstytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.

PngImage

Opisuje właściwości tworzenia serii obrazów PNG z wejściowego wideo.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.PngImage	Dyskryminator typów pochodnych.
keyFrameInterval	string	Odległość między dwiema ramkami klucza. Wartość powinna być inna niż zero w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxingu.
layers	PngLayer[]	Kolekcja wyjściowych warstw obrazów PNG do utworzenia przez koder.
range	string	Pozycja względem przekształcenia wstępnie ustawionego czasu rozpoczęcia w wejściowym filmie wideo, w którym należy zatrzymać generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT5M30S zatrzymać się na 5 minut i 30 sekund od czasu rozpoczęcia) lub liczbę ramek (na przykład 300, aby zatrzymać się na 300 ramce z ramki w czasie rozpoczęcia. Jeśli ta wartość to 1, oznacza to tylko utworzenie jednej miniatury w czasie rozpoczęcia) lub względną wartość czasu trwania strumienia (na przykład 50%, aby zatrzymać się w połowie czasu trwania strumienia od czasu rozpoczęcia). Wartość domyślna to 100%, co oznacza zatrzymanie na końcu strumienia.
start	string	Pozycja w wejściowym filmie wideo, z którego należy rozpocząć generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT05S, aby rozpocząć się od 5 sekund) lub liczbę ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względną wartość czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Obsługuje również makro {Best}, które nakazuje koderowi wybranie najlepszej miniatury z pierwszych kilku sekund filmu wideo i utworzenie tylko jednej miniatury, niezależnie od innych ustawień kroków i zakresu. Wartość domyślna to makro {Best}.
step	string	Interwały, w których są generowane miniatury. Wartość może mieć format ISO 8601 (na przykład PT05S dla jednego obrazu co 5 sekund) lub liczbę ramek (na przykład 30 dla jednego obrazu co 30 ramek) lub względną wartość czasu trwania strumienia (na przykład 10% dla jednego obrazu co 10% czasu trwania strumienia). Uwaga: wartość kroku będzie mieć wpływ na pierwszą wygenerowaną miniaturę, która może nie być dokładnie określona w ustawieniu początkowym przekształcenia. Jest to spowodowane koderem, który próbuje wybrać najlepszą miniaturę między godziną rozpoczęcia a pozycją Krok od godziny rozpoczęcia jako pierwsze dane wyjściowe. Ponieważ wartość domyślna to 10%, oznacza to, że jeśli strumień ma długi czas trwania, pierwsza wygenerowana miniatura może być daleko od tej określonej w czasie rozpoczęcia. Spróbuj wybrać rozsądną wartość kroku, jeśli pierwsza miniatura jest oczekiwana blisko czasu rozpoczęcia, lub ustaw wartość zakresu na 1, jeśli tylko jedna miniatura jest potrzebna w czasie rozpoczęcia.
stretchMode	StretchMode	Tryb zmiany rozmiaru — sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to AutoSize
syncMode	VideoSyncMode	Tryb synchronizacji wideo

PngLayer

Opisuje ustawienia służące do tworzenia obrazu PNG z wejściowego wideo.

Nazwa	Typ	Opis
height	string	Wysokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę więcej pikseli wysokości jako danych wejściowych.
label	string	Etykieta alfanumeryczna dla tej warstwy, która może być używana w multipleksowaniu różnych warstw wideo i audio lub nazewnictwa pliku wyjściowego.
width	string	Szerokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę tylu pikseli szerokości, jak dane wejściowe.

PresetConfigurations

Obiekt opcjonalnych ustawień konfiguracji kodera.

Nazwa	Typ	Opis
complexity	Complexity	Umożliwia skonfigurowanie ustawień kodera w celu kontrolowania równowagi między szybkością a jakością. Przykład: ustaw wartość Złożoność jako Szybkość, aby przyspieszyć kodowanie, ale zmniejszyć wydajność kompresji.
interleaveOutput	InterleaveOutput	Ustawia tryb przeplotu danych wyjściowych, aby kontrolować sposób przechowywania dźwięku i wideo w formacie kontenera. Przykład: ustaw wartość InterleavedOutput jako NonInterleavedOutput, aby wygenerować dane wyjściowe tylko do audio i wideo w oddzielnych plikach MP4.
keyFrameIntervalInSeconds	number	Interwał klatek kluczowych w sekundach. Przykład: ustaw wartość KeyFrameIntervalInSeconds na 2, aby zmniejszyć buforowanie odtwarzania dla niektórych graczy.
maxBitrateBps	integer	Maksymalna szybkość transmisji bitów w bitach na sekundę (próg dla górnej warstwy wideo). Przykład: ustaw parametr MaxBitrateBps na wartość 60000000, aby uniknąć tworzenia bardzo wysokich danych wyjściowych o szybkości transmisji bitów dla zawartości o wysokiej złożoności.
maxHeight	integer	Maksymalna wysokość wyjściowych warstw wideo. Przykład: ustaw wartość MaxHeight jako 720, aby wygenerować warstwy wyjściowe do 720P, nawet jeśli wartość wejściowa to 4K.
maxLayers	integer	Maksymalna liczba wyjściowych warstw wideo. Przykład: ustaw wartość MaxLayers jako 4, aby upewnić się, że co najwyżej 4 warstwy wyjściowe są tworzone w celu kontrolowania ogólnego kosztu zadania kodowania.
minBitrateBps	integer	Minimalna szybkość transmisji bitów w bitach na sekundę (próg dla dolnej warstwy wideo). Przykład: ustaw wartość MinBitrateBps jako 200000, aby mieć dolną warstwę, która obejmuje użytkowników o niskiej przepustowości sieci.
minHeight	integer	Minimalna wysokość wyjściowych warstw wideo. Przykład: ustaw wartość MinHeight jako 360, aby uniknąć warstw wyjściowych mniejszych rozdzielczości, takich jak 180P.

Priority

Ustawia względny priorytet funkcji TransformOutputs w ramach przekształcenia. Powoduje to ustawienie priorytetu używanego przez usługę do przetwarzania funkcji TransformOutputs. Domyślny priorytet to Normalny.

Nazwa	Typ	Opis
High	string	Używane w przypadku funkcji TransformOutputs, które powinny mieć pierwszeństwo przed innymi.
Low	string	Służy do transformOutputs, które można wygenerować po normalnych i wysokich priorytetach TransformOutputs.
Normal	string	Służy do przekształcaniaOutputs, które można wygenerować z priorytetem normalnym.

Rectangle

Opisuje właściwości okna prostokątnego zastosowanego do nośnika wejściowego przed jego przetworzeniem.

Nazwa	Typ	Opis
height	string	Wysokość prostokątnego obszaru w pikselach. Może to być wartość bezwzględna pikseli (np. 100) lub rozmiar wideo (na przykład 50%).
left	string	Liczba pikseli z lewego marginesu. Może to być wartość bezwzględna pikseli (np. 100) lub rozmiar wideo (na przykład 50%).
top	string	Liczba pikseli z górnego marginesu. Może to być wartość bezwzględna pikseli (np. 100) lub rozmiar wideo (na przykład 50%).
width	string	Szerokość prostokątnego obszaru w pikselach. Może to być wartość bezwzględna pikseli (np. 100) lub rozmiar wideo (na przykład 50%).

Rotation

Rotacja, jeśli w ogóle, ma zostać zastosowana do wejściowego wideo, zanim zostanie zakodowana. Wartość domyślna to Auto

Nazwa	Typ	Opis
Auto	string	Automatycznie wykrywaj i obracaj je zgodnie z potrzebami.
None	string	Nie obracaj wideo. Jeśli format danych wyjściowych go obsługuje, wszelkie metadane dotyczące rotacji są zachowywane bez zmian.
Rotate0	string	Nie obracaj filmu wideo, ale usuwaj wszelkie metadane dotyczące rotacji.
Rotate180	string	Obróć 180 stopni zgodnie z ruchem wskazówek zegara.
Rotate270	string	Obróć 270 stopni zgodnie z ruchem wskazówek zegara.
Rotate90	string	Obróć 90 stopni zgodnie z ruchem wskazówek zegara.

StandardEncoderPreset

Opisuje wszystkie ustawienia, które mają być używane podczas kodowania wejściowego wideo za pomocą kodera standardowego.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.StandardEncoderPreset	Dyskryminator typów pochodnych.
codecs	Codec[]: AacAudio[] Audio[] CopyAudio[] CopyVideo[] DDAudio[] H264Video[] H265Video[] Image[] JpgImage[] PngImage[] Video[]	Lista koderów koderów do użycia podczas kodowania wejściowego wideo.
experimentalOptions	object	Słownik zawierający pary wartości klucza dla parametrów, które nie są widoczne w samym ustawieniu wstępnym
filters	Filters	Co najmniej jedna operacja filtrowania, która jest stosowana do nośnika wejściowego przed kodowaniem.
formats	Format[]: ImageFormat[] JpgFormat[] Mp4Format[] MultiBitrateFormat[] PngFormat[] TransportStreamFormat[]	Lista danych wyjściowych, które mają być generowane przez koder.

StretchMode

Tryb zmiany rozmiaru — sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to AutoSize

Nazwa	Typ	Opis
AutoFit	string	Dopełnij dane wyjściowe (z polem letterbox lub filarem), aby uhonorować rozdzielczość danych wyjściowych, zapewniając jednocześnie, że aktywny region wideo w danych wyjściowych ma taki sam współczynnik proporcji jak dane wejściowe. Jeśli na przykład dane wejściowe to 1920x1080, a ustawienie wstępne kodowania prosi o 1280 x 1280 x 1280, dane wyjściowe będą mieć wartość 1280x1280, która zawiera wewnętrzny prostokąt 1280 x 720 w proporcji 16:9, a obszary pola filaru mają szerokość 280 pikseli po lewej i prawej stronie.
AutoSize	string	Zastąpij rozdzielczość danych wyjściowych i zmień ją tak, aby była zgodna z współczynnikiem proporcji ekranu danych wejściowych bez dopełnienia. Jeśli na przykład dane wejściowe to 1920x1080, a ustawienie wstępne kodowania prosi o 1280 x 1280 x 1280, wartość w ustawieniu wstępnym zostanie zastąpiona, a dane wyjściowe będą mieć wartość 1280x720, która utrzymuje współczynnik proporcji wejściowych 16:9.
None	string	Ściśle przestrzegaj rozdzielczości danych wyjściowych bez uwzględniania współczynnika proporcji pikseli lub współczynnika proporcji ekranu wejściowego wideo.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Transform

Transform hermetyzuje reguły lub instrukcje dotyczące generowania żądanych danych wyjściowych z nośnika wejściowego, takich jak transkodowanie lub wyodrębnianie szczegółowych informacji. Po utworzeniu przekształcenia można go zastosować do nośnika wejściowego, tworząc zadania.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nazwa zasobu
properties.created	string	Data i godzina UTC utworzenia przekształcenia w formacie "RRRR-MM-DDThh:mm:ssZ".
properties.description	string	Opcjonalny pełny opis przekształcenia.
properties.lastModified	string	Data i godzina UTC ostatniej aktualizacji przekształcenia w formacie "RRRR-MM-DDThh:mm:ssZ".
properties.outputs	TransformOutput[]	Tablica z co najmniej jednym elementem TransformOutputs, który powinien zostać wygenerowany przez przekształcenie.
systemData	systemData	Metadane systemowe odnoszące się do tego zasobu.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

TransformOutput

Opisuje właściwości elementu TransformOutput, które są regułami, które mają być stosowane podczas generowania żądanych danych wyjściowych.

Nazwa	Typ	Opis
onError	OnErrorType	Przekształcenie może definiować więcej niż jedno dane wyjściowe. Ta właściwość określa, co usługa powinna zrobić, gdy jedno wyjście zakończy się niepowodzeniem — kontynuuj tworzenie innych danych wyjściowych lub zatrzymaj inne dane wyjściowe. Ogólny stan zadania nie będzie odzwierciedlał błędów danych wyjściowych określonych za pomocą polecenia "ContinueJob". Wartość domyślna to "StopProcessingJob".
preset	Preset: AudioAnalyzerPreset BuiltInStandardEncoderPreset FaceDetectorPreset StandardEncoderPreset VideoAnalyzerPreset	Ustawienie wstępne opisujące operacje, które będą używane do modyfikowania, transkodowania lub wyodrębniania szczegółowych informacji z pliku źródłowego w celu wygenerowania danych wyjściowych.
relativePriority	Priority	Ustawia względny priorytet funkcji TransformOutputs w ramach przekształcenia. Powoduje to ustawienie priorytetu używanego przez usługę do przetwarzania funkcji TransformOutputs. Domyślny priorytet to Normalny.

TransportStreamFormat

Opisuje właściwości generowania strumienia transportowego MPEG-2 (ISO/IEC 13818-1) wyjściowych plików wideo.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.TransportStreamFormat	Dyskryminujący dla typów pochodnych.
filenamePattern	string	Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.
outputFiles	OutputFile[]	Lista plików wyjściowych do utworzenia. Każdy wpis na liście jest zestawem etykiet warstw audio i wideo, które mają być połączone ze sobą.

Video

Opisuje podstawowe właściwości kodowania wejściowego wideo.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.Video	Dyskryminator typów pochodnych.
keyFrameInterval	string	Odległość między dwiema ramkami klucza. Wartość powinna być inna niż zero w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.
label	string	Opcjonalna etykieta kodera-dekodera. Etykieta może służyć do kontrolowania zachowania muxingu.
stretchMode	StretchMode	Tryb zmiany rozmiaru — sposób zmiany rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości danych wyjściowych. Wartość domyślna to AutoSize
syncMode	VideoSyncMode	Tryb synchronizacji wideo

VideoAnalyzerPreset

Ustawienie wstępne analizatora wideo, które wyodrębnia szczegółowe informacje (rozbudowane metadane) zarówno z audio, jak i wideo, i generuje plik formatu JSON.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.VideoAnalyzerPreset	Dyskryminator typów pochodnych.
audioLanguage	string	Język ładunku audio w danych wejściowych przy użyciu formatu BCP-47 "language tag-region" (np. "en-US"). Jeśli znasz język zawartości, zaleca się jej określenie. Język musi być określony jawnie dla AudioAnalysisMode::Basic, ponieważ automatyczne wykrywanie języka nie jest uwzględniane w trybie podstawowym. Jeśli język nie jest określony lub ustawiony na wartość null, automatyczne wykrywanie języka wybierze pierwszy wykryty język i przetworzy go przy użyciu wybranego języka na czas trwania pliku. Obecnie nie obsługuje dynamicznego przełączania między językami po wykryciu pierwszego języka. Automatyczne wykrywanie działa najlepiej w przypadku nagrań audio z wyraźnie rozpoznawalną mową. Jeśli automatyczne wykrywanie nie znajdzie języka, transkrypcja wróci do "en-US". Lista obsługiwanych języków jest dostępna tutaj: https://go.microsoft.com/fwlink/?linkid=2109463
experimentalOptions	object	Słownik zawierający pary wartości klucza dla parametrów, które nie są widoczne w samym ustawieniu wstępnym
insightsToExtract	InsightsType	Definiuje typ szczegółowych informacji, które mają być generowane przez usługę. Dozwolone wartości to "AudioInsightsOnly", "VideoInsightsOnly" i "AllInsights". Wartość domyślna to AllInsights. Jeśli ustawisz tę opcję na wartość AllInsights, a dane wejściowe są tylko audio, generowane są tylko szczegółowe informacje o dźwięku. Podobnie, jeśli dane wejściowe są tylko wideo, generowane są tylko szczegółowe informacje wideo. Zaleca się, aby nie używać elementu AudioInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko wideo; lub użyj usługi VideoInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko audio. Twoje zadania w takich warunkach spowodują błąd.
mode	AudioAnalysisMode	Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrana opcja Standard AudioAnalysisMode.

VideoOverlay

Opisuje właściwości nakładki wideo.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.VideoOverlay	Dyskryminator typów pochodnych.
audioGainLevel	number	Poziom zysku dźwięku w nakładce. Wartość powinna znajdować się w zakresie [0, 1.0]. Wartość domyślna to 1.0.
cropRectangle	Rectangle	Opcjonalne prostokątne okno używane do przycinania obrazu nakładki lub wideo.
end	string	Położenie końcowe z odwołaniem do wejściowego wideo, na którym kończy się nakładka. Wartość powinna być w formacie ISO 8601. Na przykład PT30S, aby zakończyć nakładkę na 30 sekund w wejściowym filmie wideo. Jeśli nie zostanie określona lub wartość jest większa niż czas trwania wejściowego wideo, nakładka zostanie zastosowana do końca wejściowego wideo, jeśli czas trwania nośnika nakładki jest większy niż czas trwania wejściowego wideo, w przeciwnym razie nakładka będzie trwać tak długo, jak długo trwa czas trwania nośnika nakładki.
fadeInDuration	string	Czas trwania, przez który nakładka zanika na wejściowym filmie wideo. Wartość powinna być w formacie czasu trwania ISO 8601. Jeśli nie określono domyślnego zachowania, nie ma zanikania (tak samo jak PT0S).
fadeOutDuration	string	Czas trwania, przez który nakładka zanika z wejściowego wideo. Wartość powinna być w formacie czasu trwania ISO 8601. Jeśli nie określono domyślnego zachowania, nie ma zanikania (tak samo jak PT0S).
inputLabel	string	Etykieta danych wejściowych zadania, które mają być używane jako nakładka. Dane wejściowe muszą określać dokładnie jeden plik. Można określić plik obrazu w formacie JPG, PNG, GIF lub BMP albo pliku audio (takiego jak plik WAV, MP3, WMA lub M4A) albo plik wideo. Zobacz https://aka.ms/mesformats pełną listę obsługiwanych formatów plików audio i wideo.
opacity	number	Nieprzezroczystość nakładki. Jest to wartość w zakresie [0– 1.0]. Wartość domyślna to 1.0, co oznacza, że nakładka jest nieprzezroczysta.
position	Rectangle	Lokalizacja w wejściowym filmie wideo, w którym jest stosowana nakładka.
start	string	Pozycja początkowa, z odwołaniem do wejściowego wideo, na którym rozpoczyna się nakładka. Wartość powinna być w formacie ISO 8601. Na przykład PT05S, aby uruchomić nakładkę na 5 sekund do wejściowego wideo. Jeśli nie określono nakładki, rozpoczyna się od początku wejściowego wideo.

VideoSyncMode

Tryb synchronizacji wideo

Nazwa	Typ	Opis
Auto	string	Jest to metoda domyślna. Wybiera między cfr i Vfr w zależności od możliwości muxer. W przypadku formatu wyjściowego MP4 domyślny tryb to Cfr.
Cfr	string	Ramki wejściowe będą powtarzane i/lub porzucane zgodnie z potrzebami, aby osiągnąć dokładnie żądaną stałą częstotliwość klatek. Zalecane, gdy częstotliwość klatek wyjściowych jest jawnie ustawiona na określoną wartość
Passthrough	string	Znaczniki czasu prezentacji w ramkach są przekazywane z pliku wejściowego do modułu zapisywania plików wyjściowych. Zalecane, gdy źródło wejściowe ma zmienną częstotliwość klatek i próbuje utworzyć wiele warstw na potrzeby adaptacyjnego przesyłania strumieniowego w danych wyjściowych, które mają wyrównane granice GOP. Uwaga: jeśli co najmniej dwie ramki w danych wejściowych mają zduplikowane znaczniki czasu, dane wyjściowe również będą miały takie samo zachowanie
Vfr	string	Podobnie jak w trybie przekazywania, ale jeśli dane wejściowe zawierają zduplikowane znaczniki czasu, tylko jedna ramka jest przekazywana do danych wyjściowych, a inne są porzucane. Zalecane, gdy oczekuje się, że liczba ramek wyjściowych będzie równa liczbie ramek wejściowych. Na przykład dane wyjściowe są używane do obliczania metryki jakości, takiej jak PSNR względem danych wejściowych