Dela via


Transforms - Create Or Update

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

Exempelbegäran

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

Exempelsvar

{
  "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"
  }
}
{
  "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[]:

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[]:

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[]:

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:

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