Jobs - Create

Usługa:

Media Services

Wersja interfejsu API:

2022-07-01

Tworzenie zadania
Tworzy zadanie.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string	Nazwa konta usługi Media Services.
jobName	path	True	string	Nazwa zadania.
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, która ma być używana z żądaniem klienta.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties.input	True	JobInput: JobInputClip JobInputs JobInputSequence JobInputAsset JobInputHttp	Dane wejściowe zadania.
properties.outputs	True	JobOutput[]: JobOutputAsset[]	Dane wyjściowe zadania.
properties.correlationData		object	Klucz podany przez klienta, pary wartości, które zostaną zwrócone w zdarzeniach stanu Job i JobOutput.
properties.description		string	Opcjonalny opis zadania podany przez klienta.
properties.priority		Priority	Priorytet, za pomocą którego zadanie powinno być przetwarzane. Zadania o wyższym priorytcie są przetwarzane przed zadaniami o niższym priorytcie. Jeśli nie zostanie ustawiona, wartość domyślna jest normalna.

Odpowiedzi

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

Przykłady

Create a Job

Przykładowe żądanie

HTTP

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

{
  "properties": {
    "input": {
      "@odata.type": "#Microsoft.Media.JobInputAsset",
      "assetName": "job1-InputAsset"
    },
    "outputs": [
      {
        "@odata.type": "#Microsoft.Media.JobOutputAsset",
        "assetName": "job1-OutputAsset"
      }
    ],
    "correlationData": {
      "key1": "value1",
      "Key 2": "Value 2"
    }
  }
}

Java

import com.azure.resourcemanager.mediaservices.models.JobInputAsset;
import com.azure.resourcemanager.mediaservices.models.JobOutputAsset;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Jobs Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/jobs-create.json
     */
    /**
     * Sample code: Create a Job.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createAJob(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.jobs().define("job1").withExistingTransform("contosoresources", "contosomedia", "exampleTransform")
            .withInput(new JobInputAsset().withAssetName("job1-InputAsset"))
            .withOutputs(Arrays.asList(new JobOutputAsset().withAssetName("job1-OutputAsset")))
            .withCorrelationData(mapOf("Key 2", "fakeTokenPlaceholder", "key1", "fakeTokenPlaceholder")).create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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 jobscreate.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.jobs.create(
        resource_group_name="contosoresources",
        account_name="contosomedia",
        transform_name="exampleTransform",
        job_name="job1",
        parameters={
            "properties": {
                "correlationData": {"Key 2": "Value 2", "key1": "value1"},
                "input": {"@odata.type": "#Microsoft.Media.JobInputAsset", "assetName": "job1-InputAsset"},
                "outputs": [{"@odata.type": "#Microsoft.Media.JobOutputAsset", "assetName": "job1-OutputAsset"}],
            }
        },
    )
    print(response)


# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/jobs-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/jobs-create.json
func ExampleJobsClient_Create() {
	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)
	}
	_, err = clientFactory.NewJobsClient().Create(ctx, "contosoresources", "contosomedia", "exampleTransform", "job1", armmediaservices.Job{
		Properties: &armmediaservices.JobProperties{
			CorrelationData: map[string]*string{
				"Key 2": to.Ptr("Value 2"),
				"key1":  to.Ptr("value1"),
			},
			Input: &armmediaservices.JobInputAsset{
				ODataType: to.Ptr("#Microsoft.Media.JobInputAsset"),
				AssetName: to.Ptr("job1-InputAsset"),
			},
			Outputs: []armmediaservices.JobOutputClassification{
				&armmediaservices.JobOutputAsset{
					ODataType: to.Ptr("#Microsoft.Media.JobOutputAsset"),
					AssetName: to.Ptr("job1-OutputAsset"),
				}},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
}

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 a Job.
 *
 * @summary Creates a Job.
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/jobs-create.json
 */
async function createAJob() {
  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 = "exampleTransform";
  const jobName = "job1";
  const parameters = {
    correlationData: { key2: "Value 2", key1: "value1" },
    input: {
      odataType: "#Microsoft.Media.JobInputAsset",
      assetName: "job1-InputAsset",
    },
    outputs: [
      {
        odataType: "#Microsoft.Media.JobOutputAsset",
        assetName: "job1-OutputAsset",
      },
    ],
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const result = await client.jobs.create(
    resourceGroupName,
    accountName,
    transformName,
    jobName,
    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/jobs-create.json
// this example is just showing the usage of "Jobs_Create" operation, for the dependent resources, they will have to be created separately.

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

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

// get the collection of this MediaJobResource
MediaJobCollection collection = mediaTransform.GetMediaJobs();

// invoke the operation
string jobName = "job1";
MediaJobData data = new MediaJobData()
{
    Input = new MediaJobInputAsset("job1-InputAsset"),
    Outputs =
    {
    new MediaJobOutputAsset("job1-OutputAsset")
    },
    CorrelationData =
    {
    ["Key 2"] = "Value 2",
    ["key1"] = "value1",
    },
};
ArmOperation<MediaJobResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, jobName, data);
MediaJobResource 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
MediaJobData 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": "job1",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/exampleTransform/jobs/job1",
  "type": "Microsoft.Media/mediaservices/transforms/jobs",
  "properties": {
    "created": "2022-10-17T23:14:33.6140749Z",
    "state": "Queued",
    "input": {
      "@odata.type": "#Microsoft.Media.JobInputAsset",
      "files": [],
      "inputDefinitions": [],
      "assetName": "job1-InputAsset"
    },
    "lastModified": "2022-10-17T23:14:33.6140749Z",
    "outputs": [
      {
        "@odata.type": "#Microsoft.Media.JobOutputAsset",
        "state": "Queued",
        "progress": 0,
        "label": "BuiltInStandardEncoderPreset_0",
        "assetName": "job1-OutputAsset"
      }
    ],
    "priority": "Normal",
    "correlationData": {
      "key1": "value1",
      "Key 2": "Value 2"
    }
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:33.6140749Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:33.6140749Z"
  }
}

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ą funkcji AAC.
AbsoluteClipTime	Określa czas klipu jako bezwzględną pozycję czasu w pliku multimedialnym. Czas bezwzględny może wskazywać inną pozycję w zależności od tego, czy plik multimedialny rozpoczyna się od znacznika czasu zera, czy nie.
AnalysisResolution	Określa maksymalną rozdzielczość, w której jest analizowane wideo. Domyślne zachowanie to "SourceResolution", które zachowa dane wejściowe wideo w oryginalnej rozdzielczości podczas analizowania. Użycie opcji "StandardDefinition" spowoduje zmianę rozmiaru wejściowych filmów wideo na definicję standardową przy zachowaniu odpowiedniego współczynnika proporcji. Zmienia rozmiar tylko wtedy, gdy wideo ma wyższą rozdzielczość. Na przykład dane wejściowe 1920x1080 zostaną skalowane do 640x360 przed przetworzeniem. Przełączenie na "StandardDefinition" skróci czas przetwarzania wideo o wysokiej rozdzielczości. Może również zmniejszyć koszty korzystania z tego składnika (zobacz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics szczegółowe informacje). Jednak twarze, które kończą się zbyt małe w zmienionym rozmiarze wideo, mogą nie zostać wykryte.
AttributeFilter	Typ atrybutu AttributeFilter, który ma być stosowany do elementu TrackAttribute w celu wybrania ścieżek.
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 wybrany standard AudioAnalysisMode.
AudioAnalyzerPreset	Ustawienie wstępne analizatora audio stosuje wstępnie zdefiniowany zestaw operacji analizy opartej na sztucznej inteligencji, w tym transkrypcję mowy. Obecnie ustawienie wstępne obsługuje przetwarzanie zawartości przy użyciu pojedynczego ścieżki audio.
AudioOverlay	Opisuje właściwości nakładki audio.
AudioTrackDescriptor	Element TrackSelection do wybierania ścieżek dźwiękowych.
BlurType	Typ rozmycia
BuiltInStandardEncoderPreset	Opisuje wbudowane ustawienie wstępne kodowania wejściowego wideo za pomocą kodera standardowego.
ChannelMapping	Opcjonalne oznaczenie dla utworów audio z jednym kanałem. Można używać do łączenia utworów w utwory stereo lub wielokanałowe audio.
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 wybiera 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 klipu 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. W tym trybie jest generowany plik JSON metadanych z oznaczeniem wyglądów twarzy w całym filmie wideo. Jeśli to możliwe, występy tej samej osoby są przypisane do tego samego identyfikatora. 2) Połączone — dodatkowo wykryte twarze są redacts (rozmyte). 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 wideo oraz wybranym przez użytkownika podzbiorem identyfikatorów, które wymagają ponownej 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.
FromAllInputFile	InputDefinition, który analizuje wszystkie udostępnione pliki, aby wybrać ścieżki określone przez właściwość IncludedTracks. Ogólnie używane z elementami AudioTrackByAttribute i VideoTrackByAttribute w celu umożliwienia wyboru pojedynczej ścieżki w zestawie plików wejściowych.
FromEachInputFile	Element InputDefinition, który analizuje każdy udostępniony plik wejściowy, aby wybrać ścieżki określone przez właściwość IncludedTracks. Ogólnie używane z audioTrackByAttribute i VideoTrackByAttribute do wybierania ścieżek z każdego pliku podanego.
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 danych wyjściowych za pomocą kodera 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 linię bazową, 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 główną. 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.
InputFile	Element InputDefinition dla pojedynczego pliku. ŚledzenieWybory są ograniczone do określonego 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.
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.
Job	Typ zasobu zadania. Postęp i stan można uzyskać, sondując zadanie lub subskrybując zdarzenia przy użyciu usługi EventGrid.
JobError	Szczegóły błędów JobOutput.
JobErrorCategory	Pomaga w kategoryzacji błędów.
JobErrorCode	Kod błędu opisujący błąd.
JobErrorDetail	Szczegóły błędów JobOutput.
JobInputAsset	Reprezentuje zasób dla danych wejściowych w zadaniu.
JobInputClip	Reprezentuje pliki wejściowe zadania.
JobInputHttp	Reprezentuje dane wejściowe zadania HTTPS.
JobInputs	Opisuje listę danych wejściowych zadania.
JobInputSequence	Sekwencja zawiera uporządkowaną listę klipów, w których każdy klip jest obiektem JobInput. Sekwencja będzie traktowana jako pojedyncze dane wejściowe.
JobOutputAsset	Reprezentuje zasób używany jako jobOutput.
JobRetry	Wskazuje, że może być możliwe ponowienie próby wykonania zadania. Jeśli ponowna próba nie powiedzie się, skontaktuj się z pomoc techniczna platformy Azure za pośrednictwem witryny Azure Portal.
JobState	Opisuje stan elementu JobOutput.
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.
OutputFile	Reprezentuje utworzony 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 dla kodera.
Priority	Ustawia względny priorytet transformOutputs w ramach przekształcenia. Określa priorytet używany przez usługę do przetwarzania funkcji TransformOutputs. Domyślny priorytet to Normal.
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
SelectAudioTrackByAttribute	Wybierz ścieżki audio z danych wejściowych, określając atrybut i filtr atrybutu.
SelectAudioTrackById	Wybierz ścieżki audio z danych wejściowych, określając identyfikator ścieżki.
SelectVideoTrackByAttribute	Wybierz ścieżki wideo z danych wejściowych, określając atrybut i filtr atrybutu.
SelectVideoTrackById	Wybierz ścieżkę wideo z danych wejściowych, określając identyfikator śledzenia.
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.
TrackAttribute	Element TrackAttribute do filtrowania ścieżek według.
TransportStreamFormat	Opisuje właściwości generowania strumienia transportowego MPEG-2 (ISO/IEC 13818-1) wyjściowych plików wideo.
UtcClipTime	Określa godzinę klipu jako pozycję czasu Utc w pliku multimedialnym. Czas Utc może wskazywać inną pozycję w zależności od tego, czy plik multimedialny rozpoczyna się od znacznika czasu zera, czy nie.
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
VideoTrackDescriptor	Element TrackSelection do wybierania ścieżek wideo.

AacAudio

Opisuje ustawienia kodowania audio Advanced Audio Codec (AAC).

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.AacAudio	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.
profile	AacAudioProfile	Profil kodowania, który ma być używany podczas kodowania dźwięku za pomocą usługi AAC.
samplingRate	integer	Częstotliwość próbkowania do użycia do kodowania w hertz.

AacAudioProfile

Profil kodowania, który ma być używany podczas kodowania dźwięku za pomocą funkcji 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 w wersji 1.
HeAacV2	string	Określa, że dźwięk wyjściowy ma być zakodowany w profilu HE-AAC v2.

AbsoluteClipTime

Określa czas klipu jako bezwzględną pozycję czasu w pliku multimedialnym. Czas bezwzględny może wskazywać inną pozycję w zależności od tego, czy plik multimedialny rozpoczyna się od znacznika czasu zera, czy nie.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.AbsoluteClipTime	Dyskryminujący dla typów pochodnych.
time	string	Położenie czasu na osi czasu nośnika wejściowego. Jest on zwykle określany jako okres ISO8601. np. PT30S przez 30 sekund.

AnalysisResolution

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

Nazwa	Typ	Opis
SourceResolution	string
StandardDefinition	string

AttributeFilter

Typ atrybutu AttributeFilter, który ma być stosowany do elementu TrackAttribute w celu wybrania ścieżek.

Nazwa	Typ	Opis
All	string	Wszystkie utwory zostaną dołączone.
Bottom	string	Pierwszy utwór zostanie uwzględniony, gdy atrybut zostanie posortowany w kolejności rosnącej. Zwykle wybierana jest najmniejsza szybkość transmisji bitów.
Top	string	Pierwsza ścieżka zostanie uwzględniona, gdy atrybut zostanie posortowany w kolejności malejącej. Zazwyczaj wybierana jest największa szybkość transmisji bitów.
ValueEquals	string	Wszystkie ścieżki, które mają atrybut równy podanej wartości, zostaną uwzględnione.

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 wybrany standard AudioAnalysisMode.

Nazwa	Typ	Opis
Basic	string	Ten tryb wykonuje transkrypcję zamiany mowy na tekst i generowanie pliku podtytułu VTT/podpis. 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 uwzględnione 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 opartej na sztucznej inteligencji, w tym transkrypcję mowy. Obecnie ustawienie wstępne obsługuje przetwarzanie zawartości przy użyciu pojedynczego ścieżki audio.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.AudioAnalyzerPreset	Dyskryminujący dla 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ę jego 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 zostanie określony lub ustawiony na wartość null, automatyczne wykrywanie języka wybierze wykryty pierwszy język i przetworzy wybrany język przez cały czas trwania pliku. Obecnie nie obsługuje dynamicznego przełączania między językami po wykryciu pierwszego języka. Automatyczne wykrywanie działa najlepiej z nagraniami audio z wyraźnie zauważalną 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ą uwidocznione w samym wstępnie zdefiniowanym
mode	AudioAnalysisMode	Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrany 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.

AudioTrackDescriptor

Element TrackSelection do wybierania ścieżek dźwiękowych.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.AudioTrackDescriptor	Dyskryminator typów pochodnych.
channelMapping	ChannelMapping	Opcjonalne oznaczenie ścieżek audio pojedynczego kanału. Można użyć do łączenia utworów stereo lub wielokanałowych ścieżek audio.

BlurType

Typ rozmycia

Nazwa	Typ	Opis
Black	string	Czarny: filtr zaciemniania
Box	string	Pole: filtr debugowania, tylko pole ograniczenia
High	string	Wysoki: Dezorientuj 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	Dyskryminujący dla typów pochodnych.
configurations	PresetConfigurations	Opcjonalne ustawienia konfiguracji dla 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.

ChannelMapping

Opcjonalne oznaczenie dla utworów audio z jednym kanałem. Można używać do łączenia utworów w utwory stereo lub wielokanałowe audio.

Nazwa	Typ	Opis
BackLeft	string	Lewy kanał z tyłu. Czasami nazywany kanałem lewego otaczania.
BackRight	string	Prawy kanał z tyłu. Czasami nazywany kanałem Prawej Tulejki.
Center	string	Kanał środkowy.
FrontLeft	string	Kanał z przodu po lewej stronie.
FrontRight	string	Prawy kanał z przodu.
LowFrequencyEffects	string	Kanał efektów o niskiej częstotliwości. Czasami nazywa się to również błędem
StereoLeft	string	Lewy kanał stereo. Czasami określane jako Down Mix Left.
StereoRight	string	Prawy kanał stereo. Czasami określane jako Down Mix Right.

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 do zestawu plików MP4 z wideo H.264 i stereo AAC audio. Automatycznie generuje drabinę szybkości transmisji bitów na podstawie rozdzielczości danych wejściowych, szybkości transmisji bitów i szybkości klatek. Ustawienie wstępne wygenerowane automatycznie nigdy nie przekroczy rozdzielczości wejściowej. 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 zakodowane przy użyciu kodera kodera H.264 o rozmiarze 6750 kb/s i wysokości obrazu 1080 pikseli, a dźwięk stereo jest kodowany za pomocą koderaka AAC-LC o rozmiarze 128 kb/s.
H264SingleBitrate720p	string	Tworzy plik MP4, w którym wideo jest zakodowane przy użyciu kodera kodera H.264 o rozmiarze 4500 kb/s i wysokości obrazu 720 pikseli, a dźwięk stereo jest kodowany za pomocą koderaka AAC-LC o rozmiarze 128 kb/s.
H264SingleBitrateSD	string	Tworzy plik MP4, w którym wideo jest zakodowane przy użyciu kodera kodera H.264 o rozmiarze 2200 kb/s i wysokości obrazu 480 pikseli, a dźwięk stereo jest kodowany za pomocą koderaka 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 wybiera tryb odpowiedni dla profilu i poziomu.

Nazwa	Typ	Opis
Cabac	string	Kodowanie entropii entropii adaptacyjnej binarnej arytmetycznej (CABAC).
Cavlc	string	Koder entropii o zmiennej adaptacyjnej długości kontekstu (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 błędu.

FaceDetectorPreset

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

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.FaceDetectorPreset	Dyskryminujący dla typów pochodnych.
blurType	BlurType	Typ rozmycia
experimentalOptions	object	Słownik zawierający pary wartości klucza dla parametrów, które nie są uwidocznione w samym wstępnie zdefiniowanym
mode	FaceRedactorMode	Ten tryb umożliwia wybór między następującymi ustawieniami: 1) Analizowanie — tylko do wykrywania. W tym trybie jest generowany plik JSON metadanych z oznaczeniem wyglądów twarzy w całym filmie wideo. Jeśli to możliwe, występy tej samej osoby są przypisane do tego samego identyfikatora. 2) Połączone — dodatkowo wykryte twarze są redacts (rozmyte). 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 wideo oraz wybranym przez użytkownika podzbiorem identyfikatorów, które wymagają ponownej analizy.
resolution	AnalysisResolution	Określa maksymalną rozdzielczość, w której jest analizowane wideo. Domyślne zachowanie to "SourceResolution", które zachowa dane wejściowe wideo w oryginalnej rozdzielczości podczas analizowania. Użycie opcji "StandardDefinition" spowoduje zmianę rozmiaru wejściowych filmów wideo na definicję standardową przy zachowaniu odpowiedniego współczynnika proporcji. Zmienia rozmiar tylko wtedy, gdy wideo ma wyższą rozdzielczość. Na przykład dane wejściowe 1920x1080 zostaną skalowane do 640x360 przed przetworzeniem. Przełączenie na "StandardDefinition" skróci czas przetwarzania wideo o wysokiej rozdzielczości. Może również zmniejszyć koszty korzystania z tego składnika (zobacz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics szczegółowe informacje). Jednak twarze, które kończą się 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. W tym trybie jest generowany plik JSON metadanych z oznaczeniem wyglądów twarzy w całym filmie wideo. Jeśli to możliwe, występy tej samej osoby są przypisane do tego samego identyfikatora. 2) Połączone — dodatkowo wykryte twarze są redacts (rozmyte). 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 wideo oraz wybranym przez użytkownika podzbiorem identyfikatorów, które wymagają ponownej analizy.

Nazwa	Typ	Opis
Analyze	string	Tryb analizowania 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 Analizowanie i redagowanie w jednym przebiegu podczas edytowania analizowanych twarzy nie jest pożądane.
Redact	string	Tryb redact używa pliku metadanych z trybu Analizuj 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

FromAllInputFile

InputDefinition, który analizuje wszystkie udostępnione pliki, aby wybrać ścieżki określone przez właściwość IncludedTracks. Ogólnie używane z elementami AudioTrackByAttribute i VideoTrackByAttribute w celu umożliwienia wyboru pojedynczej ścieżki w zestawie plików wejściowych.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.FromAllInputFile	Dyskryminujący dla typów pochodnych.
includedTracks	TrackDescriptor[]: AudioTrackDescriptor[] SelectAudioTrackByAttribute[] SelectAudioTrackById[] SelectVideoTrackByAttribute[] SelectVideoTrackById[] VideoTrackDescriptor[]	Lista klas TrackDescriptor definiujących metadane i wybór ścieżek w danych wejściowych.

FromEachInputFile

Element InputDefinition, który analizuje każdy udostępniony plik wejściowy, aby wybrać ścieżki określone przez właściwość IncludedTracks. Ogólnie używane z audioTrackByAttribute i VideoTrackByAttribute do wybierania ścieżek z każdego pliku podanego.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.FromEachInputFile	Dyskryminujący dla typów pochodnych.
includedTracks	TrackDescriptor[]: AudioTrackDescriptor[] SelectAudioTrackByAttribute[] SelectAudioTrackById[] SelectVideoTrackByAttribute[] SelectVideoTrackById[] VideoTrackDescriptor[]	Lista klas TrackDescriptor definiujących metadane i wybór ścieżek w danych wejściowych.

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 zmniejszenia czasu kodowania.

H264Layer

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

Nazwa	Typ	Opis
adaptiveBFrame	boolean	Niezależnie od tego, 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ą liczbę na podstawie profilu i poziomu wideo.
bitrate	integer	Średnia szybkość transmisji bitów w bitach na sekundę, w której kodowanie wejściowego 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, która ma być używana podczas kodowania tej warstwy. To ustawienie ma zastosowanie, gdy funkcja RateControlMode kodera wideo jest ustawiana w trybie CRF. Zakres wartości CRF wynosi od 0 do 51, gdzie niższe wartości spowodują lepszą jakość, kosztem wyższych 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 wybierze tryb odpowiedni dla profilu i poziomu.
frameRate	string	Szybkość klatek (w ramkach na sekundę), przy której należy zakodować tę warstwę. 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 dozwolonej 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ę 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.
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 pozwala koderowi wybrać poziom odpowiedni 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 wartość co szybkość transmisji bitów.
profile	H264VideoProfile	Obecnie obsługujemy plan bazowy, 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 do użycia 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 wyjściowy film wideo ma połowę tylu pikseli szerokości, jak 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	Dyskryminujący dla 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 klawiszy. Wartość powinna być niezerowa 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 koderacy. Etykieta może służyć do kontrolowania zachowania muxing.
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 — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize
syncMode	VideoSyncMode	Tryb synchronizacji wideo

H264VideoProfile

Obecnie obsługujemy linię bazową, Main, High, High422, High444. Wartość domyślna to Auto.

Nazwa	Typ	Opis
Auto	string	Nakazuje koderowi automatyczne określenie 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ą liczbę na podstawie profilu i poziomu wideo.
bitrate	integer	Średnia szybkość transmisji bitów w bitach na sekundę, w której kodowanie wejściowego 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ć 30000000. Jest to wymagane pole.
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, która ma być używana podczas kodowania tej warstwy. To ustawienie ma zastosowanie, gdy funkcja RateControlMode kodera wideo jest ustawiana w trybie CRF. Zakres wartości CRF wynosi od 0 do 51, gdzie niższe wartości spowodują lepszą jakość, kosztem wyższych 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ść klatek (w ramkach na sekundę), przy której należy zakodować tę warstwę. 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 dozwolonej 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ę 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.
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 wartość 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 do użycia 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 wyjściowy film wideo ma połowę tylu pikseli szerokości, jak 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 główną. Wartość domyślna to Auto.

Nazwa	Typ	Opis
Auto	string	Nakazuje koderowi automatyczne określenie odpowiedniego profilu H.265.
Main	string	Profil główny (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier)
Main10	string	Główny profil 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.

InputFile

Element InputDefinition dla pojedynczego pliku. ŚledzenieWybory są ograniczone do określonego pliku.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.InputFile	Dyskryminujący dla typów pochodnych.
filename	string	Nazwa pliku, do którego ma zastosowanie ta definicja wejściowa.
includedTracks	TrackDescriptor[]: AudioTrackDescriptor[] SelectAudioTrackByAttribute[] SelectAudioTrackById[] SelectVideoTrackByAttribute[] SelectVideoTrackById[] VideoTrackDescriptor[]	Lista klas TrackDescriptor definiujących metadane i wybór ścieżek w danych wejściowych.

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.

Job

Typ zasobu zadania. Postęp i stan można uzyskać, sondując zadanie lub subskrybując zdarzenia przy użyciu usługi EventGrid.

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.correlationData	object	Klucz podany przez klienta, pary wartości, które zostaną zwrócone w zdarzeniach stanu Job i JobOutput.
properties.created	string	Data i godzina UTC utworzenia zadania przez klienta w formacie "RRRR-MM-DDThh:mm:ssZ".
properties.description	string	Opcjonalny klient podał opis zadania.
properties.endTime	string	Data i godzina UTC, o której to zadanie zakończyło przetwarzanie.
properties.input	JobInput: JobInputAsset JobInputClip JobInputHttp JobInputSequence JobInputs	Dane wejściowe zadania.
properties.lastModified	string	Data i godzina UTC ostatniej aktualizacji zadania przez klienta w formacie "RRRR-MM-DDThh:mm:ssZ".
properties.outputs	JobOutput[]: JobOutputAsset[]	Dane wyjściowe zadania.
properties.priority	Priority	Priorytet, za pomocą którego zadanie powinno być przetwarzane. Zadania o wyższym priorytcie są przetwarzane przed zadaniami o niższym priorytcie. Jeśli nie zostanie ustawiona, wartość domyślna jest normalna.
properties.startTime	string	Data i godzina UTC, o której to zadanie rozpoczęło przetwarzanie.
properties.state	JobState	Bieżący stan zadania.
systemData	systemData	Metadane systemowe dotyczące tego zasobu.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

JobError

Szczegóły błędów JobOutput.

Nazwa	Typ	Opis
category	JobErrorCategory	Pomaga w kategoryzacji błędów.
code	JobErrorCode	Kod błędu opisujący błąd.
details	JobErrorDetail[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
message	string	Czytelna dla człowieka reprezentacja błędu zależna od języka.
retry	JobRetry	Wskazuje, że może być możliwe ponowienie próby wykonania zadania. Jeśli ponowna próba nie powiedzie się, skontaktuj się z pomoc techniczna platformy Azure za pośrednictwem witryny Azure Portal.

JobErrorCategory

Pomaga w kategoryzacji błędów.

Nazwa	Typ	Opis
Account	string	Błąd jest związany z informacjami o koncie.
Configuration	string	Błąd jest związany z konfiguracją.
Content	string	Błąd jest związany z danymi w plikach wejściowych.
Download	string	Błąd jest związany z pobieraniem.
Service	string	Błąd jest związany z usługą.
Upload	string	Błąd jest powiązany z przekazywaniem.

JobErrorCode

Kod błędu opisujący błąd.

Nazwa	Typ	Opis
ConfigurationUnsupported	string	Wystąpił problem z kombinacją plików wejściowych i zastosowanych ustawień konfiguracji, napraw ustawienia konfiguracji i ponów próbę przy użyciu tych samych danych wejściowych lub zmień dane wejściowe w celu dopasowania do konfiguracji.
ContentMalformed	string	Wystąpił problem z zawartością wejściową (na przykład: pliki zerowe bajtów lub uszkodzone/nieodkodowalne pliki), sprawdź pliki wejściowe.
ContentUnsupported	string	Wystąpił problem z formatem danych wejściowych (nieprawidłowy plik multimedialny lub nieobsługiwany plik/kodek), sprawdź poprawność plików wejściowych.
DownloadNotAccessible	string	Podczas próby pobrania plików wejściowych pliki nie były dostępne, sprawdź dostępność źródła.
DownloadTransientError	string	Podczas próby pobrania plików wejściowych wystąpił problem podczas transferu (usługa magazynu, błędy sieci), zobacz szczegóły i sprawdź źródło.
IdentityUnsupported	string	Wystąpił błąd podczas weryfikowania tożsamości konta. Sprawdź i napraw konfiguracje tożsamości i ponów próbę. Jeśli nie powiedzie się, skontaktuj się z pomocą techniczną.
ServiceError	string	Błąd usługi krytycznej, skontaktuj się z pomocą techniczną.
ServiceTransientError	string	Błąd przejściowy, ponów próbę, jeśli próba nie powiedzie się, skontaktuj się z pomocą techniczną.
UploadNotAccessible	string	Podczas próby przekazania plików wyjściowych lokalizacja docelowa nie była osiągalna, sprawdź dostępność miejsca docelowego.
UploadTransientError	string	Podczas próby przekazania plików wyjściowych wystąpił problem podczas transferu (usługa magazynu, błędy sieci), zobacz szczegóły i sprawdź miejsce docelowe.

JobErrorDetail

Szczegóły błędów JobOutput.

Nazwa	Typ	Opis
code	string	Kod opisujący szczegóły błędu.
message	string	Czytelna dla człowieka reprezentacja błędu.

JobInputAsset

Reprezentuje zasób dla danych wejściowych w zadaniu.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.JobInputAsset	Dyskryminujący dla typów pochodnych.
assetName	string	Nazwa wejściowego elementu zawartości.
end	ClipTime: AbsoluteClipTime UtcClipTime	Definiuje punkt na osi czasu nośnika wejściowego, na którym zakończy się przetwarzanie. Domyślnie na końcu nośnika wejściowego.
files	string[]	Lista plików. Wymagane dla zadaniaInputHttp. Maksymalnie 4000 znaków każdy. Ciągi zapytań nie zostaną zwrócone w odpowiedziach usługi, aby zapobiec narażeniu poufnych danych.
inputDefinitions	InputDefinition[]: FromAllInputFile[] FromEachInputFile[] InputFile[]	Definiuje listę parametrów InputDefinitions. Dla każdego elementu InputDefinition definiuje listę śledzenia wyborów i powiązanych metadanych.
label	string	Etykieta przypisana do elementu JobInputClip, która jest używana do spełnienia odwołania używanego w przekształceniu. Na przykład można utworzyć przekształcenie, aby utworzyć plik obrazu z etykietą "xyz" i zastosować ją jako nakładkę na wejściowy film wideo, zanim zostanie zakodowany. Podczas przesyłania zadania dokładnie jeden z elementów JobInputs powinien być plikiem obrazu i powinien mieć etykietę "xyz".
start	ClipTime: AbsoluteClipTime UtcClipTime	Definiuje punkt na osi czasu nośnika wejściowego, na którym rozpocznie się przetwarzanie. Wartość domyślna to początek nośnika wejściowego.

JobInputClip

Reprezentuje pliki wejściowe zadania.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.JobInputClip	Dyskryminujący dla typów pochodnych.
end	ClipTime: AbsoluteClipTime UtcClipTime	Definiuje punkt na osi czasu nośnika wejściowego, na którym zakończy się przetwarzanie. Domyślnie na końcu nośnika wejściowego.
files	string[]	Lista plików. Wymagane dla zadaniaInputHttp. Maksymalnie 4000 znaków każdy. Ciągi zapytań nie zostaną zwrócone w odpowiedziach usługi, aby zapobiec narażeniu poufnych danych.
inputDefinitions	InputDefinition[]: FromAllInputFile[] FromEachInputFile[] InputFile[]	Definiuje listę parametrów InputDefinitions. Dla każdego elementu InputDefinition definiuje listę śledzenia wyborów i powiązanych metadanych.
label	string	Etykieta przypisana do elementu JobInputClip, która jest używana do spełnienia odwołania używanego w przekształceniu. Na przykład można utworzyć przekształcenie, aby utworzyć plik obrazu z etykietą "xyz" i zastosować ją jako nakładkę na wejściowy film wideo, zanim zostanie zakodowany. Podczas przesyłania zadania dokładnie jeden z elementów JobInputs powinien być plikiem obrazu i powinien mieć etykietę "xyz".
start	ClipTime: AbsoluteClipTime UtcClipTime	Definiuje punkt na osi czasu nośnika wejściowego, na którym rozpocznie się przetwarzanie. Wartość domyślna to początek nośnika wejściowego.

JobInputHttp

Reprezentuje dane wejściowe zadania HTTPS.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.JobInputHttp	Dyskryminujący dla typów pochodnych.
baseUri	string	Podstawowy identyfikator URI dla danych wejściowych zadania HTTPS. Zostanie ona połączona z podanymi nazwami plików. Jeśli nie podano podstawowego identyfikatora URI, zakłada się, że podana lista plików jest w pełni kwalifikowana. Maksymalna długość 4000 znaków. Ciągi zapytania nie zostaną zwrócone w odpowiedziach usługi, aby zapobiec narażeniu poufnych danych.
end	ClipTime: AbsoluteClipTime UtcClipTime	Definiuje punkt na osi czasu nośnika wejściowego, na którym zakończy się przetwarzanie. Domyślnie na końcu nośnika wejściowego.
files	string[]	Lista plików. Wymagane dla zadaniaInputHttp. Maksymalnie 4000 znaków każdy. Ciągi zapytań nie zostaną zwrócone w odpowiedziach usługi, aby zapobiec narażeniu poufnych danych.
inputDefinitions	InputDefinition[]: FromAllInputFile[] FromEachInputFile[] InputFile[]	Definiuje listę parametrów InputDefinitions. Dla każdego elementu InputDefinition definiuje listę śledzenia wyborów i powiązanych metadanych.
label	string	Etykieta przypisana do elementu JobInputClip, która jest używana do spełnienia odwołania używanego w przekształceniu. Na przykład można utworzyć przekształcenie, aby utworzyć plik obrazu z etykietą "xyz" i zastosować ją jako nakładkę na wejściowy film wideo, zanim zostanie zakodowany. Podczas przesyłania zadania dokładnie jeden z elementów JobInputs powinien być plikiem obrazu i powinien mieć etykietę "xyz".
start	ClipTime: AbsoluteClipTime UtcClipTime	Definiuje punkt na osi czasu nośnika wejściowego, na którym rozpocznie się przetwarzanie. Wartość domyślna to początek nośnika wejściowego.

JobInputs

Opisuje listę danych wejściowych zadania.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.JobInputs	Dyskryminujący dla typów pochodnych.
inputs	JobInput[]: JobInputAsset[] JobInputClip[] JobInputHttp[] JobInputSequence[] JobInputs[]	Lista danych wejściowych zadania.

JobInputSequence

Sekwencja zawiera uporządkowaną listę klipów, w których każdy klip jest obiektem JobInput. Sekwencja będzie traktowana jako pojedyncze dane wejściowe.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.JobInputSequence	Dyskryminujący dla typów pochodnych.
inputs	JobInputClip[]: JobInputAsset[] JobInputHttp[]	JobInputs, które tworzą oś czasu.

JobOutputAsset

Reprezentuje zasób używany jako jobOutput.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.JobOutputAsset	Dyskryminujący dla typów pochodnych.
assetName	string	Nazwa wyjściowego elementu zawartości.
endTime	string	Data i godzina UTC, o której to zadanie wyjściowe zakończyło przetwarzanie.
error	JobError	Jeśli parametr JobOutput jest w stanie Błąd, zawiera szczegóły błędu.
label	string	Etykieta przypisana do obiektu JobOutput w celu uzyskania unikatowej identyfikacji. Jest to przydatne, gdy przekształcenie ma więcej niż jedną pozycję TransformOutput, gdzie zadanie ma więcej niż jedną wartość JobOutput. W takich przypadkach po przesłaniu zadania dodasz co najmniej dwa obiekty JobOutputs w tej samej kolejności co TransformOutputs w przekształceniu. Następnie podczas pobierania zadania za pośrednictwem zdarzeń lub żądania GET można użyć etykiety, aby łatwo zidentyfikować zadanieOutput. Jeśli etykieta nie zostanie podana, zostanie użyta domyślna wartość "{presetName}_{outputIndex}", gdzie wstępnie ustawiona nazwa to nazwa ustawienia wstępnego w odpowiadającym parametrze TransformOutput, a indeks wyjściowy jest względnym indeksem tego obiektu JobOutput w zadaniu. Należy pamiętać, że ten indeks jest taki sam jak względny indeks odpowiadającej funkcji TransformOutput w ramach przekształcenia.
presetOverride	Preset: AudioAnalyzerPreset BuiltInStandardEncoderPreset FaceDetectorPreset StandardEncoderPreset VideoAnalyzerPreset	Ustawienie wstępne używane do zastępowania ustawień wstępnych w odpowiednich danych wyjściowych przekształcenia.
progress	integer	Jeśli wartość JobOutput jest w stanie Przetwarzanie, zawiera wartość procentową ukończenia zadania. Wartość jest szacowana i nie jest przeznaczona do przewidywania czasów ukończenia zadania. Aby określić, czy zadanieOutput jest ukończone, użyj właściwości State.
startTime	string	Data i godzina UTC rozpoczęcia przetwarzania danych wyjściowych zadania.
state	JobState	Opisuje stan elementu JobOutput.

JobRetry

Wskazuje, że może być możliwe ponowienie próby wykonania zadania. Jeśli ponowna próba nie powiedzie się, skontaktuj się z pomoc techniczna platformy Azure za pośrednictwem witryny Azure Portal.

Nazwa	Typ	Opis
DoNotRetry	string	Problem należy zbadać, a następnie ponownie przesłać zadanie z korektami lub ponowić próbę po skorygowaniu podstawowego problemu.
MayRetry	string	Problem może zostać rozwiązany po upływie czasu i ponownym przesłaniu tego samego zadania.

JobState

Opisuje stan elementu JobOutput.

Nazwa	Typ	Opis
Canceled	string	Zadanie zostało anulowane. Jest to ostateczny stan zadania.
Canceling	string	Zadanie jest w trakcie anulowania. Jest to stan przejściowy dla zadania.
Error	string	Zadanie napotkało błąd. Jest to ostateczny stan zadania.
Finished	string	Zadanie zostało zakończone. Jest to ostateczny stan zadania.
Processing	string	Zadanie jest przetwarzane. Jest to stan przejściowy dla zadania.
Queued	string	Zadanie jest w stanie w kolejce, czekając na udostępnienie zasobów. Jest to stan przejściowy.
Scheduled	string	Zadanie jest zaplanowane do uruchomienia w dostępnym zasobie. Jest to stan przejściowy między stanem w kolejce i stanem przetwarzania.

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	Dyskryminujący dla typów pochodnych.
keyFrameInterval	string	Odległość między dwiema ramkami klawiszy. Wartość powinna być niezerowa 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 koderacy. Etykieta może służyć do kontrolowania zachowania muxing.
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, na którym zatrzymaj generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT5M30S zatrzymać się o 5 minutach i 30 sekund od czasu rozpoczęcia) lub liczbę ramek (na przykład 300, aby zatrzymać się na 300 ramce od 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 sprite. Uwaga: ta wartość powinna być dodatnią liczbą całkowitą, a 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 chcesz rozpocząć generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT05S do rozpoczęcia od 5 sekund) lub liczby ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względnej wartości czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Obsługuje również makro {Best}, które informuje koder o wybraniu najlepszej miniatury z pierwszych kilku sekund filmu wideo i utworzy tylko jedną miniaturę, bez względu na to, jakie są inne ustawienia dla kroku 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 czasie rozpoczęcia wstępnego przekształcania. Jest to spowodowane koderem, który próbuje wybrać najlepszą miniaturę między godziną rozpoczęcia a pozycją Krok od momentu 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ść Zakres na 1, jeśli tylko jedna miniatura jest potrzebna w czasie rozpoczęcia.
stretchMode	StretchMode	Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości 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ę 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.
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 wyjściowy film wideo ma połowę tylu pikseli szerokości, jak 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ą.

OutputFile

Reprezentuje utworzony plik wyjściowy.

Nazwa	Typ	Opis
labels	string[]	Lista etykiet opisujących, jak koder powinien multipleksować wideo i audio do pliku wyjściowego. 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]" nakazuje koderowi wygenerowanie pliku wyjściowego ze ścieżką wideo reprezentowaną przez 1 i ścieżkę dźwiękową reprezentowaną przez element 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 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.

PngImage

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

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.PngImage	Dyskryminujący dla typów pochodnych.
keyFrameInterval	string	Odległość między dwiema ramkami klawiszy. Wartość powinna być niezerowa 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 koderacy. Etykieta może służyć do kontrolowania zachowania muxing.
layers	PngLayer[]	Kolekcja wyjściowych warstw obrazów PNG, 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, na którym zatrzymaj generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT5M30S zatrzymać się o 5 minutach i 30 sekund od czasu rozpoczęcia) lub liczbę ramek (na przykład 300, aby zatrzymać się na 300 ramce od 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 chcesz rozpocząć generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT05S do rozpoczęcia od 5 sekund) lub liczby ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względnej wartości czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Obsługuje również makro {Best}, które informuje koder o wybraniu najlepszej miniatury z pierwszych kilku sekund filmu wideo i utworzy tylko jedną miniaturę, bez względu na to, jakie są inne ustawienia dla kroku 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 czasie rozpoczęcia wstępnego przekształcania. Jest to spowodowane koderem, który próbuje wybrać najlepszą miniaturę między godziną rozpoczęcia a pozycją Krok od momentu 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ść Zakres na 1, jeśli tylko jedna miniatura jest potrzebna w czasie rozpoczęcia.
stretchMode	StretchMode	Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości 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 dla 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 przeplatania 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 audio i wideo w oddzielnych plikach MP4.
keyFrameIntervalInSeconds	number	Interwał ramki klucza w sekundach. Przykład: ustaw wartość KeyFrameIntervalInSeconds jako 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 wartość MaxBitrateBps jako 6000000, aby uniknąć tworzenia bardzo wysokich danych wyjściowych 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 dane wejściowe to 4K.
maxLayers	integer	Maksymalna liczba wyjściowych warstw wideo. Przykład: ustaw wartość MaxLayers jako 4, aby upewnić się, że maksymalnie 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ć warstwę dolną obejmującą 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 transformOutputs w ramach przekształcenia. Określa priorytet używany przez usługę do przetwarzania funkcji TransformOutputs. Domyślny priorytet to Normal.

Nazwa	Typ	Opis
High	string	Służy do przekształcaniaOutputs, które powinny mieć pierwszeństwo przed innymi.
Low	string	Służy do przekształcaniaOutputs, które można wygenerować po normalnych i wysokich priorytetach TransformOutputs.
Normal	string	Służy do przekształcaniaOutputs, które można wygenerować przy normalnym priorytetyzowanym.

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.

SelectAudioTrackByAttribute

Wybierz ścieżki audio z danych wejściowych, określając atrybut i filtr atrybutu.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.SelectAudioTrackByAttribute	Dyskryminator typów pochodnych.
attribute	TrackAttribute	Element TrackAttribute do filtrowania ścieżek według.
channelMapping	ChannelMapping	Opcjonalne oznaczenie ścieżek audio pojedynczego kanału. Można użyć do łączenia utworów stereo lub wielokanałowych ścieżek audio.
filter	AttributeFilter	Typ atrybutu AttributeFilter, który ma być stosowany do elementu TrackAttribute w celu wybrania ścieżek.
filterValue	string	Wartość do filtrowania ścieżek według. Używane tylko wtedy, gdy atrybutFilter.ValueEquals jest określony dla właściwości Filter.

SelectAudioTrackById

Wybierz ścieżki audio z danych wejściowych, określając identyfikator ścieżki.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.SelectAudioTrackById	Dyskryminator typów pochodnych.
channelMapping	ChannelMapping	Opcjonalne oznaczenie ścieżek audio pojedynczego kanału. Można użyć do łączenia utworów stereo lub wielokanałowych ścieżek audio.
trackId	integer	Śledzenie identyfikatora do wybrania

SelectVideoTrackByAttribute

Wybierz ścieżki wideo z danych wejściowych, określając atrybut i filtr atrybutu.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.SelectVideoTrackByAttribute	Dyskryminator typów pochodnych.
attribute	TrackAttribute	Element TrackAttribute do filtrowania ścieżek według.
filter	AttributeFilter	Typ atrybutu AttributeFilter, który ma być stosowany do elementu TrackAttribute w celu wybrania ścieżek.
filterValue	string	Wartość do filtrowania ścieżek według. Używane tylko wtedy, gdy atrybutFilter.ValueEquals jest określony dla właściwości Filter. W przypadku funkcji TrackAttribute.Bitrate powinna to być wartość całkowita w bitach na sekundę (np. "1500000"). Język TrackAttribute.Language nie jest obsługiwany w przypadku ścieżek wideo.

SelectVideoTrackById

Wybierz ścieżkę wideo z danych wejściowych, określając identyfikator śledzenia.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.SelectVideoTrackById	Dyskryminator typów pochodnych.
trackId	integer	Śledzenie identyfikatora do wybrania

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	Dyskryminujący dla typów pochodnych.
codecs	Codec[]: AacAudio[] Audio[] CopyAudio[] CopyVideo[] DDAudio[] H264Video[] H265Video[] Image[] JpgImage[] PngImage[] Video[]	Lista 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ą uwidocznione w samym wstępnie zdefiniowanym
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 zasobu (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.

TrackAttribute

Element TrackAttribute do filtrowania ścieżek według.

Nazwa	Typ	Opis
Bitrate	string	Szybkość transmisji bitów ścieżki.
Language	string	Język toru.

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ą.

UtcClipTime

Określa godzinę klipu jako pozycję czasu Utc w pliku multimedialnym. Czas Utc może wskazywać inną pozycję w zależności od tego, czy plik multimedialny rozpoczyna się od znacznika czasu zera, czy nie.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.UtcClipTime	Dyskryminujący dla typów pochodnych.
time	string	Położenie czasu na osi czasu nośnika wejściowego na podstawie czasu UTC.

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	Dyskryminujący dla 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ę jego 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 zostanie określony lub ustawiony na wartość null, automatyczne wykrywanie języka wybierze wykryty pierwszy język i przetworzy wybrany język przez cały czas trwania pliku. Obecnie nie obsługuje dynamicznego przełączania między językami po wykryciu pierwszego języka. Automatyczne wykrywanie działa najlepiej z nagraniami audio z wyraźnie zauważalną 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ą uwidocznione w samym wstępnie zdefiniowanym
insightsToExtract	InsightsType	Definiuje typ szczegółowych informacji, które mają zostać wygenerowane przez usługę. Dozwolone wartości to "AudioInsightsOnly", "VideoInsightsOnly" i "AllInsights". Wartość domyślna to AllInsights. Jeśli ustawisz tę wartość na Wartość AllInsights, a dane wejściowe są tylko audio, generowane są tylko szczegółowe informacje audio. 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. Zadania w takich warunkach wymykałyby się.
mode	AudioAnalysisMode	Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrany 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

VideoTrackDescriptor

Element TrackSelection do wybierania ścieżek wideo.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Media.VideoTrackDescriptor	Dyskryminator typów pochodnych.