Transforms - Create Or Update

Service:

Media Services

API Version:

2022-07-01

Skapa eller uppdatera transformering
Skapar eller uppdaterar en ny transformering.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string	Media Services-kontonamnet.
resourceGroupName	path	True	string	Namnet på resursgruppen i Azure-prenumerationen.
subscriptionId	path	True	string	Den unika identifieraren för en Microsoft Azure-prenumeration.
transformName	path	True	string	Transformeringsnamnet.
api-version	query	True	string	Den version av API:et som ska användas med klientbegäran.

Begärandetext

Name	Obligatorisk	Typ	Description
properties.outputs	True	TransformOutput[]	En matris med ett eller flera TransformOutputs som transformering ska generera.
properties.description		string	En valfri utförlig beskrivning av transformering.

Svar

Name	Typ	Description
200 OK	Transform	OK
201 Created	Transform	Skapad
Other Status Codes	ErrorResponse	Detaljerad felinformation.

Exempel

Create or update a Transform

Sample Request

HTTP

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

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

Java

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

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

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

Python

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

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

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


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

    response = client.transforms.create_or_update(
        resource_group_name="contosoresources",
        account_name="contosomedia",
        transform_name="createdTransform",
        parameters={
            "properties": {
                "description": "Example Transform to illustrate create and update.",
                "outputs": [
                    {
                        "preset": {
                            "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
                            "presetName": "AdaptiveStreaming",
                        }
                    }
                ],
            }
        },
    )
    print(response)


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

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

Go

package armmediaservices_test

import (
	"context"
	"log"

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

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

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

JavaScript

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

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

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

dotnet

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

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

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

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

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

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

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

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

Sample Response

Status code:

201

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

Status code:

200

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

Definitioner

Name	Description
AacAudio	Beskriver inställningar för AAC-ljudkodning (Advanced Audio Codec).
AacAudioProfile	Den kodningsprofil som ska användas vid kodning av ljud med AAC.
AnalysisResolution	Anger den maximala upplösningen som videon analyseras med. Standardbeteendet är "SourceResolution", som håller indatavideon på sin ursprungliga upplösning när den analyseras. Om du använder "StandardDefinition" ändras storleken på indatavideor till standarddefinitionen samtidigt som rätt proportioner bevaras. Den ändrar bara storlek om videon har högre upplösning. Till exempel skulle indata från 1920x1080 skalas till 640 x 360 innan bearbetningen. Om du växlar till "StandardDefinition" minskar du den tid det tar att bearbeta video med hög upplösning. Det kan också minska kostnaden för att använda den här komponenten (se https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics mer information). Men ansikten som blir för små i den storleksanpassade videon kanske inte identifieras.
Audio	Definierar de vanliga egenskaperna för alla ljud codecs.
AudioAnalysisMode	Avgör vilken uppsättning ljudanalysåtgärder som ska utföras. Om det är ospecificerat väljs Standard AudioAnalysisMode.
AudioAnalyzerPreset	Förinställningen Audio Analyzer tillämpar en fördefinierad uppsättning AI-baserade analysåtgärder, inklusive taltranskription. För närvarande stöder förinställningen bearbetning av innehåll med ett enda ljudspår.
AudioOverlay	Beskriver egenskaperna för ett ljudöverlägg.
BlurType	Oskärpatyp
BuiltInStandardEncoderPreset	Beskriver en inbyggd förinställning för kodning av indatavideon med standardkodaren.
Complexity	Gör att du kan konfigurera kodarinställningarna för att styra balansen mellan hastighet och kvalitet. Exempel: ange Komplexitet som Hastighet för snabbare kodning men mindre komprimeringseffektivitet.
CopyAudio	En codec-flagga som instruerar kodaren att kopiera bitströmmen för indataljudet.
CopyVideo	En codec-flagga som instruerar kodaren att kopiera indatavideons bitström utan omkodning.
createdByType	Den typ av identitet som skapade resursen.
DDAudio	Beskriver ljudkodningsinställningarna för Dolby Digital Audio Codec (AC3). Den aktuella implementeringen för Dolby Digital Audio-stöd är: Ljudkanalnummer på 1(mono), 2 (stereo), 6(5.1side); Frekvens för ljudsampling vid: 32K/44.1K/48K Hz; Värden för ljudbithastighet som AC3-specifikation stöder: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.
Deinterlace	Beskriver de sammanflätande inställningarna.
DeinterlaceMode	Deinterlacing-läget. Standardvärdet är AutoPixelAdaptive.
DeinterlaceParity	Fältparitet för avflätning, standardvärdet Auto.
EncoderNamedPreset	Den inbyggda förinställningen som ska användas för kodning av videor.
EntropyMode	Entropy-läget som ska användas för det här lagret. Om det inte anges väljer kodaren det läge som är lämpligt för profilen och nivån.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
FaceDetectorPreset	Beskriver alla inställningar som ska användas när du analyserar en video för att identifiera (och eventuellt redigera) alla ansikten som finns.
FaceRedactorMode	Det här läget ger möjlighet att välja mellan följande inställningar: 1) Analysera – Endast för identifiering. Det här läget genererar en metadata-JSON-fil som markerar ansiktens utseende i hela videon. När det är möjligt tilldelas utseenden av samma person samma ID. 2) Kombinerat – Dessutom redigerar (suddar) identifierade ansikten. 3) Redact – Detta möjliggör en 2-pass-process, vilket möjliggör selektiv redigering av en delmängd av identifierade ansikten. Den tar in metadatafilen från ett tidigare analyspass, tillsammans med källvideon, och en användarvald delmängd av ID:t som kräver redigering.
Fade	Beskriver egenskaperna för en Toningseffekt som tillämpas på indatamediet.
Filters	Beskriver alla filtreringsåtgärder, till exempel avflätning, rotation osv. som ska tillämpas på indatamediet före kodning.
H264Complexity	Talar om för kodaren hur kodningsinställningarna ska väljas. Standardvärdet är Balanserad.
H264Layer	Beskriver de inställningar som ska användas när du kodar indatavideon i ett önskat lager med bithastighet för utdata med H.264-videokodningen.
H264RateControlMode	Videohastighetskontrollläget
H264Video	Beskriver alla egenskaper för att koda en video med H.264 codec.
H264VideoProfile	Vi stöder för närvarande Baseline, Main, High, High422, High444. Standardvärdet är Auto.
H265Complexity	Talar om för kodaren hur kodningsinställningarna ska väljas. Kvalitet ger ett högre komprimeringsförhållande men till en högre kostnad och längre beräkningstid. Hastighet kommer att producera en relativt större fil men är snabbare och mer ekonomisk. Standardvärdet är Balanserad.
H265Layer	Beskriver de inställningar som ska användas när indatavideon kodas till ett önskat bithastighetslager för utdata med videokodcen H.265.
H265Video	Beskriver alla egenskaper för att koda en video med H.265 codec.
H265VideoProfile	Vi stöder för närvarande Main. Standardvärdet är Auto.
Image	Beskriver de grundläggande egenskaperna för att generera miniatyrer från indatavideon
ImageFormat	Beskriver egenskaperna för en utdatabildfil.
InsightsType	Definierar den typ av insikter som du vill att tjänsten ska generera. De tillåtna värdena är "AudioInsightsOnly", "VideoInsightsOnly" och "AllInsights". Standardvärdet är AllInsights. Om du ställer in detta på AllInsights och indata endast är ljud genereras endast ljudinsikter. På samma sätt genereras endast videoinsikter om indata endast är videoindata. Vi rekommenderar att du inte använder AudioInsightsOnly om du förväntar dig att vissa av dina indata endast ska vara video. eller använd VideoInsightsOnly om du förväntar dig att vissa av dina indata endast ska vara ljud. Dina jobb under sådana förhållanden skulle felsökas.
InterleaveOutput	Anger intersparläge för utdata för att styra hur ljud och video lagras i containerformatet. Exempel: Ange InterleavedOutput som NonInterleavedOutput för att producera ljudbaserade och endast videoutdata i separata MP4-filer.
JpgFormat	Beskriver inställningarna för att skapa JPEG-miniatyrer.
JpgImage	Beskriver egenskaperna för att skapa en serie JPEG-bilder från indatavideon.
JpgLayer	Beskriver inställningarna för att skapa en JPEG-bild från indatavideon.
Mp4Format	Beskriver egenskaperna för en ISO MP4-utdatafil.
MultiBitrateFormat	Beskriver egenskaperna för att skapa en samling GOP-justerade filer med flera bithastigheter. Standardbeteendet är att skapa en utdatafil för varje videoskikt som är muxed tillsammans med alla ljud. De exakta utdatafiler som skapas kan styras genom att ange outputFiles-samlingen.
OnErrorType	En transformering kan definiera fler än en utdata. Den här egenskapen definierar vad tjänsten ska göra när en utdata misslyckas – antingen fortsätter du att skapa andra utdata eller stoppar de andra utdata. Det övergripande jobbtillståndet återspeglar inte fel i utdata som har angetts med "ContinueJob". Standardvärdet är "StopProcessingJob".
OutputFile	Representerar en utdatafil som skapats.
PngFormat	Beskriver inställningarna för att skapa PNG-miniatyrer.
PngImage	Beskriver egenskaperna för att producera en serie PNG-bilder från indatavideon.
PngLayer	Beskriver inställningarna för att skapa en PNG-bild från indatavideon.
PresetConfigurations	Ett objekt med valfria konfigurationsinställningar för kodaren.
Priority	Anger den relativa prioriteten för TransformOutputs i en transformering. Detta anger den prioritet som tjänsten använder för bearbetning av TransformOutputs. Standardprioriteten är Normal.
Rectangle	Beskriver egenskaperna för ett rektangulärt fönster som tillämpas på indatamediet innan det bearbetas.
Rotation	Rotationen, om den finns, som ska tillämpas på indatavideon innan den kodas. Standardvärdet är Auto
StandardEncoderPreset	Beskriver alla inställningar som ska användas vid kodning av indatavideon med standardkodaren.
StretchMode	Storleksändringsläget – hur indatavideon ändras så att den passar önskad utdataupplösning. Standardinställningen är AutoSize
systemData	Metadata som rör skapande och senaste ändring av resursen.
Transform	En transformering kapslar in regler eller instruktioner för att generera önskade utdata från indatamedia, till exempel genom transkodning eller genom att extrahera insikter. När transformering har skapats kan den tillämpas på indatamedia genom att skapa jobb.
TransformOutput	Beskriver egenskaperna för ett TransformOutput, som är de regler som ska tillämpas när du genererar önskade utdata.
TransportStreamFormat	Beskriver egenskaperna för att generera utdatavideofiler för MPEG-2 Transport Stream (ISO/IEC 13818-1).
Video	Beskriver de grundläggande egenskaperna för att koda indatavideon.
VideoAnalyzerPreset	En förinställning för videoanalys som extraherar insikter (omfattande metadata) från både ljud och video och matar ut en JSON-formatfil.
VideoOverlay	Beskriver egenskaperna för ett videoöverlägg.
VideoSyncMode	Läget för videosynkronisering

AacAudio

Beskriver inställningar för AAC-ljudkodning (Advanced Audio Codec).

Name	Typ	Description
@odata.type	string: #Microsoft.Media.AacAudio	Diskriminator för härledda typer.
bitrate	integer	Bithastigheten, i bitar per sekund, för utdatakodat ljud.
channels	integer	Antalet kanaler i ljudet.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.
profile	AacAudioProfile	Kodningsprofilen som ska användas vid kodning av ljud med AAC.
samplingRate	integer	Samplingsfrekvensen som ska användas för kodning i hertz.

AacAudioProfile

Den kodningsprofil som ska användas vid kodning av ljud med AAC.

Name	Typ	Description
AacLc	string	Anger att utdataljudet ska kodas till AAC Low Complexity Profile (AAC-LC).
HeAacV1	string	Anger att utdataljudet ska kodas till HE-AAC v1-profilen.
HeAacV2	string	Anger att utdataljudet ska kodas till HE-AAC v2-profilen.

AnalysisResolution

Anger den maximala upplösningen som videon analyseras med. Standardbeteendet är "SourceResolution", som håller indatavideon på sin ursprungliga upplösning när den analyseras. Om du använder "StandardDefinition" ändras storleken på indatavideor till standarddefinitionen samtidigt som rätt proportioner bevaras. Den ändrar bara storlek om videon har högre upplösning. Till exempel skulle indata från 1920x1080 skalas till 640 x 360 innan bearbetningen. Om du växlar till "StandardDefinition" minskar du den tid det tar att bearbeta video med hög upplösning. Det kan också minska kostnaden för att använda den här komponenten (se https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics mer information). Men ansikten som blir för små i den storleksanpassade videon kanske inte identifieras.

Name	Typ	Description
SourceResolution	string
StandardDefinition	string

Audio

Definierar de vanliga egenskaperna för alla ljud codecs.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.Audio	Diskrimineringen för härledda typer.
bitrate	integer	Bithastigheten i bitar per sekund för utdatakodat ljud.
channels	integer	Antalet kanaler i ljudet.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.
samplingRate	integer	Samplingsfrekvensen som ska användas för kodning i hertz.

AudioAnalysisMode

Avgör vilken uppsättning ljudanalysåtgärder som ska utföras. Om det är ospecificerat väljs Standard AudioAnalysisMode.

Name	Typ	Description
Basic	string	Det här läget utför tal-till-text-transkription och generering av en VTT-undertext/bildtext fil. Utdata från det här läget innehåller en Insights JSON-fil som endast innehåller nyckelord, transkription och tidsinformation. Automatisk språkidentifiering och talardiarisering ingår inte i det här läget.
Standard	string	Utför alla åtgärder som ingår i basic-läget, och utför dessutom språkidentifiering och talardiarisering.

AudioAnalyzerPreset

Förinställningen Audio Analyzer tillämpar en fördefinierad uppsättning AI-baserade analysåtgärder, inklusive taltranskription. För närvarande stöder förinställningen bearbetning av innehåll med ett enda ljudspår.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.AudioAnalyzerPreset	Diskriminator för härledda typer.
audioLanguage	string	Språket för ljudnyttolasten i indata med BCP-47-formatet "language tag-region" (t.ex. "en-US"). Om du känner till språket i ditt innehåll rekommenderar vi att du anger det. Språket måste anges explicit för AudioAnalysisMode::Basic, eftersom automatisk språkidentifiering inte ingår i grundläggande läge. Om språket inte anges eller är inställt på null väljer automatisk språkidentifiering det första språk som identifieras och bearbetar med det valda språket under filens varaktighet. Det stöder för närvarande inte dynamisk växling mellan språk när det första språket har identifierats. Den automatiska identifieringen fungerar bäst med ljudinspelningar med tydligt urskiljbart tal. Om den automatiska identifieringen inte hittar språket skulle transkriptionen återgå till "en-US". Listan över språk som stöds finns här: https://go.microsoft.com/fwlink/?linkid=2109463
experimentalOptions	object	Ordlista som innehåller nyckel/värde-par för parametrar som inte exponeras i själva förinställningen
mode	AudioAnalysisMode	Avgör vilken uppsättning ljudanalysåtgärder som ska utföras. Om det inte anges väljs Standard AudioAnalysisMode.

AudioOverlay

Beskriver egenskaperna för ett ljudöverlägg.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.AudioOverlay	Diskrimineringen för härledda typer.
audioGainLevel	number	Ljudökningsnivån i överlägget. Värdet ska ligga i intervallet [0, 1.0]. Standardvärdet är 1,0.
end	string	Slutpositionen, med referens till indatavideon, där överlägget slutar. Värdet ska vara i ISO 8601-format. Till exempel PT30S för att avsluta överlägget 30 sekunder in i indatavideon. Om värdet inte anges eller om värdet är större än varaktigheten för indatavideon tillämpas överlägget till slutet av indatavideon om medievaraktigheten för överlägget är större än videons varaktighet, annars varar överlägget så länge som överläggets medievaraktighet.
fadeInDuration	string	Hur lång tid överlägget tonas in i indatavideon. Värdet ska vara i ISO 8601-varaktighetsformat. Om inte anges är standardbeteendet att inte ha någon toning i (samma som PT0S).
fadeOutDuration	string	Hur lång tid överlägget tonas ut från indatavideon. Värdet ska vara i ISO 8601-varaktighetsformat. Om inte anges är standardbeteendet att inte ha någon toning (samma som PT0S).
inputLabel	string	Etiketten för jobbindata som ska användas som ett överlägg. Indata måste ange exakt en fil. Du kan ange en bildfil i JPG-, PNG-, GIF- eller BMP-format eller en ljudfil (till exempel en WAV-, MP3-, WMA- eller M4A-fil) eller en videofil. Se https://aka.ms/mesformats den fullständiga listan över ljud- och videofilformat som stöds.
start	string	Startpositionen, med referens till indatavideon, där överlägget startar. Värdet ska vara i ISO 8601-format. Till exempel PT05S för att starta överlägget vid 5 sekunder i indatavideon. Om det inte anges startar överlägget från början av indatavideon.

BlurType

Oskärpatyp

Name	Typ	Description
Black	string	Svart: Filter för att mörkna
Box	string	Ruta: Felsökningsfilter, endast avgränsningsruta
High	string	Hög: Förvirra oskärpa filter
Low	string	Låg: filtret för oskärpa i ruta-bil
Med	string	Med: Gaussian blur filter

BuiltInStandardEncoderPreset

Beskriver en inbyggd förinställning för kodning av indatavideon med standardkodaren.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.BuiltInStandardEncoderPreset	Diskriminator för härledda typer.
configurations	PresetConfigurations	Valfria konfigurationsinställningar för kodare. Konfigurationer stöds endast för ContentAwareEncoding och H265ContentAwareEncoding BuiltInStandardEncoderPreset.
presetName	EncoderNamedPreset	Den inbyggda förinställningen som ska användas för kodning av videor.

Complexity

Gör att du kan konfigurera kodarinställningarna för att styra balansen mellan hastighet och kvalitet. Exempel: ange Komplexitet som Hastighet för snabbare kodning men mindre komprimeringseffektivitet.

Name	Typ	Description
Balanced	string	Konfigurerar kodaren för att använda inställningar som uppnår en balans mellan hastighet och kvalitet.
Quality	string	Konfigurerar kodaren för att använda inställningar som är optimerade för att generera utdata av högre kvalitet på bekostnad av långsammare övergripande kodningstid.
Speed	string	Konfigurerar kodaren för att använda inställningar som är optimerade för snabbare kodning. Kvalitet offras för att minska kodningstiden.

CopyAudio

En codec-flagga som instruerar kodaren att kopiera bitströmmen för indataljudet.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.CopyAudio	Diskrimineringen för härledda typer.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.

CopyVideo

En codec-flagga som instruerar kodaren att kopiera indatavideons bitström utan omkodning.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.CopyVideo	Diskrimineringen för härledda typer.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DDAudio

Beskriver ljudkodningsinställningarna för Dolby Digital Audio Codec (AC3). Den aktuella implementeringen för Dolby Digital Audio-stöd är: Ljudkanalnummer på 1(mono), 2 (stereo), 6(5.1side); Frekvens för ljudsampling vid: 32K/44.1K/48K Hz; Värden för ljudbithastighet som AC3-specifikation stöder: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.DDAudio	Diskriminator för härledda typer.
bitrate	integer	Bithastigheten, i bitar per sekund, för utdatakodat ljud.
channels	integer	Antalet kanaler i ljudet.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.
samplingRate	integer	Samplingsfrekvensen som ska användas för kodning i hertz.

Deinterlace

Beskriver de sammanflätande inställningarna.

Name	Typ	Description
mode	DeinterlaceMode	Deinterlacing-läget. Standardvärdet är AutoPixelAdaptive.
parity	DeinterlaceParity	Fältparitet för avflätning, standardvärdet Auto.

DeinterlaceMode

Deinterlacing-läget. Standardvärdet är AutoPixelAdaptive.

Name	Typ	Description
AutoPixelAdaptive	string	Använd automatisk pixelanpassad avflätning på varje bildruta i indatavideon.
Off	string	Inaktiverar avflätning av källvideon.

DeinterlaceParity

Fältparitet för avflätning, standardvärdet Auto.

Name	Typ	Description
Auto	string	Identifiera fältordningen automatiskt
BottomFieldFirst	string	Använd det nedre fältet första bearbetningen av indatavideon.
TopFieldFirst	string	Använd första bearbetningen av indatavideo i det översta fältet.

EncoderNamedPreset

Den inbyggda förinställningen som ska användas för kodning av videor.

Name	Typ	Description
AACGoodQualityAudio	string	Producerar en enda MP4-fil som endast innehåller AAC-stereoljud som är kodat på 192 kbit/s.
AdaptiveStreaming	string	Producerar en uppsättning GOP-justerade MP4-filer med H.264-video och stereo-AAC-ljud. Genererar automatiskt en stege för bithastighet baserat på indataupplösning, bithastighet och bildfrekvens. Den automatiskt genererade förinställningen överskrider aldrig indataupplösningen. Om indata till exempel är 720p förblir utdata i bästa fall 720p.
ContentAwareEncoding	string	Skapar en uppsättning GOP-justerade MP4:ar med hjälp av innehållsmedveten kodning. Med tanke på allt indatainnehåll utför tjänsten en inledande enkel analys av indatainnehållet och använder resultaten för att fastställa det optimala antalet lager, lämpliga bithastighets- och upplösningsinställningar för leverans via anpassningsbar direktuppspelning. Den här förinställningen är särskilt effektiv för videor med låg och medelhög komplexitet, där utdatafilerna kommer att ha lägre bithastigheter men med en kvalitet som fortfarande ger tittarna en bra upplevelse. Utdata innehåller MP4-filer med video och ljud interfolierat.
ContentAwareEncodingExperimental	string	Exponerar en experimentell förinställning för innehållsmedveten kodning. Med tanke på allt indatainnehåll försöker tjänsten automatiskt fastställa det optimala antalet lager, lämpliga inställningar för bithastighet och upplösning för leverans via anpassningsbar direktuppspelning. De underliggande algoritmerna fortsätter att utvecklas med tiden. Utdata innehåller MP4-filer med video och ljud interfolierat.
CopyAllBitrateNonInterleaved	string	Kopiera alla video- och ljudströmmar från indatatillgången som icke-interfolierade video- och ljudutdatafiler. Den här förinställningen kan användas för att klippa ut en befintlig tillgång eller konvertera en grupp med nyckelramar (GOP) justerade MP4-filer som en tillgång som kan strömmas.
DDGoodQualityAudio	string	Producerar en enda MP4-fil som endast innehåller DD(Digital Dolby) stereoljud som kodas till 192 kbit/s.
H264MultipleBitrate1080p	string	Producerar en uppsättning med 8 GOP-justerade MP4-filer, från 6 000 kbit/s till 400 kbit/s och stereo-AAC-ljud. Upplösningen börjar på 1080p och går ner till 180p.
H264MultipleBitrate720p	string	Producerar en uppsättning med 6 GOP-justerade MP4-filer, från 3 400 kbit/s till 400 kbit/s och stereo-AAC-ljud. Upplösningen börjar på 720p och går ner till 180p.
H264MultipleBitrateSD	string	Producerar en uppsättning med 5 GOP-justerade MP4-filer, från 1900 kbit/s till 400 kbit/s och stereo-AAC-ljud. Upplösningen börjar på 480p och går ner till 240p.
H264SingleBitrate1080p	string	Skapar en MP4-fil där videon är kodad med H.264 codec på 6750 kbit/s och en bildhöjd på 1 080 bildpunkter, och stereoljudet kodas med AAC-LC-codec på 128 kbit/s.
H264SingleBitrate720p	string	Skapar en MP4-fil där videon kodas med H.264 codec på 4 500 kbit/s och en bildhöjd på 720 bildpunkter, och stereoljudet kodas med AAC-LC-codec på 128 kbit/s.
H264SingleBitrateSD	string	Skapar en MP4-fil där videon kodas med H.264 codec på 2200 kbit/s och en bildhöjd på 480 bildpunkter, och stereoljudet kodas med AAC-LC-codec på 128 kbit/s.
H265AdaptiveStreaming	string	Producerar en uppsättning GOP-justerade MP4-filer med H.265-video och stereo-AAC-ljud. Genererar automatiskt en stege för bithastighet baserat på indataupplösning, bithastighet och bildfrekvens. Den automatiskt genererade förinställningen överskrider aldrig indataupplösningen. Om indata till exempel är 720p förblir utdata i bästa fall 720p.
H265ContentAwareEncoding	string	Skapar en uppsättning GOP-justerade MP4:ar med hjälp av innehållsmedveten kodning. Med tanke på allt indatainnehåll utför tjänsten en inledande enkel analys av indatainnehållet och använder resultaten för att fastställa det optimala antalet lager, lämpliga bithastighets- och upplösningsinställningar för leverans via anpassningsbar direktuppspelning. Den här förinställningen är särskilt effektiv för videor med låg och medelhög komplexitet, där utdatafilerna kommer att ha lägre bithastigheter men med en kvalitet som fortfarande ger tittarna en bra upplevelse. Utdata innehåller MP4-filer med video och ljud interfolierat.
H265SingleBitrate1080p	string	Skapar en MP4-fil där videon kodas med H.265 codec på 3 500 kbit/s och en bildhöjd på 1 080 bildpunkter, och stereoljudet kodas med AAC-LC-codec på 128 kbit/s.
H265SingleBitrate4K	string	Skapar en MP4-fil där videon är kodad med H.265 codec på 9 500 kbit/s och en bildhöjd på 2 160 bildpunkter, och stereoljudet kodas med AAC-LC-codec på 128 kbit/s.
H265SingleBitrate720p	string	Skapar en MP4-fil där videon kodas med H.265 codec på 1 800 kbit/s och en bildhöjd på 720 bildpunkter, och stereoljudet kodas med AAC-LC-codec på 128 kbit/s.

EntropyMode

Entropy-läget som ska användas för det här lagret. Om det inte anges väljer kodaren det läge som är lämpligt för profilen och nivån.

Name	Typ	Description
Cabac	string	Cabac-kodning (Context Adaptive Binary Arithmetic Coder).
Cavlc	string	CAVLC-kodning (Context Adaptive Variable Length Coder).

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

FaceDetectorPreset

Beskriver alla inställningar som ska användas när du analyserar en video för att identifiera (och eventuellt redigera) alla ansikten som finns.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.FaceDetectorPreset	Diskriminator för härledda typer.
blurType	BlurType	Typ av oskärpa
experimentalOptions	object	Ordlista som innehåller nyckel/värde-par för parametrar som inte exponeras i själva förinställningen
mode	FaceRedactorMode	Det här läget ger möjlighet att välja mellan följande inställningar: 1) Analysera – endast för identifiering. Det här läget genererar en JSON-metadatafil som markerar ansiktens utseenden i hela videon. Om möjligt tilldelas samma persons utseende samma ID. 2) Kombinerat – Dessutom redigerar (suddar) identifierade ansikten. 3) Redact – Detta möjliggör en 2-pass process, vilket möjliggör selektiv redigering av en delmängd av identifierade ansikten. Den tar in metadatafilen från ett tidigare analyspass, tillsammans med källvideon, och en användarvald delmängd av ID:t som kräver redigering.
resolution	AnalysisResolution	Anger den maximala upplösning som videon analyseras med. Standardbeteendet är "SourceResolution", som håller indatavideon på sin ursprungliga upplösning när den analyseras. Om du använder "StandardDefinition" ändras storleken på indatavideor till standarddefinitionen samtidigt som lämpligt proportioner bevaras. Den ändrar bara storlek om videon har högre upplösning. Till exempel skulle en indata på 1920 x 1080 skalas till 640x360 före bearbetning. Om du växlar till "StandardDefinition" minskar du den tid det tar att bearbeta video med hög upplösning. Det kan också minska kostnaden för att använda den här komponenten (se https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics mer information). Men ansikten som blir för små i videon med storleksändras kanske inte identifieras.

FaceRedactorMode

Det här läget ger möjlighet att välja mellan följande inställningar: 1) Analysera – Endast för identifiering. Det här läget genererar en metadata-JSON-fil som markerar ansiktens utseende i hela videon. När det är möjligt tilldelas utseenden av samma person samma ID. 2) Kombinerat – Dessutom redigerar (suddar) identifierade ansikten. 3) Redact – Detta möjliggör en 2-pass-process, vilket möjliggör selektiv redigering av en delmängd av identifierade ansikten. Den tar in metadatafilen från ett tidigare analyspass, tillsammans med källvideon, och en användarvald delmängd av ID:t som kräver redigering.

Name	Typ	Description
Analyze	string	Analysera läge identifierar ansikten och matar ut en metadatafil med resultatet. Tillåter redigering av metadatafilen innan ansikten är suddiga med Redact-läge.
Combined	string	Kombinerat läge utför stegen Analysera och Redigera i ett enda pass när du redigerar de analyserade ansiktena inte önskas.
Redact	string	Redact-läget använder metadatafilen från analysera-läget och redigerar de ansikten som hittas.

Fade

Beskriver egenskaperna för en Toningseffekt som tillämpas på indatamediet.

Name	Typ	Description
duration	string	Toningseffektens varaktighet i videon. Värdet kan vara i ISO 8601-format (t.ex. PT05S för att tona in/ut en färg under 5 sekunder) eller ett antal bildrutor (till exempel 10 för att tona 10 bildrutor från starttiden) eller ett relativt värde till strömmens varaktighet (till exempel 10 % för att tona ut 10 % av strömmens varaktighet)
fadeColor	string	Färg för tona in/ut. Det kan finnas på CSS Level1-färger https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords eller ett RGB/hex-värde: t.ex. rgb(255,0,0), 0xFF0000 eller #FF0000
start	string	Positionen i indatavideon varifrån du ska börja tona. Värdet kan vara i ISO 8601-format (t.ex. PT05S för att starta vid 5 sekunder) eller ett antal ramar (till exempel 10 för att starta vid den tionde bildrutan) eller ett relativt värde för dataströmmens varaktighet (till exempel 10 % för att starta vid 10 % av dataströmmens varaktighet). Standardvärdet är 0

Filters

Beskriver alla filtreringsåtgärder, till exempel avflätning, rotation osv. som ska tillämpas på indatamediet före kodning.

Name	Typ	Description
crop	Rectangle	Parametrarna för det rektangulära fönstret som indatavideon ska beskäras med.
deinterlace	Deinterlace	Inställningarna för avflätning.
fadeIn	Fade	Beskriver egenskaperna för en Toningseffekt som tillämpas på indatamediet.
fadeOut	Fade	Beskriver egenskaperna för en Toningseffekt som tillämpas på indatamediet.
overlays	Overlay[]: AudioOverlay[] VideoOverlay[]	Egenskaperna för överlägg som ska tillämpas på indatavideon. Det kan vara ljud-, bild- eller videoöverlägg.
rotation	Rotation	Rotationen, om den finns, som ska tillämpas på indatavideon innan den kodas. Standardvärdet är Auto

H264Complexity

Talar om för kodaren hur kodningsinställningarna ska väljas. Standardvärdet är Balanserad.

Name	Typ	Description
Balanced	string	Instruerar kodaren att använda inställningar som uppnår en balans mellan hastighet och kvalitet.
Quality	string	Instruerar kodaren att använda inställningar som är optimerade för att generera utdata av högre kvalitet på bekostnad av långsammare övergripande kodningstid.
Speed	string	Instruerar kodaren att använda inställningar som är optimerade för snabbare kodning. Kvaliteten offras för att minska kodningstiden.

H264Layer

Beskriver de inställningar som ska användas när du kodar indatavideon i ett önskat lager med bithastighet för utdata med H.264-videokodningen.

Name	Typ	Description
adaptiveBFrame	boolean	Oavsett om anpassningsbara B-ramar ska användas vid kodning av det här lagret eller inte. Om det inte anges aktiverar kodaren den när videoprofilen tillåter att den används.
bFrames	integer	Antalet B-ramar som ska användas vid kodning av det här lagret. Om det inte anges väljer kodaren ett lämpligt nummer baserat på videoprofilen och -nivån.
bitrate	integer	Den genomsnittliga bithastigheten i bitar per sekund som indatavideon ska kodas vid generering av det här lagret. Det här är ett obligatoriskt fält.
bufferWindow	string	Längden på VBV-buffertfönstret. Värdet ska vara i ISO 8601-format. Värdet ska ligga i intervallet [0,1–100] sekunder. Standardvärdet är 5 sekunder (till exempel PT5S).
crf	number	Värdet för CRF som ska användas vid kodning av det här lagret. Den här inställningen börjar gälla när RateControlMode för video codec har angetts i CRF-läge. Intervallet för CRF-värdet är mellan 0 och 51, där lägre värden skulle resultera i bättre kvalitet, på bekostnad av högre filstorlekar. Högre värden innebär mer komprimering, men någon gång kommer kvalitetsförsämring att märkas. Standardvärdet är 23.
entropyMode	EntropyMode	Entropy-läget som ska användas för det här lagret. Om detta inte anges väljer kodaren det läge som är lämpligt för profilen och nivån.
frameRate	string	Bildfrekvensen (i bildrutor per sekund) som det här lagret ska kodas med. Värdet kan vara i form av M/N där M och N är heltal (till exempel 30000/1001) eller i form av ett tal (till exempel 30 eller 29,97). Kodaren tillämpar begränsningar för tillåtna bildfrekvenser baserat på profil och nivå. Om den inte anges använder kodaren samma bildfrekvens som indatavideon.
height	string	Höjden på utdatavideon för det här lagret. Värdet kan vara absolut (i bildpunkter) eller relativt (i procent). Till exempel innebär 50 % att utdatavideon har hälften så många bildpunkter i höjd som indata.
label	string	Den alfanumeriska etiketten för det här lagret, som kan användas i multiplexering av olika video- och ljudlager, eller vid namngivning av utdatafilen.
level	string	Vi stöder för närvarande nivå upp till 6.2. Värdet kan vara Auto eller ett tal som matchar H.264-profilen. Om det inte anges är standardvärdet Auto, vilket gör att kodaren kan välja den nivå som är lämplig för det här lagret.
maxBitrate	integer	Den maximala bithastigheten (i bitar per sekund) där VBV-bufferten ska antas fyllas på. Om det inte anges får du som standard samma värde som bithastighet.
profile	H264VideoProfile	Vi stöder för närvarande Baseline, Main, High, High422, High444. Standardvärdet är Automatiskt.
referenceFrames	integer	Antalet referensramar som ska användas vid kodning av det här lagret. Om detta inte anges bestämmer kodaren ett lämpligt nummer baserat på kodarens komplexitetsinställning.
slices	integer	Antalet sektorer som ska användas vid kodning av det här lagret. Om det inte anges är standardvärdet noll, vilket innebär att kodaren använder en enda sektor för varje bildruta.
width	string	Bredden på utdatavideon för det här lagret. Värdet kan vara absolut (i bildpunkter) eller relativt (i procent). Till exempel innebär 50 % att utdatavideon har hälften så många bildpunkter i bredd som indata.

H264RateControlMode

Videohastighetskontrollläget

Name	Typ	Description
ABR	string	ABR-läge (Average Bitrate) som når målbithastigheten: Standardläge.
CBR	string	CBR-läge (Constant Bitrate) som drar åt bithastighetsvariationerna runt målbithastigheten.
CRF	string	CRF-läge (Constant Rate Factor) som är avsett för konstant subjektiv kvalitet.

H264Video

Beskriver alla egenskaper för att koda en video med H.264 codec.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.H264Video	Diskriminator för härledda typer.
complexity	H264Complexity	Talar om för kodaren hur kodningsinställningarna ska väljas. Standardvärdet är Balanserad.
keyFrameInterval	string	Avståndet mellan två nyckelrutor. Värdet ska vara icke-noll i intervallet [0,5, 20] sekunder, som anges i ISO 8601-format. Standardvärdet är 2 sekunder (PT2S). Observera att den här inställningen ignoreras om VideoSyncMode.Passthrough har angetts, där KeyFrameInterval-värdet följer inställningen för indatakällan.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.
layers	H264Layer[]	Samlingen av H.264-utdataskikt som ska produceras av kodaren.
rateControlMode	H264RateControlMode	Videohastighetskontrollläget
sceneChangeDetection	boolean	Om kodaren ska infoga nyckelrutor vid scenändringar eller inte. Om inget anges är standardvärdet falskt. Den här flaggan ska bara anges till true när kodaren konfigureras för att skapa en enda utdatavideo.
stretchMode	StretchMode	Storleksändringsläget – hur indatavideon ändras så att den passar önskade utdataupplösning(ar). Standardvärdet är AutoSize
syncMode	VideoSyncMode	Videosynkroniseringsläge

H264VideoProfile

Vi stöder för närvarande Baseline, Main, High, High422, High444. Standardvärdet är Auto.

Name	Typ	Description
Auto	string	Instruerar kodaren att automatiskt fastställa lämplig H.264-profil.
Baseline	string	Baslinjeprofil
High	string	Hög profil.
High422	string	Hög profil 4:2:2.
High444	string	Hög förutsägelseprofil på 4:4:4.
Main	string	Huvudprofil

H265Complexity

Talar om för kodaren hur kodningsinställningarna ska väljas. Kvalitet ger ett högre komprimeringsförhållande men till en högre kostnad och längre beräkningstid. Hastighet kommer att producera en relativt större fil men är snabbare och mer ekonomisk. Standardvärdet är Balanserad.

Name	Typ	Description
Balanced	string	Instruerar kodaren att använda inställningar som uppnår en balans mellan hastighet och kvalitet.
Quality	string	Instruerar kodaren att använda inställningar som är optimerade för att producera utdata av högre kvalitet på bekostnad av långsammare övergripande kodningstid.
Speed	string	Instruerar kodaren att använda inställningar som är optimerade för snabbare kodning. Kvalitet offras för att minska kodningstiden.

H265Layer

Beskriver de inställningar som ska användas när indatavideon kodas till ett önskat bithastighetslager för utdata med videokodcen H.265.

Name	Typ	Description
adaptiveBFrame	boolean	Anger om anpassningsbara B-ramar ska användas vid kodning av det här lagret. Om det inte anges aktiverar kodaren den när videoprofilen tillåter att den används.
bFrames	integer	Antalet B-ramar som ska användas vid kodning av det här lagret. Om det inte anges väljer kodaren ett lämpligt nummer baserat på videoprofilen och -nivån.
bitrate	integer	Den genomsnittliga bithastigheten i bitar per sekund som indatavideon ska kodas vid generering av det här lagret. Till exempel: en målbithastighet på 3 000 kbit/s eller 3 Mbit/s innebär att det här värdet ska vara 3000000 Det här är ett obligatoriskt fält.
bufferWindow	string	Längden på VBV-buffertfönstret. Värdet ska vara i ISO 8601-format. Värdet ska ligga i intervallet [0,1–100] sekunder. Standardvärdet är 5 sekunder (till exempel PT5S).
crf	number	Värdet för CRF som ska användas vid kodning av det här lagret. Den här inställningen börjar gälla när RateControlMode för video codec har angetts i CRF-läge. Intervallet för CRF-värdet är mellan 0 och 51, där lägre värden skulle resultera i bättre kvalitet, på bekostnad av högre filstorlekar. Högre värden innebär mer komprimering, men någon gång kommer kvalitetsförsämring att märkas. Standardvärdet är 28.
frameRate	string	Bildfrekvensen (i bildrutor per sekund) som det här lagret ska kodas med. Värdet kan vara i form av M/N där M och N är heltal (till exempel 30000/1001) eller i form av ett tal (till exempel 30 eller 29,97). Kodaren tillämpar begränsningar för tillåtna bildfrekvenser baserat på profil och nivå. Om den inte anges använder kodaren samma bildfrekvens som indatavideon.
height	string	Höjden på utdatavideon för det här lagret. Värdet kan vara absolut (i bildpunkter) eller relativt (i procent). Till exempel innebär 50 % att utdatavideon har hälften så många bildpunkter i höjd som indata.
label	string	Den alfanumeriska etiketten för det här lagret, som kan användas i multiplexering av olika video- och ljudlager, eller vid namngivning av utdatafilen.
level	string	Vi stöder för närvarande nivå upp till 6.2. Värdet kan vara Auto eller ett tal som matchar H.265-profilen. Om det inte anges är standardvärdet Auto, vilket gör att kodaren kan välja den nivå som är lämplig för det här lagret.
maxBitrate	integer	Den maximala bithastigheten (i bitar per sekund) där VBV-bufferten ska antas fyllas på. Om det inte anges får du som standard samma värde som bithastighet.
profile	H265VideoProfile	Vi har för närvarande stöd för Main. Standardvärdet är Automatiskt.
referenceFrames	integer	Antalet referensramar som ska användas vid kodning av det här lagret. Om detta inte anges bestämmer kodaren ett lämpligt nummer baserat på kodarens komplexitetsinställning.
slices	integer	Antalet sektorer som ska användas vid kodning av det här lagret. Om det inte anges är standardvärdet noll, vilket innebär att kodaren använder en enda sektor för varje bildruta.
width	string	Bredden på utdatavideon för det här lagret. Värdet kan vara absolut (i bildpunkter) eller relativt (i procent). Till exempel innebär 50 % att utdatavideon har hälften så många bildpunkter i bredd som indata.

H265Video

Beskriver alla egenskaper för att koda en video med H.265 codec.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.H265Video	Diskrimineringen för härledda typer.
complexity	H265Complexity	Talar om för kodaren hur kodningsinställningarna ska väljas. Kvalitet ger ett högre komprimeringsförhållande men till en högre kostnad och längre beräkningstid. Hastighet kommer att producera en relativt större fil men är snabbare och mer ekonomisk. Standardvärdet är Balanserad.
keyFrameInterval	string	Avståndet mellan två nyckelramar. Värdet ska vara icke-noll i intervallet [0,5, 20] sekunder, som anges i ISO 8601-format. Standardvärdet är 2 sekunder (PT2S). Observera att den här inställningen ignoreras om VideoSyncMode.Passthrough har angetts, där KeyFrameInterval-värdet följer inställningen för indatakällan.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.
layers	H265Layer[]	Samlingen av H.265-utdataskikt som ska skapas av kodaren.
sceneChangeDetection	boolean	Anger om kodaren ska infoga nyckelramar i scenändringar eller inte. Om inget anges är standardvärdet falskt. Den här flaggan ska bara anges till true när kodaren konfigureras för att skapa en enda utdatavideo.
stretchMode	StretchMode	Storleksändringsläget – hur indatavideon ändras så att den passar önskad utdataupplösning. Standardinställningen är AutoSize
syncMode	VideoSyncMode	Läget för videosynkronisering

H265VideoProfile

Vi stöder för närvarande Main. Standardvärdet är Auto.

Name	Typ	Description
Auto	string	Instruerar kodaren att automatiskt fastställa lämplig H.265-profil.
Main	string	Huvudprofil (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier)
Main10	string	Huvudprofil 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10)

Image

Beskriver de grundläggande egenskaperna för att generera miniatyrer från indatavideon

Name	Typ	Description
@odata.type	string: #Microsoft.Media.Image	Diskriminator för härledda typer.
keyFrameInterval	string	Avståndet mellan två nyckelrutor. Värdet ska vara icke-noll i intervallet [0,5, 20] sekunder, som anges i ISO 8601-format. Standardvärdet är 2 sekunder (PT2S). Observera att den här inställningen ignoreras om VideoSyncMode.Passthrough har angetts, där KeyFrameInterval-värdet följer inställningen för indatakällan.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.
range	string	Positionen i förhållande till transformering av förinställd starttid i indatavideon där miniatyrbilder ska sluta genereras. Värdet kan vara i ISO 8601-format (till exempel PT5M30S att stoppa vid 5 minuter och 30 sekunder från starttiden) eller ett antal bildfält (till exempel 300 för att stanna vid den 300:e bildrutan från ramen vid starttid. Om det här värdet är 1 innebär det att bara skapa en miniatyrbild vid starttiden) eller ett relativt värde för strömmens varaktighet (till exempel 50 % för att stoppa vid hälften av strömmens varaktighet från starttiden). Standardvärdet är 100 %, vilket innebär att du stoppar i slutet av dataströmmen.
start	string	Positionen i indatavideon där du kan börja generera miniatyrer. Värdet kan vara i ISO 8601-format (till exempel PT05S för att starta vid 5 sekunder) eller ett antal bildfält (till exempel 10 för att starta vid den tionde bildrutan) eller ett relativt värde till strömmens varaktighet (till exempel 10 % för att starta vid 10 % av strömmens varaktighet). Stöder också ett makro {Best}, som instruerar kodaren att välja den bästa miniatyrbilden från de första sekunderna i videon och endast skapar en miniatyrbild, oavsett vilka andra inställningar som gäller för Steg och Intervall. Standardvärdet är makrot {Best}.
step	string	De intervall med vilka miniatyrbilder genereras. Värdet kan vara i ISO 8601-format (till exempel PT05S för en bild var 5:e sekund) eller ett antal bildrutor (till exempel 30 för en bild var 30:e bildruta) eller ett relativt värde för strömmens varaktighet (till exempel 10 % för en bild var 10 %av strömmens varaktighet). Obs! Stegvärdet påverkar den första genererade miniatyrbilden, som kanske inte är exakt den som anges vid transformeringsförinställningens starttid. Detta beror på kodaren, som försöker välja den bästa miniatyrbilden mellan starttiden och stegpositionen från starttiden som första utdata. Eftersom standardvärdet är 10 % innebär det att om strömmen har lång varaktighet kan den första genererade miniatyrbilden vara långt ifrån den som angavs vid starttiden. Försök att välja ett rimligt värde för Steg om den första miniatyrbilden förväntas vara nära starttiden eller ange Intervallvärde till 1 om endast en miniatyrbild behövs vid starttiden.
stretchMode	StretchMode	Storleksändringsläget – hur indatavideon ändras så att den passar önskade utdataupplösning(ar). Standardvärdet är AutoSize
syncMode	VideoSyncMode	Videosynkroniseringsläge

ImageFormat

Beskriver egenskaperna för en utdatabildfil.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.ImageFormat	Diskriminator för härledda typer.
filenamePattern	string	Namngivningsmönstret för filer som används för att skapa utdatafiler. Följande makron stöds i filnamnet: {Basename} – ett expansionsmakro som använder namnet på videofilen för indata. Om basnamnet (filsuffixet ingår inte) för den inmatade videofilen är mindre än 32 tecken långt används basnamnet för indatavideofilerna. Om längden på basnamnet för videofilen för indata överskrider 32 tecken trunkeras basnamnet till de första 32 tecknen i total längd. {Extension} – lämpligt tillägg för det här formatet. {Label} – etiketten som tilldelats till codec/layer. {Index} – ett unikt index för miniatyrbilder. Gäller endast för miniatyrer. {AudioStream} – strängen "Audio" plus ljudströmsnummer (starta från 1). {Bitrate} – bithastigheten för ljud/video i kbps. Inte tillämpligt för miniatyrer. {Codec} – typen av ljud/video codec. {Resolution} – videoupplösningen. Alla outbildade makron döljs och tas bort från filnamnet.

InsightsType

Definierar den typ av insikter som du vill att tjänsten ska generera. De tillåtna värdena är "AudioInsightsOnly", "VideoInsightsOnly" och "AllInsights". Standardvärdet är AllInsights. Om du ställer in detta på AllInsights och indata endast är ljud genereras endast ljudinsikter. På samma sätt genereras endast videoinsikter om indata endast är videoindata. Vi rekommenderar att du inte använder AudioInsightsOnly om du förväntar dig att vissa av dina indata endast ska vara video. eller använd VideoInsightsOnly om du förväntar dig att vissa av dina indata endast ska vara ljud. Dina jobb under sådana förhållanden skulle felsökas.

Name	Typ	Description
AllInsights	string	Generera både ljud- och videoinsikter. Misslyckas om antingen ljud- eller videoinsikter misslyckas.
AudioInsightsOnly	string	Generera endast insikter om ljud. Ignorera video även om det finns. Misslyckas om det inte finns något ljud.
VideoInsightsOnly	string	Generera endast videoinsikter. Ignorera ljud om det finns. Misslyckas om det inte finns någon video.

InterleaveOutput

Anger intersparläge för utdata för att styra hur ljud och video lagras i containerformatet. Exempel: Ange InterleavedOutput som NonInterleavedOutput för att producera ljudbaserade och endast videoutdata i separata MP4-filer.

Name	Typ	Description
InterleavedOutput	string	Utdata innehåller både ljud och video.
NonInterleavedOutput	string	Utdata är endast video eller endast ljud.

JpgFormat

Beskriver inställningarna för att skapa JPEG-miniatyrer.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.JpgFormat	Diskriminator för härledda typer.
filenamePattern	string	Namngivningsmönstret för filer som används för att skapa utdatafiler. Följande makron stöds i filnamnet: {Basename} – ett expansionsmakro som använder namnet på videofilen för indata. Om basnamnet (filsuffixet ingår inte) för den inmatade videofilen är mindre än 32 tecken långt används basnamnet för indatavideofilerna. Om längden på basnamnet för videofilen för indata överskrider 32 tecken trunkeras basnamnet till de första 32 tecknen i total längd. {Extension} – lämpligt tillägg för det här formatet. {Label} – etiketten som tilldelats till codec/layer. {Index} – ett unikt index för miniatyrbilder. Gäller endast för miniatyrer. {AudioStream} – strängen "Audio" plus ljudströmsnummer (starta från 1). {Bitrate} – bithastigheten för ljud/video i kbps. Inte tillämpligt för miniatyrer. {Codec} – typen av ljud/video codec. {Resolution} – videoupplösningen. Alla outbildade makron döljs och tas bort från filnamnet.

JpgImage

Beskriver egenskaperna för att skapa en serie JPEG-bilder från indatavideon.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.JpgImage	Diskriminator för härledda typer.
keyFrameInterval	string	Avståndet mellan två nyckelrutor. Värdet ska vara icke-noll i intervallet [0,5, 20] sekunder, som anges i ISO 8601-format. Standardvärdet är 2 sekunder (PT2S). Observera att den här inställningen ignoreras om VideoSyncMode.Passthrough har angetts, där KeyFrameInterval-värdet följer inställningen för indatakällan.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.
layers	JpgLayer[]	En samling JPEG-bildlager som ska skapas av kodaren.
range	string	Positionen i förhållande till transformering av förinställd starttid i indatavideon där miniatyrbilder ska sluta genereras. Värdet kan vara i ISO 8601-format (till exempel PT5M30S att stoppa vid 5 minuter och 30 sekunder från starttiden) eller ett antal bildfält (till exempel 300 för att stanna vid den 300:e bildrutan från ramen vid starttid. Om det här värdet är 1 innebär det att bara skapa en miniatyrbild vid starttiden) eller ett relativt värde för strömmens varaktighet (till exempel 50 % för att stoppa vid hälften av strömmens varaktighet från starttiden). Standardvärdet är 100 %, vilket innebär att du stoppar i slutet av dataströmmen.
spriteColumn	integer	Anger antalet kolumner som används i miniatyrspritbilden. Antalet rader beräknas automatiskt och en VTT-fil genereras med koordinatmappningarna för varje miniatyrbild i spriten. Obs! Det här värdet bör vara ett positivt heltal och ett korrekt värde rekommenderas så att bildupplösningen för utdata inte överskrider JPEG-gränsen för maximal pixelupplösning 65535x65535.
start	string	Positionen i indatavideon där du kan börja generera miniatyrbilder. Värdet kan vara i ISO 8601-format (till exempel PT05S för att starta vid 5 sekunder) eller ett antal bildfält (till exempel 10 för att starta vid den tionde bildrutan) eller ett relativt värde till strömmens varaktighet (till exempel 10 % för att starta vid 10 % av strömmens varaktighet). Stöder också ett makro {Best}, som instruerar kodaren att välja den bästa miniatyrbilden från de första sekunderna i videon och endast skapar en miniatyrbild, oavsett vilka andra inställningar som gäller för Steg och Intervall. Standardvärdet är makrot {Best}.
step	string	De intervall med vilka miniatyrbilder genereras. Värdet kan vara i ISO 8601-format (till exempel PT05S för en bild var 5:e sekund) eller ett antal bildrutor (till exempel 30 för en bild var 30:e bildruta) eller ett relativt värde för strömmens varaktighet (till exempel 10 % för en bild var 10 %av strömmens varaktighet). Obs! Stegvärdet påverkar den första genererade miniatyrbilden, som kanske inte är exakt den som anges vid transformeringsförinställningens starttid. Detta beror på kodaren, som försöker välja den bästa miniatyrbilden mellan starttiden och stegpositionen från starttiden som första utdata. Eftersom standardvärdet är 10 % innebär det att om strömmen har lång varaktighet kan den första genererade miniatyrbilden vara långt ifrån den som angavs vid starttiden. Försök att välja ett rimligt värde för Steg om den första miniatyrbilden förväntas vara nära starttiden eller ange Intervallvärde till 1 om endast en miniatyrbild behövs vid starttiden.
stretchMode	StretchMode	Storleksändringsläget – hur indatavideon ändras så att den passar önskade utdataupplösning(ar). Standardvärdet är AutoSize
syncMode	VideoSyncMode	Videosynkroniseringsläge

JpgLayer

Beskriver inställningarna för att skapa en JPEG-bild från indatavideon.

Name	Typ	Description
height	string	Höjden på utdatavideon för det här lagret. Värdet kan vara absolut (i bildpunkter) eller relativt (i procent). Till exempel innebär 50 % att utdatavideon har hälften så många bildpunkter i höjd som indata.
label	string	Den alfanumeriska etiketten för det här lagret, som kan användas i multiplexering av olika video- och ljudlager, eller vid namngivning av utdatafilen.
quality	integer	Komprimeringskvaliteten för JPEG-utdata. Intervallet är mellan 0 och 100 och standardvärdet är 70.
width	string	Bredden på utdatavideon för det här lagret. Värdet kan vara absolut (i bildpunkter) eller relativt (i procent). Till exempel innebär 50 % att utdatavideon har hälften så många bildpunkter i bredd som indata.

Mp4Format

Beskriver egenskaperna för en ISO MP4-utdatafil.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.Mp4Format	Diskriminator för härledda typer.
filenamePattern	string	Namngivningsmönstret för filer som används för att skapa utdatafiler. Följande makron stöds i filnamnet: {Basename} – ett expansionsmakro som använder namnet på videofilen för indata. Om basnamnet (filsuffixet ingår inte) för den inmatade videofilen är mindre än 32 tecken långt används basnamnet för indatavideofilerna. Om längden på basnamnet för videofilen för indata överskrider 32 tecken trunkeras basnamnet till de första 32 tecknen i total längd. {Extension} – lämpligt tillägg för det här formatet. {Label} – etiketten som tilldelats till codec/layer. {Index} – ett unikt index för miniatyrbilder. Gäller endast för miniatyrer. {AudioStream} – strängen "Audio" plus ljudströmsnummer (starta från 1). {Bitrate} – bithastigheten för ljud/video i kbps. Inte tillämpligt för miniatyrer. {Codec} – typen av ljud/video codec. {Resolution} – videoupplösningen. Alla outbildade makron döljs och tas bort från filnamnet.
outputFiles	OutputFile[]	Listan över utdatafiler som ska skapas. Varje post i listan är en uppsättning etiketter för ljud- och videolager som ska kopplas ihop .

MultiBitrateFormat

Beskriver egenskaperna för att skapa en samling GOP-justerade filer med flera bithastigheter. Standardbeteendet är att skapa en utdatafil för varje videoskikt som är muxed tillsammans med alla ljud. De exakta utdatafiler som skapas kan styras genom att ange outputFiles-samlingen.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.MultiBitrateFormat	Diskriminator för härledda typer.
filenamePattern	string	Namngivningsmönstret för filer som används för att skapa utdatafiler. Följande makron stöds i filnamnet: {Basename} – ett expansionsmakro som använder namnet på videofilen för indata. Om basnamnet (filsuffixet ingår inte) för den inmatade videofilen är mindre än 32 tecken långt används basnamnet för indatavideofilerna. Om längden på basnamnet för videofilen för indata överskrider 32 tecken trunkeras basnamnet till de första 32 tecknen i total längd. {Extension} – lämpligt tillägg för det här formatet. {Label} – etiketten som tilldelats till codec/layer. {Index} – ett unikt index för miniatyrbilder. Gäller endast för miniatyrer. {AudioStream} – strängen "Audio" plus ljudströmsnummer (starta från 1). {Bitrate} – bithastigheten för ljud/video i kbps. Inte tillämpligt för miniatyrer. {Codec} – typen av ljud/video codec. {Resolution} – videoupplösningen. Alla outbildade makron döljs och tas bort från filnamnet.
outputFiles	OutputFile[]	Listan över utdatafiler som ska skapas. Varje post i listan är en uppsättning etiketter för ljud- och videolager som ska kopplas ihop .

OnErrorType

En transformering kan definiera fler än en utdata. Den här egenskapen definierar vad tjänsten ska göra när en utdata misslyckas – antingen fortsätter du att skapa andra utdata eller stoppar de andra utdata. Det övergripande jobbtillståndet återspeglar inte fel i utdata som har angetts med "ContinueJob". Standardvärdet är "StopProcessingJob".

Name	Typ	Description
ContinueJob	string	Meddelar tjänsten att om detta TransformOutput misslyckas tillåter du att andra TransformOutput fortsätter.
StopProcessingJob	string	Meddelar tjänsten att om detta TransformOutput misslyckas kan alla andra ofullständiga TransformOutputs stoppas.

OutputFile

Representerar en utdatafil som skapats.

Name	Typ	Description
labels	string[]	Listan med etiketter som beskriver hur kodaren ska multiplexera video och ljud till en utdatafil. Om kodaren till exempel producerar två videoskikt med etiketterna v1 och v2 och ett ljudlager med etiketten a1, instruerar en matris som "[v1, a1]" kodaren att producera en utdatafil med videospåret som representeras av v1 och ljudspåret som representeras av a1.

PngFormat

Beskriver inställningarna för att skapa PNG-miniatyrer.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.PngFormat	Diskriminator för härledda typer.
filenamePattern	string	Namngivningsmönstret för filer som används för att skapa utdatafiler. Följande makron stöds i filnamnet: {Basename} – ett expansionsmakron som använder namnet på indatavideofilen. Om basnamnet (filsuffixet inte ingår) för indatavideofilen är mindre än 32 tecken långt används basnamnet för indatavideofiler. Om längden på basnamnet för indatavideofilen överskrider 32 tecken trunkeras basnamnet till de första 32 tecknen i total längd. {Extension} – lämpligt tillägg för det här formatet. {Label} – etiketten som tilldelats till codec/layer. {Index} – ett unikt index för miniatyrer. Gäller endast för miniatyrer. {AudioStream} – strängen "Audio" plus ljudströmsnummer (starta från 1). {Bitrate} – bithastigheten för ljud/video i kbps. Gäller inte för miniatyrer. {Codec} – typen av ljud/video codec. {Resolution} – videoupplösningen. Alla outbildade makron döljs och tas bort från filnamnet.

PngImage

Beskriver egenskaperna för att producera en serie PNG-bilder från indatavideon.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.PngImage	Diskriminator för härledda typer.
keyFrameInterval	string	Avståndet mellan två nyckelrutor. Värdet ska vara icke-noll i intervallet [0,5, 20] sekunder, som anges i ISO 8601-format. Standardvärdet är 2 sekunder (PT2S). Observera att den här inställningen ignoreras om VideoSyncMode.Passthrough har angetts, där KeyFrameInterval-värdet följer inställningen för indatakällan.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.
layers	PngLayer[]	En samling PNG-utdatabildskikt som ska skapas av kodaren.
range	string	Positionen i förhållande till transformering av förinställd starttid i indatavideon där miniatyrbilder ska sluta genereras. Värdet kan vara i ISO 8601-format (till exempel PT5M30S att stoppa vid 5 minuter och 30 sekunder från starttiden) eller ett antal bildfält (till exempel 300 för att stanna vid den 300:e bildrutan från ramen vid starttid. Om det här värdet är 1 innebär det att bara skapa en miniatyrbild vid starttiden) eller ett relativt värde för strömmens varaktighet (till exempel 50 % för att stoppa vid hälften av strömmens varaktighet från starttiden). Standardvärdet är 100 %, vilket innebär att du stoppar i slutet av dataströmmen.
start	string	Positionen i indatavideon där du kan börja generera miniatyrbilder. Värdet kan vara i ISO 8601-format (till exempel PT05S för att starta vid 5 sekunder) eller ett antal bildfält (till exempel 10 för att starta vid den tionde bildrutan) eller ett relativt värde till strömmens varaktighet (till exempel 10 % för att starta vid 10 % av strömmens varaktighet). Stöder också ett makro {Best}, som instruerar kodaren att välja den bästa miniatyrbilden från de första sekunderna i videon och endast skapar en miniatyrbild, oavsett vilka andra inställningar som gäller för Steg och Intervall. Standardvärdet är makrot {Best}.
step	string	De intervall med vilka miniatyrbilder genereras. Värdet kan vara i ISO 8601-format (till exempel PT05S för en bild var 5:e sekund) eller ett antal bildrutor (till exempel 30 för en bild var 30:e bildruta) eller ett relativt värde för strömmens varaktighet (till exempel 10 % för en bild var 10 %av strömmens varaktighet). Obs! Stegvärdet påverkar den första genererade miniatyrbilden, som kanske inte är exakt den som anges vid transformeringsförinställningens starttid. Detta beror på kodaren, som försöker välja den bästa miniatyrbilden mellan starttiden och stegpositionen från starttiden som första utdata. Eftersom standardvärdet är 10 % innebär det att om strömmen har lång varaktighet kan den första genererade miniatyrbilden vara långt ifrån den som angavs vid starttiden. Försök att välja ett rimligt värde för Steg om den första miniatyrbilden förväntas vara nära starttiden eller ange Intervallvärde till 1 om endast en miniatyrbild behövs vid starttiden.
stretchMode	StretchMode	Storleksändringsläget – hur indatavideon ändras så att den passar önskade utdataupplösning(ar). Standardvärdet är AutoSize
syncMode	VideoSyncMode	Videosynkroniseringsläge

PngLayer

Beskriver inställningarna för att skapa en PNG-bild från indatavideon.

Name	Typ	Description
height	string	Höjden på utdatavideon för det här lagret. Värdet kan vara absolut (i bildpunkter) eller relativt (i procent). Till exempel innebär 50 % att utdatavideon har hälften så många bildpunkter i höjd som indata.
label	string	Den alfanumeriska etiketten för det här lagret, som kan användas för att multiplexera olika video- och ljudlager, eller för att namnge utdatafilen.
width	string	Bredden på utdatavideon för det här lagret. Värdet kan vara absolut (i bildpunkter) eller relativt (i procent). Till exempel innebär 50 % att utdatavideon har hälften så många bildpunkter i bredd som indata.

PresetConfigurations

Ett objekt med valfria konfigurationsinställningar för kodaren.

Name	Typ	Description
complexity	Complexity	Gör att du kan konfigurera kodarinställningarna för att styra balansen mellan hastighet och kvalitet. Exempel: ange Komplexitet som Hastighet för snabbare kodning men mindre komprimeringseffektivitet.
interleaveOutput	InterleaveOutput	Anger intersparläge för utdata för att styra hur ljud och video lagras i containerformatet. Exempel: Ange InterleavedOutput som NonInterleavedOutput för att producera ljudbaserade och endast videoutdata i separata MP4-filer.
keyFrameIntervalInSeconds	number	Intervallet för nyckelramen i sekunder. Exempel: ange KeyFrameIntervalInSeconds som 2 för att minska uppspelningsbuffertningen för vissa spelare.
maxBitrateBps	integer	Maximal bithastighet i bitar per sekund (tröskelvärde för det översta videoskiktet). Exempel: ange MaxBitrateBps som 6000000 för att undvika att producera utdata med mycket hög bithastighet för innehåll med hög komplexitet.
maxHeight	integer	Den maximala höjden för utdatavideoskikt. Exempel: ange MaxHeight som 720 för att producera utdataskikt upp till 720P även om indata är 4K.
maxLayers	integer	Det maximala antalet utdatavideoskikt. Exempel: ange MaxLayers som 4 för att se till att högst 4 utdatalager skapas för att styra den totala kostnaden för kodningsjobbet.
minBitrateBps	integer	Minsta bithastighet i bitar per sekund (tröskelvärde för det nedre videoskiktet). Exempel: ange MinBitrateBps som 200000 för att ha ett bottenskikt som omfattar användare med låg nätverksbandbredd.
minHeight	integer	Minsta höjd för utdatavideoskikt. Exempel: ange MinHeight som 360 för att undvika utdataskikt med mindre upplösningar som 180P.

Priority

Anger den relativa prioriteten för TransformOutputs i en transformering. Detta anger den prioritet som tjänsten använder för bearbetning av TransformOutputs. Standardprioriteten är Normal.

Name	Typ	Description
High	string	Används för TransformOutputs som ska ha företräde framför andra.
Low	string	Används för TransformOutputs som kan genereras efter Normal och Hög prioritet TransformOutputs.
Normal	string	Används för TransformOutputs som kan genereras med normal prioritet.

Rectangle

Beskriver egenskaperna för ett rektangulärt fönster som tillämpas på indatamediet innan det bearbetas.

Name	Typ	Description
height	string	Höjden på den rektangulära regionen i bildpunkter. Detta kan vara absolut pixelvärde (t.ex. 100) eller i förhållande till videons storlek (till exempel 50 %).
left	string	Antalet bildpunkter från vänstermarginalen. Detta kan vara absolut pixelvärde (t.ex. 100) eller i förhållande till videons storlek (till exempel 50 %).
top	string	Antalet bildpunkter från den övre marginalen. Detta kan vara absolut pixelvärde (t.ex. 100) eller i förhållande till videons storlek (till exempel 50 %).
width	string	Bredden på den rektangulära regionen i bildpunkter. Detta kan vara absolut pixelvärde (t.ex. 100) eller i förhållande till videons storlek (till exempel 50 %).

Rotation

Rotationen, om den finns, som ska tillämpas på indatavideon innan den kodas. Standardvärdet är Auto

Name	Typ	Description
Auto	string	Identifiera och rotera automatiskt efter behov.
None	string	Rotera inte videon. Om utdataformatet stöder det behålls alla metadata om rotation intakta.
Rotate0	string	Rotera inte videon utan ta bort metadata om rotationen.
Rotate180	string	Rotera 180 grader medsols.
Rotate270	string	Rotera 270 grader medsols.
Rotate90	string	Rotera 90 grader medsols.

StandardEncoderPreset

Beskriver alla inställningar som ska användas vid kodning av indatavideon med standardkodaren.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.StandardEncoderPreset	Diskriminator för härledda typer.
codecs	Codec[]: AacAudio[] Audio[] CopyAudio[] CopyVideo[] DDAudio[] H264Video[] H265Video[] Image[] JpgImage[] PngImage[] Video[]	Listan över codecs som ska användas vid kodning av indatavideon.
experimentalOptions	object	Ordlista som innehåller nyckel/värde-par för parametrar som inte exponeras i själva förinställningen
filters	Filters	En eller flera filtreringsåtgärder som tillämpas på indatamediet före kodning.
formats	Format[]: ImageFormat[] JpgFormat[] Mp4Format[] MultiBitrateFormat[] PngFormat[] TransportStreamFormat[]	Listan över utdata som ska skapas av kodaren.

StretchMode

Storleksändringsläget – hur indatavideon ändras så att den passar önskad utdataupplösning. Standardinställningen är AutoSize

Name	Typ	Description
AutoFit	string	Fyll utdata (med antingen letterbox eller pelarruta) för att uppfylla utdataupplösningen, samtidigt som du ser till att den aktiva videoregionen i utdata har samma proportioner som indata. Om indata till exempel är 1920x1080 och kodningsförinställningen frågar efter 1280x1280, kommer utdata att vara på 1280x1280, som innehåller en inre rektangel på 1280x720 i breddförhållandet 16:9, och pelarfältsregioner 280 bildpunkter bred till vänster och höger.
AutoSize	string	Åsidosätt utdataupplösningen och ändra den så att den matchar visningsproportionen för indata, utan utfyllnad. Om indata till exempel är 1920x1080 och kodningsförinställningen frågar efter 1280x1280 åsidosätts värdet i förinställningen och utdata blir 1280x720, vilket upprätthåller förhållandet för indataaspekten på 16:9.
None	string	Strikt respektera utdataupplösningen utan att ta hänsyn till bildpunktsproportionen eller visningsproportionen för indatavideon.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Transform

En transformering kapslar in regler eller instruktioner för att generera önskade utdata från indatamedia, till exempel genom transkodning eller genom att extrahera insikter. När transformering har skapats kan den tillämpas på indatamedia genom att skapa jobb.

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Exempel – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Namnet på resursen
properties.created	string	DATUM OCH tid för UTC när transformering skapades i formatet "ÅÅÅÅ-MM-DDThh:mm:ssZ".
properties.description	string	En valfri utförlig beskrivning av transformering.
properties.lastModified	string	UTC-datum och tid då transformering senast uppdaterades, i formatet "ÅÅÅÅ-MM-DDThh:mm:ssZ".
properties.outputs	TransformOutput[]	En matris med en eller flera TransformOutputs som transformering ska generera.
systemData	systemData	Systemmetadata som är relaterade till den här resursen.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

TransformOutput

Beskriver egenskaperna för ett TransformOutput, som är de regler som ska tillämpas när du genererar önskade utdata.

Name	Typ	Description
onError	OnErrorType	En transformering kan definiera fler än en utdata. Den här egenskapen definierar vad tjänsten ska göra när en utdata misslyckas – antingen fortsätter du att skapa andra utdata eller stoppar de andra utdata. Det övergripande jobbtillståndet återspeglar inte fel i utdata som har angetts med "ContinueJob". Standardvärdet är "StopProcessingJob".
preset	Preset: AudioAnalyzerPreset BuiltInStandardEncoderPreset FaceDetectorPreset StandardEncoderPreset VideoAnalyzerPreset	Förinställning som beskriver de åtgärder som ska användas för att ändra, omkoda eller extrahera insikter från källfilen för att generera utdata.
relativePriority	Priority	Anger den relativa prioriteten för TransformOutputs i en transformering. Detta anger den prioritet som tjänsten använder för bearbetning av TransformOutputs. Standardprioriteten är Normal.

TransportStreamFormat

Beskriver egenskaperna för att generera utdatavideofiler för MPEG-2 Transport Stream (ISO/IEC 13818-1).

Name	Typ	Description
@odata.type	string: #Microsoft.Media.TransportStreamFormat	Diskriminator för härledda typer.
filenamePattern	string	Namngivningsmönstret för filer som används för att skapa utdatafiler. Följande makron stöds i filnamnet: {Basename} – ett expansionsmakro som använder namnet på videofilen för indata. Om basnamnet (filsuffixet ingår inte) för den inmatade videofilen är mindre än 32 tecken långt används basnamnet för indatavideofilerna. Om längden på basnamnet för videofilen för indata överskrider 32 tecken trunkeras basnamnet till de första 32 tecknen i total längd. {Extension} – lämpligt tillägg för det här formatet. {Label} – etiketten som tilldelats till codec/layer. {Index} – ett unikt index för miniatyrbilder. Gäller endast för miniatyrer. {AudioStream} – strängen "Audio" plus ljudströmsnummer (starta från 1). {Bitrate} – bithastigheten för ljud/video i kbps. Inte tillämpligt för miniatyrer. {Codec} – typen av ljud/video codec. {Resolution} – videoupplösningen. Alla outbildade makron döljs och tas bort från filnamnet.
outputFiles	OutputFile[]	Listan över utdatafiler som ska skapas. Varje post i listan är en uppsättning etiketter för ljud- och videolager som ska kopplas ihop .

Video

Beskriver de grundläggande egenskaperna för att koda indatavideon.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.Video	Diskrimineringen för härledda typer.
keyFrameInterval	string	Avståndet mellan två nyckelramar. Värdet ska vara icke-noll i intervallet [0,5, 20] sekunder, som anges i ISO 8601-format. Standardvärdet är 2 sekunder (PT2S). Observera att den här inställningen ignoreras om VideoSyncMode.Passthrough har angetts, där KeyFrameInterval-värdet följer inställningen för indatakällan.
label	string	En valfri etikett för codec. Etiketten kan användas för att styra muxing-beteendet.
stretchMode	StretchMode	Storleksändringsläget – hur indatavideon ändras så att den passar önskad utdataupplösning. Standardinställningen är AutoSize
syncMode	VideoSyncMode	Läget för videosynkronisering

VideoAnalyzerPreset

En förinställning för videoanalys som extraherar insikter (omfattande metadata) från både ljud och video och matar ut en JSON-formatfil.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.VideoAnalyzerPreset	Diskrimineringen för härledda typer.
audioLanguage	string	Språket för ljudnyttolasten i indata med BCP-47-formatet "language tag-region" (t.ex. "en-US"). Om du känner till språket i ditt innehåll rekommenderar vi att du anger det. Språket måste anges explicit för AudioAnalysisMode::Basic, eftersom automatisk språkidentifiering inte ingår i grundläggande läge. Om språket inte anges eller är inställt på null väljer automatisk språkidentifiering det första språk som identifieras och bearbetar med det valda språket under filens varaktighet. Det stöder för närvarande inte dynamisk växling mellan språk när det första språket har identifierats. Den automatiska identifieringen fungerar bäst med ljudinspelningar med tydligt urskiljbart tal. Om det inte går att hitta språket för automatisk identifiering skulle transkriptionen återgå till "en-US"." Listan över språk som stöds finns här: https://go.microsoft.com/fwlink/?linkid=2109463
experimentalOptions	object	Ordlista som innehåller nyckelvärdepar för parametrar som inte exponeras i själva förinställningen
insightsToExtract	InsightsType	Definierar vilken typ av insikter du vill att tjänsten ska generera. De tillåtna värdena är "AudioInsightsOnly", "VideoInsightsOnly" och "AllInsights". Standardvärdet är AllInsights. Om du ställer in detta på AllInsights och indata endast är ljud genereras endast ljudinsikter. På samma sätt genereras endast videoinsikter om indata endast är videoindata. Vi rekommenderar att du inte använder AudioInsightsOnly om du förväntar dig att vissa av dina indata endast ska vara video. eller använd VideoInsightsOnly om du förväntar dig att vissa av dina indata endast ska vara ljud. Dina jobb under sådana förhållanden skulle göra fel.
mode	AudioAnalysisMode	Avgör vilken uppsättning ljudanalysåtgärder som ska utföras. Om det är ospecificerat väljs Standard AudioAnalysisMode.

VideoOverlay

Beskriver egenskaperna för ett videoöverlägg.

Name	Typ	Description
@odata.type	string: #Microsoft.Media.VideoOverlay	Diskrimineringen för härledda typer.
audioGainLevel	number	Ljudökningsnivån i överlägget. Värdet ska ligga i intervallet [0, 1.0]. Standardvärdet är 1,0.
cropRectangle	Rectangle	Ett valfritt rektangulärt fönster som används för att beskära överläggsbilden eller videon.
end	string	Slutpositionen, med referens till indatavideon, där överlägget slutar. Värdet ska vara i ISO 8601-format. Till exempel PT30S för att avsluta överlägget 30 sekunder in i indatavideon. Om värdet inte anges eller om värdet är större än varaktigheten för indatavideon tillämpas överlägget till slutet av indatavideon om medievaraktigheten för överlägget är större än videons varaktighet, annars varar överlägget så länge som överläggets medievaraktighet.
fadeInDuration	string	Hur lång tid överlägget tonas in i indatavideon. Värdet ska vara i ISO 8601-varaktighetsformat. Om inte anges är standardbeteendet att inte ha någon toning i (samma som PT0S).
fadeOutDuration	string	Hur lång tid överlägget tonas ut från indatavideon. Värdet ska vara i ISO 8601-varaktighetsformat. Om inte anges är standardbeteendet att inte ha någon toning (samma som PT0S).
inputLabel	string	Etiketten för jobbindata som ska användas som ett överlägg. Indata måste ange exakt en fil. Du kan ange en bildfil i JPG-, PNG-, GIF- eller BMP-format eller en ljudfil (till exempel en WAV-, MP3-, WMA- eller M4A-fil) eller en videofil. Se https://aka.ms/mesformats den fullständiga listan över ljud- och videofilformat som stöds.
opacity	number	Överläggets opacitet. Det här är ett värde i intervallet [0 – 1,0]. Standardvärdet är 1,0, vilket innebär att överlägget är täckande.
position	Rectangle	Platsen i indatavideon där överlägget används.
start	string	Startpositionen, med referens till indatavideon, där överlägget startar. Värdet ska vara i ISO 8601-format. Till exempel PT05S för att starta överlägget vid 5 sekunder i indatavideon. Om det inte anges startar överlägget från början av indatavideon.

VideoSyncMode

Läget för videosynkronisering

Name	Typ	Description
Auto	string	Det här är standardmetoden. Väljer mellan Cfr och Vfr beroende på muxer-funktioner. För utdataformatET MP4 är standardläget Cfr.
Cfr	string	Indataramar upprepas och/eller tas bort efter behov för att uppnå exakt den begärda konstanta bildfrekvensen. Rekommenderas när utdataramhastigheten uttryckligen anges till ett angivet värde
Passthrough	string	Presentationens tidsstämplar för bildrutor skickas från indatafilen till utdatafilskrivaren. Rekommenderas när indatakällan har variabel bildfrekvens och försöker skapa flera lager för anpassningsbar direktuppspelning i utdata som har justerade GOP-gränser. Obs! Om två eller flera bildrutor i indata har duplicerade tidsstämplar kommer utdata också att ha samma beteende
Vfr	string	Liknar genomströmningsläget, men om indata har bildrutor som har duplicerade tidsstämplar skickas bara en bildruta till utdata och andra tas bort. Rekommenderas när antalet utdataramar förväntas vara lika med antalet indataramar. Utdata används till exempel för att beräkna ett kvalitetsmått som PSNR mot indata