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 |
---|---|---|---|---|
account
|
path | True |
string |
Media Services-kontonamnet. |
resource
|
path | True |
string |
Namnet på resursgruppen i Azure-prenumerationen. |
subscription
|
path | True |
string |
Den unika identifieraren för en Microsoft Azure-prenumeration. |
transform
|
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 |
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 |
OK |
|
201 Created |
Skapad |
|
Other Status Codes |
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 |
---|---|
Aac |
Beskriver inställningar för AAC-ljudkodning (Advanced Audio Codec). |
Aac |
Den kodningsprofil som ska användas vid kodning av ljud med AAC. |
Analysis |
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. |
Audio |
Avgör vilken uppsättning ljudanalysåtgärder som ska utföras. Om det är ospecificerat väljs Standard AudioAnalysisMode. |
Audio |
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. |
Audio |
Beskriver egenskaperna för ett ljudöverlägg. |
Blur |
Oskärpatyp |
Built |
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. |
Copy |
En codec-flagga som instruerar kodaren att kopiera bitströmmen för indataljudet. |
Copy |
En codec-flagga som instruerar kodaren att kopiera indatavideons bitström utan omkodning. |
created |
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. |
Deinterlace |
Deinterlacing-läget. Standardvärdet är AutoPixelAdaptive. |
Deinterlace |
Fältparitet för avflätning, standardvärdet Auto. |
Encoder |
Den inbyggda förinställningen som ska användas för kodning av videor. |
Entropy |
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. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Face |
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. |
Face |
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. |
H264Rate |
Videohastighetskontrollläget |
H264Video |
Beskriver alla egenskaper för att koda en video med H.264 codec. |
H264Video |
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. |
H265Video |
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 |
Image |
Beskriver egenskaperna för en utdatabildfil. |
Insights |
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. |
Interleave |
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. |
Jpg |
Beskriver inställningarna för att skapa JPEG-miniatyrer. |
Jpg |
Beskriver egenskaperna för att skapa en serie JPEG-bilder från indatavideon. |
Jpg |
Beskriver inställningarna för att skapa en JPEG-bild från indatavideon. |
Mp4Format |
Beskriver egenskaperna för en ISO MP4-utdatafil. |
Multi |
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. |
On |
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". |
Output |
Representerar en utdatafil som skapats. |
Png |
Beskriver inställningarna för att skapa PNG-miniatyrer. |
Png |
Beskriver egenskaperna för att producera en serie PNG-bilder från indatavideon. |
Png |
Beskriver inställningarna för att skapa en PNG-bild från indatavideon. |
Preset |
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 |
Standard |
Beskriver alla inställningar som ska användas vid kodning av indatavideon med standardkodaren. |
Stretch |
Storleksändringsläget – hur indatavideon ändras så att den passar önskad utdataupplösning. Standardinställningen är AutoSize |
system |
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. |
Transform |
Beskriver egenskaperna för ett TransformOutput, som är de regler som ska tillämpas när du genererar önskade utdata. |
Transport |
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. |
Video |
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. |
Video |
Beskriver egenskaperna för ett videoöverlägg. |
Video |
Läget för videosynkronisering |
AacAudio
Beskriver inställningar för AAC-ljudkodning (Advanced Audio Codec).
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
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 |
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. |
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. |
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 |
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. |
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. |
Diskriminator för härledda typer. |
configurations |
Valfria konfigurationsinställningar för kodare. Konfigurationer stöds endast för ContentAwareEncoding och H265ContentAwareEncoding BuiltInStandardEncoderPreset. |
|
presetName |
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. |
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. |
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. |
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 |
Deinterlacing-läget. Standardvärdet är AutoPixelAdaptive. |
|
parity |
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 |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
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. |
Diskriminator för härledda typer. |
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 |
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 |
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 |
Parametrarna för det rektangulära fönstret som indatavideon ska beskäras med. |
|
deinterlace |
Inställningarna för avflätning. |
|
fadeIn |
Beskriver egenskaperna för en Toningseffekt som tillämpas på indatamediet. |
|
fadeOut |
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 |
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 |
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 |
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. |
Diskriminator för härledda typer. |
complexity |
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 |
Samlingen av H.264-utdataskikt som ska produceras av kodaren. |
|
rateControlMode |
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 |
Storleksändringsläget – hur indatavideon ändras så att den passar önskade utdataupplösning(ar). Standardvärdet är AutoSize |
|
syncMode |
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 |
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. |
Diskrimineringen för härledda typer. |
complexity |
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 |
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 |
Storleksändringsläget – hur indatavideon ändras så att den passar önskad utdataupplösning. Standardinställningen är AutoSize |
|
syncMode |
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. |
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 |
Storleksändringsläget – hur indatavideon ändras så att den passar önskade utdataupplösning(ar). Standardvärdet är AutoSize |
|
syncMode |
Videosynkroniseringsläge |
ImageFormat
Beskriver egenskaperna för en utdatabildfil.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
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. |
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. |
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 |
Jpg |
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 |
Storleksändringsläget – hur indatavideon ändras så att den passar önskade utdataupplösning(ar). Standardvärdet är AutoSize |
|
syncMode |
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. |
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 |
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. |
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 |
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. |
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. |
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 |
Png |
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 |
Storleksändringsläget – hur indatavideon ändras så att den passar önskade utdataupplösning(ar). Standardvärdet är AutoSize |
|
syncMode |
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 |
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 |
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. |
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 |
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 |
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 |
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 |
En matris med en eller flera TransformOutputs som transformering ska generera. |
|
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 |
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 |
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. |
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 |
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. |
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 |
Storleksändringsläget – hur indatavideon ändras så att den passar önskad utdataupplösning. Standardinställningen är AutoSize |
|
syncMode |
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. |
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 |
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 |
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. |
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 |
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 |
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 |