Transforms - Update
Aktualizovat transformaci
Aktualizace transformace.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}?api-version=2022-07-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
account
|
path | True |
string |
Název účtu služby Media Services. |
resource
|
path | True |
string |
Název skupiny prostředků v rámci předplatného Azure. |
subscription
|
path | True |
string |
Jedinečný identifikátor předplatného Microsoft Azure. |
transform
|
path | True |
string |
Název transformace. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít s žádostí klienta. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
properties.outputs | True |
Pole s jedním nebo více objekty TransformOutputs, které by měla transformace vygenerovat. |
|
properties.description |
string |
Volitelný podrobný popis transformace. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Podrobné informace o chybě |
Příklady
Update a Transform.
Ukázkový požadavek
PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/transformToUpdate?api-version=2022-07-01
{
"properties": {
"description": "Example transform to illustrate update.",
"outputs": [
{
"relativePriority": "High",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "H264MultipleBitrate720p"
}
}
]
}
}
Ukázková odpověď
{
"name": "transformToUpdate",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/transformToUpdate",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:32.1435128Z",
"description": "Example transform to illustrate update.",
"lastModified": "2022-10-17T23:14:32.1455494Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "High",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "H264MultipleBitrate720p"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:32.1435128Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:32.1455494Z"
}
}
Definice
Name | Description |
---|---|
Aac |
Popisuje nastavení kódování zvuku AAC (Advanced Audio Codec). |
Aac |
Profil kódování, který se má použít při kódování zvuku pomocí AAC. |
Analysis |
Určuje maximální rozlišení, při kterém se video analyzuje. Výchozí chování je SourceResolution, které při analýze zachová vstupní video v původním rozlišení. Při použití standardu "StandardDefinition" změníte velikost vstupních videí na standardní definici při zachování příslušného poměru stran. Velikost se změní jenom v případě, že má video vyšší rozlišení. Například vstup 1920x1080 by se před zpracováním škáloval na 640x360. Přepnutím na StandardDefinition se zkrátí doba potřebná ke zpracování videa ve vysokém rozlišení. Může také snížit náklady na používání této komponenty (podrobnosti viz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Tváře, které jsou ve videu se změněnou velikostí příliš malé, ale nemusí být rozpoznány. |
Audio |
Definuje společné vlastnosti pro všechny zvukové kodeky. |
Audio |
Určuje sadu operací analýzy zvuku, které se mají provést. Pokud není zadáno, bude zvolena možnost Standard AudioAnalysisMode. |
Audio |
Předvolba Analyzátoru zvuku použije předdefinované sady analytických operací založených na umělé inteligenci, včetně přepisu řeči. V současné době předvolba podporuje zpracování obsahu pomocí jedné zvukové stopy. |
Audio |
Popisuje vlastnosti překryvu zvuku. |
Blur |
Typ rozostření |
Built |
Popisuje integrovanou předvolbu pro kódování vstupního videa pomocí standardního kodéru. |
Complexity |
Umožňuje nakonfigurovat nastavení kodéru pro řízení rovnováhy mezi rychlostí a kvalitou. Příklad: Pro rychlejší kódování, ale nižší efektivitu komprese nastavíte jako Rychlost. |
Copy |
Příznak kodeku, který kodéru říká, aby zkopíroval vstupní datový proud zvuku. |
Copy |
Příznak kodeku, který říká kodéru, aby zkopíroval vstupní datový proud videa bez opětovného kódování. |
created |
Typ identity, která prostředek vytvořila. |
DDAudio |
Popisuje nastavení kódování zvuku Ac3 (Dolby Digital Audio Codec). Aktuální implementace pro podporu Dolby Digital Audio jsou: Čísla zvukových kanálů na 1((mono), 2(stereo), 6(5.1side); Frekvence vzorkování zvuku při: 32K/44.1K/48K Hz; Hodnoty přenosových rychlostí zvuku, které podporuje specifikace AC3: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 b/s. |
Deinterlace |
Popisuje nastavení prokládání. |
Deinterlace |
Režim prolnutí. Výchozí hodnota je AutoPixelAdaptive. |
Deinterlace |
Parita pole pro prokládání je ve výchozím nastavení nastavená na Automaticky. |
Encoder |
Integrovaná předvolba, která se má použít pro kódování videí. |
Entropy |
Režim entropie, který se má použít pro tuto vrstvu. Pokud není zadán, kodér zvolí režim, který je vhodný pro profil a úroveň. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Face |
Popisuje všechna nastavení, která se mají použít při analýze videa, aby bylo možné rozpoznat (a volitelně redigovat) všechny přítomné tváře. |
Face |
Tento režim umožňuje zvolit mezi následujícími nastaveními: 1) Analyzovat – pouze pro detekci. Tento režim vygeneruje soubor JSON metadat označující vzhled tváří v celém videu. Pokud je to možné, přiřazuje se vzhledům stejné osoby stejné ID. 2) Kombinace – navíc rediguje (rozostřuje) rozpoznané tváře. 3) Redact – to umožňuje 2-pass proces, který umožňuje selektivní redakci podmnožina detekovaných tváří. Přebírá soubor metadat z předchozího předání analýzy spolu se zdrojovým videem a uživatelem vybranou podmnožinou ID, která vyžadují redigování. |
Fade |
Popisuje vlastnosti efektu Fade použitého na vstupní médium. |
Filters |
Popisuje všechny operace filtrování, jako je zrušení prokládání, otočení atd., které se mají použít na vstupní médium před kódováním. |
H264Complexity |
Říká kodéru, jak zvolit nastavení kódování. Výchozí hodnota je Vyvážená. |
H264Layer |
Popisuje nastavení, která se mají použít při kódování vstupního videa do požadované výstupní vrstvy přenosové rychlosti pomocí kodeku videa H.264. |
H264Rate |
Režim řízení rychlosti videa |
H264Video |
Popisuje všechny vlastnosti kódování videa pomocí kodeku H.264. |
H264Video |
V současné době podporujeme Směrný plán, Hlavní, Vysoké, High422, High444. Výchozí hodnota je Automaticky. |
H265Complexity |
Říká kodéru, jak má zvolit nastavení kódování. Kvalita zajistí vyšší kompresní poměr, ale s vyššími náklady a delším výpočetním časem. Rychlost vytvoří relativně větší soubor, ale je rychlejší a úspornější. Výchozí hodnota je Vyvážené. |
H265Layer |
Popisuje nastavení, která se mají použít při kódování vstupního videa do požadované vrstvy výstupní přenosové rychlosti pomocí video kodeku H.265. |
H265Video |
Popisuje všechny vlastnosti kódování videa pomocí kodeku H.265. |
H265Video |
V současné době podporujeme Main. Výchozí hodnota je Automaticky. |
Image |
Popisuje základní vlastnosti pro generování miniatur ze vstupního videa. |
Image |
Popisuje vlastnosti výstupního souboru obrázku. |
Insights |
Definuje typ přehledů, které má služba generovat. Povolené hodnoty jsou AudioInsightsOnly, VideoInsightsOnly a AllInsights. Výchozí hodnota je AllInsights. Pokud tuto možnost nastavíte na AllInsights a vstup bude jenom zvuk, vygenerují se jenom zvukové přehledy. Podobně pokud je vstupem jenom video, vygenerují se jenom přehledy videa. Doporučujeme nepoužívat AudioInsightsOnly, pokud očekáváte, že některé vaše vstupy budou pouze video; nebo použijte VideoInsightsOnly, pokud očekáváte, že některé vstupy budou jenom zvukové. Vaše úlohy v takových podmínkách by došlo k chybě. |
Interleave |
Nastaví režim prokládání výstupu tak, aby se ovládl způsob ukládání zvuku a videa ve formátu kontejneru. Příklad: Nastavte InterleavedOutput jako NonInterleavedOutput, aby se v samostatných souborech MP4 vytvářely výstupy jen pro zvuk a video. |
Jpg |
Popisuje nastavení pro vytváření miniatur JPEG. |
Jpg |
Popisuje vlastnosti pro vytvoření řady obrázků JPEG ze vstupního videa. |
Jpg |
Popisuje nastavení pro vytvoření obrázku JPEG ze vstupního videa. |
Mp4Format |
Popisuje vlastnosti výstupního souboru ISO MP4. |
Multi |
Popisuje vlastnosti pro vytvoření kolekce gop zarovnané souborů s více přenosovými rychlostmi. Výchozím chováním je vytvoření jednoho výstupního souboru pro každou vrstvu videa, která se směšuje se všemi zvuky. Přesné výstupní soubory lze řídit zadáním outputFiles kolekce. |
On |
Transformace může definovat více než jeden výstup. Tato vlastnost definuje, co má služba dělat, když jeden výstup selže – buď pokračovat ve vytváření dalších výstupů, nebo zastavit ostatní výstupy. Celkový stav úlohy nebude odrážet selhání výstupů zadaných pomocí continuejob. Výchozí hodnota je StopProcessingJob. |
Output |
Představuje vytvořený výstupní soubor. |
Png |
Popisuje nastavení pro vytváření miniatur PNG. |
Png |
Popisuje vlastnosti pro vytvoření řady obrázků PNG ze vstupního videa. |
Png |
Popisuje nastavení pro vytvoření obrázku PNG ze vstupního videa. |
Preset |
Objekt s volitelným nastavením konfigurace kodéru. |
Priority |
Nastaví relativní prioritu TransformOutputs v rámci transformace. Tím se nastaví priorita, kterou služba používá ke zpracování TransformOutputs. Výchozí priorita je Normální. |
Rectangle |
Popisuje vlastnosti obdélníkového okna použitého na vstupní médium před jeho zpracováním. |
Rotation |
Případné otočení, které se má použít u vstupního videa před kódováním. Výchozí hodnota je Automaticky. |
Standard |
Popisuje všechna nastavení, která se mají použít při kódování vstupního videa pomocí standardního kodéru. |
Stretch |
Režim změny velikosti – změna velikosti vstupního videa tak, aby odpovídala požadovaným výstupním rozlišením. Výchozí nastavení je automatické nastavení velikosti. |
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
Transform |
Transformace zapouzdřuje pravidla nebo instrukce pro generování požadovaných výstupů ze vstupního média, například překódováním nebo extrahováním přehledů. Po vytvoření transformace se dá použít na vstupní médium vytvořením úloh. |
Transform |
Popisuje vlastnosti TransformOutput, což jsou pravidla, která se mají použít při generování požadovaného výstupu. |
Transport |
Popisuje vlastnosti pro generování výstupních videosouborů přenosového proudu MPEG-2 (ISO/IEC 13818-1). |
Video |
Popisuje základní vlastnosti kódování vstupního videa. |
Video |
Předvolba analyzátoru videa, která extrahuje přehledy (bohatá metadata) ze zvuku i videa a vypíše soubor formátu JSON. |
Video |
Popisuje vlastnosti překryvného videa. |
Video |
Režim synchronizace videa |
AacAudio
Popisuje nastavení kódování zvuku AAC (Advanced Audio Codec).
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
bitrate |
integer |
Přenosová rychlost výstupního zakódovaného zvuku (v bitech za sekundu). |
channels |
integer |
Počet kanálů ve zvuku. |
label |
string |
Volitelný popisek kodeku Popisek se dá použít k řízení chování při muxingu. |
profile |
Profil kódování, který se má použít při kódování zvuku pomocí AAC. |
|
samplingRate |
integer |
Vzorkovací frekvence, která se má použít pro kódování hertz. |
AacAudioProfile
Profil kódování, který se má použít při kódování zvuku pomocí AAC.
Name | Typ | Description |
---|---|---|
AacLc |
string |
Určuje, že výstupní zvuk se má zakódovat do profilu AAC s nízkou složitostí (AAC-LC). |
HeAacV1 |
string |
Určuje, že výstupní zvuk se má zakódovat do profilu HE-AAC v1. |
HeAacV2 |
string |
Určuje, že výstupní zvuk se má zakódovat do profilu HE-AAC v2. |
AnalysisResolution
Určuje maximální rozlišení, při kterém se video analyzuje. Výchozí chování je SourceResolution, které při analýze zachová vstupní video v původním rozlišení. Při použití standardu "StandardDefinition" změníte velikost vstupních videí na standardní definici při zachování příslušného poměru stran. Velikost se změní jenom v případě, že má video vyšší rozlišení. Například vstup 1920x1080 by se před zpracováním škáloval na 640x360. Přepnutím na StandardDefinition se zkrátí doba potřebná ke zpracování videa ve vysokém rozlišení. Může také snížit náklady na používání této komponenty (podrobnosti viz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Tváře, které jsou ve videu se změněnou velikostí příliš malé, ale nemusí být rozpoznány.
Name | Typ | Description |
---|---|---|
SourceResolution |
string |
|
StandardDefinition |
string |
Audio
Definuje společné vlastnosti pro všechny zvukové kodeky.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
bitrate |
integer |
Přenosová rychlost výstupu zakódovaného zvuku v bitech za sekundu. |
channels |
integer |
Počet kanálů ve zvuku. |
label |
string |
Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu. |
samplingRate |
integer |
Vzorkovací frekvence, která se má použít pro kódování v hertz. |
AudioAnalysisMode
Určuje sadu operací analýzy zvuku, které se mají provést. Pokud není zadáno, bude zvolena možnost Standard AudioAnalysisMode.
Name | Typ | Description |
---|---|---|
Basic |
string |
Tento režim provádí přepis řeči na text a generování souboru titulků/popis VTT. Výstup tohoto režimu obsahuje soubor JSON přehledů, který obsahuje pouze klíčová slova, přepis a informace o načasování. Automatický rozpoznávání jazyka a diarizace mluvčího nejsou v tomto režimu zahrnuty. |
Standard |
string |
Provádí všechny operace zahrnuté v základním režimu a navíc provádí rozpoznávání jazyka a diarizaci mluvčího. |
AudioAnalyzerPreset
Předvolba Analyzátoru zvuku použije předdefinované sady analytických operací založených na umělé inteligenci, včetně přepisu řeči. V současné době předvolba podporuje zpracování obsahu pomocí jedné zvukové stopy.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
audioLanguage |
string |
Jazyk datové části zvuku ve vstupu ve formátu BCP-47 jazyka tag-region (např. en-US). Pokud znáte jazyk obsahu, doporučujeme ho zadat. Jazyk musí být určen explicitně pro AudioAnalysisMode::Basic, protože automatické rozpoznávání jazyka není součástí základního režimu. Pokud jazyk není zadaný nebo nastavený na hodnotu null, automatické rozpoznávání jazyka zvolí první zjištěný jazyk a zpracuje ho s vybraným jazykem po dobu trvání souboru. V současné době nepodporuje dynamické přepínání mezi jazyky po zjištění prvního jazyka. Automatická detekce funguje nejlépe se zvukovými záznamy s jasně rozpoznatelnou řečí. Pokud se automatickému zjišťování nepodaří najít jazyk, přepis se vrátí do en-US. Seznam podporovaných jazyků je k dispozici tady: https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
Slovník obsahující páry hodnot klíčů pro parametry, které nejsou zpřístupněny v samotné předvolbě |
mode |
Určuje sadu operací analýzy zvuku, které mají být provedeny. Pokud není zadán, bude zvolena možnost Standard AudioAnalysisMode. |
AudioOverlay
Popisuje vlastnosti překryvu zvuku.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
audioGainLevel |
number |
Úroveň zesílení zvuku v překryvu. Hodnota by měla být v rozsahu [0, 1,0]. Výchozí hodnota je 1.0. |
end |
string |
Koncová pozice s odkazem na vstupní video, na kterém končí překryv. Hodnota by měla být ve formátu ISO 8601. Například PT30S, který ukončí překryv po 30 sekundách vstupního videa. Pokud není zadána hodnota nebo je hodnota větší než doba trvání vstupního videa, bude překrytí použito až do konce vstupního videa, pokud je doba trvání překryvného média větší než doba trvání vstupního videa, jinak překrytí potrvá stejně dlouho jako překryvné médium. |
fadeInDuration |
string |
Doba trvání, po kterou se překryvné zobrazení postupně slábne na vstupní video. Hodnota by měla být ve formátu doby trvání ISO 8601. Pokud není zadaný, výchozí chování je bez prolnutí (stejné jako PT0S). |
fadeOutDuration |
string |
Doba, po kterou překryv ze vstupního videa zmizí. Hodnota by měla být ve formátu doby trvání ISO 8601. Pokud není zadaný, výchozím chováním je bez prolnutí (stejné jako PT0S). |
inputLabel |
string |
Popisek vstupu úlohy, který se má použít jako překryv. Vstup musí obsahovat přesně jeden soubor. Můžete zadat soubor obrázku ve formátu JPG, PNG, GIF nebo BMP, zvukový soubor (například soubor WAV, MP3, WMA nebo M4A) nebo videosoubor. Úplný seznam podporovaných formátů zvukových souborů a videosouborů najdete v tématu https://aka.ms/mesformats . |
start |
string |
Počáteční pozice s odkazem na vstupní video, na kterém začíná překryv. Hodnota by měla být ve formátu ISO 8601. Například PT05S spustí překrytí po 5 sekundách vstupního videa. Pokud není zadaný, překryv se spustí od začátku vstupního videa. |
BlurType
Typ rozostření
Name | Typ | Description |
---|---|---|
Black |
string |
Černá: Začerněný filtr |
Box |
string |
Pole: filtr ladění, pouze ohraničující rámeček |
High |
string |
Vysoká: Záměná filtr rozostření |
Low |
string |
Nízký: krabicový filtr rozostření |
Med |
string |
Med: Gaussian rozostření filtr |
BuiltInStandardEncoderPreset
Popisuje integrovanou předvolbu pro kódování vstupního videa pomocí standardního kodéru.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
configurations |
Volitelná nastavení konfigurace pro kodér Konfigurace se podporují jenom pro ContentAwareEncoding a H265ContentAwareEncoding BuiltInStandardEncoderPreset. |
|
presetName |
Integrovaná předvolba, která se použije pro kódování videí. |
Complexity
Umožňuje nakonfigurovat nastavení kodéru pro řízení rovnováhy mezi rychlostí a kvalitou. Příklad: Pro rychlejší kódování, ale nižší efektivitu komprese nastavíte jako Rychlost.
Name | Typ | Description |
---|---|---|
Balanced |
string |
Nakonfiguruje kodér tak, aby používal nastavení, která zajistí rovnováhu mezi rychlostí a kvalitou. |
Quality |
string |
Konfiguruje kodér tak, aby používal nastavení optimalizovaná pro vyšší kvalitu výstupu na úkor zpomalení celkové doby kódování. |
Speed |
string |
Nakonfiguruje kodér tak, aby používal nastavení optimalizovaná pro rychlejší kódování. Kvalita se obětuje, aby se zkrátila doba kódování. |
CopyAudio
Příznak kodeku, který kodéru říká, aby zkopíroval vstupní datový proud zvuku.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
label |
string |
Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu. |
CopyVideo
Příznak kodeku, který říká kodéru, aby zkopíroval vstupní datový proud videa bez opětovného kódování.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
label |
string |
Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu. |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DDAudio
Popisuje nastavení kódování zvuku Ac3 (Dolby Digital Audio Codec). Aktuální implementace pro podporu Dolby Digital Audio jsou: Čísla zvukových kanálů na 1((mono), 2(stereo), 6(5.1side); Frekvence vzorkování zvuku při: 32K/44.1K/48K Hz; Hodnoty přenosových rychlostí zvuku, které podporuje specifikace AC3: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 b/s.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
bitrate |
integer |
Přenosová rychlost výstupního zakódovaného zvuku (v bitech za sekundu). |
channels |
integer |
Počet kanálů ve zvuku. |
label |
string |
Volitelný popisek kodeku Popisek se dá použít k řízení chování při muxingu. |
samplingRate |
integer |
Vzorkovací frekvence, která se má použít pro kódování hertz. |
Deinterlace
Popisuje nastavení prokládání.
Name | Typ | Description |
---|---|---|
mode |
Režim prokládání. Výchozí hodnota je AutoPixelAdaptive. |
|
parity |
Parita pole pro prokládání je ve výchozím nastavení automaticky. |
DeinterlaceMode
Režim prolnutí. Výchozí hodnota je AutoPixelAdaptive.
Name | Typ | Description |
---|---|---|
AutoPixelAdaptive |
string |
Použijte automatické adaptivní dělení pixelů na každý snímek ve vstupním videu. |
Off |
string |
Zakáže prokládání zdrojového videa. |
DeinterlaceParity
Parita pole pro prokládání je ve výchozím nastavení nastavená na Automaticky.
Name | Typ | Description |
---|---|---|
Auto |
string |
Automaticky zjistit pořadí polí |
BottomFieldFirst |
string |
Použití dolního pole jako první zpracování vstupního videa |
TopFieldFirst |
string |
Použití horního pole jako první zpracování vstupního videa |
EncoderNamedPreset
Integrovaná předvolba, která se má použít pro kódování videí.
Name | Typ | Description |
---|---|---|
AACGoodQualityAudio |
string |
Vytvoří jeden soubor MP4 obsahující pouze stereofonní zvuk AAC kódovaný rychlostí 192 kb/s. |
AdaptiveStreaming |
string |
Vytvoří sadu souborů MP4 zarovnaných s gop s videem H.264 a stereo zvukem AAC. Automaticky generuje žebřík přenosové rychlosti na základě vstupního rozlišení, přenosové rychlosti a snímkové frekvence. Automaticky vygenerovaná předvolba nikdy nepřekročí rozlišení vstupu. Pokud je například vstup 720p, zůstane výstup v nejlepším případě 720p. |
ContentAwareEncoding |
string |
Vytvoří sadu sad MP4 zarovnaných s gop pomocí kódování s vědomím obsahu. Vzhledem k jakémukoli vstupnímu obsahu služba provede počáteční jednoduchou analýzu vstupního obsahu a pomocí výsledků určí optimální počet vrstev, odpovídající přenosovou rychlost a nastavení rozlišení pro doručování adaptivním streamováním. Tato předvolba je zvláště účinná u videí s nízkou a střední složitostí, kde budou výstupní soubory s nižší přenosovou rychlostí, ale v kvalitě, která stále poskytuje dobré prostředí pro diváky. Výstup bude obsahovat soubory MP4 s prokládáním videa a zvuku. |
ContentAwareEncodingExperimental |
string |
Zveřejňuje experimentální předvolbu pro kódování s vědomím obsahu. Vzhledem k jakémukoli vstupnímu obsahu se služba pokusí automaticky určit optimální počet vrstev, odpovídající nastavení přenosové rychlosti a rozlišení pro doručování adaptivním streamováním. Základní algoritmy se budou v průběhu času dál vyvíjet. Výstup bude obsahovat soubory MP4 s prokládáním videa a zvuku. |
CopyAllBitrateNonInterleaved |
string |
Zkopírujte všechny video a zvukové streamy ze vstupního prostředku jako neprokládané výstupní video a zvukové výstupní soubory. Tuto předvolbu můžete použít k oříznutí existujícího prostředku nebo k převodu souborů MP4 zarovnaných do skupiny klíčových snímků (GOP) jako prostředku, který lze streamovat. |
DDGoodQualityAudio |
string |
Vytvoří jeden soubor MP4 obsahující pouze stereofonní zvuk DD(Digital Dolby) kódovaný rychlostí 192 kb/s. |
H264MultipleBitrate1080p |
string |
Vytvoří sadu 8 souborů MP4 zarovnaných s gopem v rozsahu od 6000 kb/s do 400 kbps a stereofonního zvuku AAC. Rozlišení začíná na 1080p a klesne na 180p. |
H264MultipleBitrate720p |
string |
Vytvoří sadu 6 souborů MP4 zarovnaných na GOP v rozsahu od 3400 kb/s do 400 kbps a stereofonního zvuku AAC. Rozlišení začíná na 720p a přejde na 180p. |
H264MultipleBitrateSD |
string |
Vytvoří sadu 5 souborů MP4 zarovnaných s gopem v rozsahu od 1900 kb/s do 400 kb/s a stereofonního zvuku AAC. Rozlišení začíná na 480p a klesne na 240p. |
H264SingleBitrate1080p |
string |
Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.264 rychlostí 6750 kb/s a výškou obrázku 1080 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s. |
H264SingleBitrate720p |
string |
Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.264 rychlostí 4500 kb/s a výškou obrázku 720 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s. |
H264SingleBitrateSD |
string |
Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.264 rychlostí 2200 kb/s a výškou obrázku 480 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s. |
H265AdaptiveStreaming |
string |
Vytvoří sadu souborů MP4 zarovnaných s gop s videem H.265 a stereo zvukem AAC. Automaticky generuje žebřík přenosové rychlosti na základě vstupního rozlišení, přenosové rychlosti a snímkové frekvence. Automaticky vygenerovaná předvolba nikdy nepřekročí rozlišení vstupu. Pokud je například vstup 720p, zůstane výstup v nejlepším případě 720p. |
H265ContentAwareEncoding |
string |
Vytvoří sadu sad MP4 zarovnaných s gop pomocí kódování s vědomím obsahu. Vzhledem k jakémukoli vstupnímu obsahu služba provede počáteční jednoduchou analýzu vstupního obsahu a pomocí výsledků určí optimální počet vrstev, odpovídající přenosovou rychlost a nastavení rozlišení pro doručování adaptivním streamováním. Tato předvolba je zvláště účinná u videí s nízkou a střední složitostí, kde budou výstupní soubory s nižší přenosovou rychlostí, ale v kvalitě, která stále poskytuje dobré prostředí pro diváky. Výstup bude obsahovat soubory MP4 s prokládáním videa a zvuku. |
H265SingleBitrate1080p |
string |
Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.265 rychlostí 3500 kb/s a výškou obrázku 1080 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s. |
H265SingleBitrate4K |
string |
Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.265 při 9500 kb/s a výškou obrázku 2160 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s. |
H265SingleBitrate720p |
string |
Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.265 rychlostí 1800 kb/s a výškou obrázku 720 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s. |
EntropyMode
Režim entropie, který se má použít pro tuto vrstvu. Pokud není zadán, kodér zvolí režim, který je vhodný pro profil a úroveň.
Name | Typ | Description |
---|---|---|
Cabac |
string |
Kódování entropie CABAC (Context Adaptive Binary Binary Aritmetic Coder). |
Cavlc |
string |
Kódování entropie jazyka CAVLC (Context Adaptive Variable Length Coder). |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Další typ informací. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
FaceDetectorPreset
Popisuje všechna nastavení, která se mají použít při analýze videa, aby bylo možné rozpoznat (a volitelně redigovat) všechny přítomné tváře.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
blurType |
Typ rozostření |
|
experimentalOptions |
object |
Slovník obsahující páry hodnot klíčů pro parametry, které nejsou zpřístupněny v samotné předvolbě |
mode |
Tento režim poskytuje možnost výběru mezi následujícími nastaveními: 1) Analyzovat – pouze pro detekci. Tento režim vygeneruje soubor JSON s metadaty označující vzhled tváří v celém videu. Tam, kde je to možné, se vzhledy stejné osoby přiřadí ke stejnému ID. 2) Kombinace – navíc rediguje (rozostřuje) rozpoznané tváře. 3) Redigovat – to umožňuje 2-pass proces, který umožňuje selektivní redakci podmnožinu detekovaných tváří. Převezme soubor metadat z předchozího průchodu analýzy spolu se zdrojovým videem a uživatelem vybranou podmnožinou ID, která vyžadují redigování. |
|
resolution |
Určuje maximální rozlišení, při kterém se video analyzuje. Výchozí chování je SourceResolution, což při analýze zachová vstupní video v původním rozlišení. Použitím standardu "StandardDefinition" změníte velikost vstupních videí na standardní definici při zachování příslušného poměru stran. Velikost se změní jenom v případě, že má video vyšší rozlišení. Například vstup 1920 × 1080 by se před zpracováním škáloval na 640 × 360. Přepnutím na StandardDefinition se zkrátí doba potřebná ke zpracování videa ve vysokém rozlišení. Může také snížit náklady na používání této komponenty (podrobnosti viz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Tváře, které budou ve změně velikosti videa příliš malé, ale nemusí být rozpoznány. |
FaceRedactorMode
Tento režim umožňuje zvolit mezi následujícími nastaveními: 1) Analyzovat – pouze pro detekci. Tento režim vygeneruje soubor JSON metadat označující vzhled tváří v celém videu. Pokud je to možné, přiřazuje se vzhledům stejné osoby stejné ID. 2) Kombinace – navíc rediguje (rozostřuje) rozpoznané tváře. 3) Redact – to umožňuje 2-pass proces, který umožňuje selektivní redakci podmnožina detekovaných tváří. Přebírá soubor metadat z předchozího předání analýzy spolu se zdrojovým videem a uživatelem vybranou podmnožinou ID, která vyžadují redigování.
Name | Typ | Description |
---|---|---|
Analyze |
string |
Režim analyzovat rozpozná tváře a vypíše soubor metadat s výsledky. Umožňuje úpravy souboru metadat před rozostřením tváří v režimu Redact. |
Combined |
string |
Kombinovaný režim provádí kroky Analyzovat a Redact najednou, když není žádoucí upravovat analyzované tváře. |
Redact |
string |
Režim redakce využívá soubor metadat z režimu analyzovat a rediguje nalezené tváře. |
Fade
Popisuje vlastnosti efektu Fade použitého na vstupní médium.
Name | Typ | Description |
---|---|---|
duration |
string |
The Duration of the fade effect in the video. Hodnota může být ve formátu ISO 8601 (například PT05S k vyblednutí barvy in/out během 5 sekund) nebo počet snímků (například 10 snímků od začátku) nebo relativní hodnota k době trvání streamu (například 10 %, aby zeslámlala 10 % doby trvání datového proudu). |
fadeColor |
string |
Barva pro slábnutí in/out. může být v barvách https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords CSS Level1 nebo v hodnotě RGB/hex: například rgb(255,0,0), 0xFF0000 nebo #FF0000 |
start |
string |
Pozice ve vstupním videu, odkud se má začít slábnout. Hodnota může být ve formátu ISO 8601 (například PT05S začínat na 5 sekundách) nebo počet snímků (například 10 pro začátek od 10. rámce) nebo relativní hodnota doby trvání datového proudu (například 10 % pro začátek na 10 % doby trvání datového proudu). Výchozí hodnota je 0. |
Filters
Popisuje všechny operace filtrování, jako je zrušení prokládání, otočení atd., které se mají použít na vstupní médium před kódováním.
Name | Typ | Description |
---|---|---|
crop |
Parametry obdélníkového okna, pomocí kterého chcete oříznout vstupní video. |
|
deinterlace |
Nastavení prokládání. |
|
fadeIn |
Popisuje vlastnosti efektu Fade použitého na vstupní médium. |
|
fadeOut |
Popisuje vlastnosti efektu Fade použitého na vstupní médium. |
|
overlays | Overlay[]: |
Vlastnosti překryvů, které se mají použít na vstupní video. Může se jednat o překryvy zvuku, obrázku nebo videa. |
rotation |
Případné otočení, které se má použít u vstupního videa před kódováním. Výchozí hodnota je Automaticky. |
H264Complexity
Říká kodéru, jak zvolit nastavení kódování. Výchozí hodnota je Vyvážená.
Name | Typ | Description |
---|---|---|
Balanced |
string |
Říká kodéru, aby používal nastavení, která zajistí rovnováhu mezi rychlostí a kvalitou. |
Quality |
string |
Říká kodéru, aby používal nastavení optimalizovaná pro vyšší kvalitu výstupu na úkor zpomalení celkového času kódování. |
Speed |
string |
Řekne kodéru, aby používal nastavení optimalizovaná pro rychlejší kódování. Kvalita se obětuje, aby se zkrátila doba kódování. |
H264Layer
Popisuje nastavení, která se mají použít při kódování vstupního videa do požadované výstupní vrstvy přenosové rychlosti pomocí kodeku videa H.264.
Name | Typ | Description |
---|---|---|
adaptiveBFrame |
boolean |
Určuje, jestli se při kódování této vrstvy mají použít adaptivní rámce B. Pokud ho nezadáte, kodér ho zapne vždy, když profil videa povolí jeho použití. |
bFrames |
integer |
Počet snímků B, které se mají použít při kódování této vrstvy. Pokud není zadaný, kodér zvolí odpovídající číslo na základě profilu a úrovně videa. |
bitrate |
integer |
Průměrná přenosová rychlost v bitech za sekundu, při které se má při generování této vrstvy zakódovat vstupní video. Toto je povinné pole. |
bufferWindow |
string |
Délka okna vyrovnávací paměti VBV. Hodnota by měla být ve formátu ISO 8601. Hodnota by měla být v rozsahu [0,1–100] sekund. Výchozí hodnota je 5 sekund (například PT5S). |
crf |
number |
Hodnota CRF, která se má použít při kódování této vrstvy. Toto nastavení se projeví, když je rateControlMode video kodeku nastaven v režimu CRF. Rozsah hodnot CRF je v rozmezí od 0 do 51, přičemž nižší hodnoty by můžou vést k lepší kvalitě na úkor větších velikostí souborů. Vyšší hodnoty znamenají větší kompresi, ale v určitém okamžiku si všimnete snížení kvality. Výchozí hodnota je 23. |
entropyMode |
Režim entropie, který se má použít pro tuto vrstvu. Pokud není zadán, kodér zvolí režim, který je vhodný pro profil a úroveň. |
|
frameRate |
string |
Snímková frekvence (v snímcích za sekundu), při které se má tato vrstva zakódovat. Hodnota může být ve tvaru M/N, kde M a N jsou celá čísla (například 30000/1001), nebo ve formě čísla (například 30 nebo 29,97). Kodér vynucuje omezení povolené snímkové frekvence na základě profilu a úrovně. Pokud není zadaný, kodér použije stejnou snímkovou frekvenci jako vstupní video. |
height |
string |
Výška výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má o polovinu tolik pixelů na výšku než vstup. |
label |
string |
Alfanumerický popisek této vrstvy, který lze použít při multiplexování různých vrstev videa a zvuku nebo při pojmenování výstupního souboru. |
level |
string |
V současné době podporujeme úroveň až 6.2. Hodnota může být Auto nebo číslo, které odpovídá profilu H.264. Pokud není zadáno, výchozí hodnota je Automaticky, což kodéru umožňuje zvolit úroveň, která je pro tuto vrstvu vhodná. |
maxBitrate |
integer |
Maximální přenosová rychlost (v bitech za sekundu), při které se předpokládá, že se vyrovnávací paměť VBV doplní. Pokud není zadaný, má výchozí hodnotu stejnou hodnotu jako přenosová rychlost. |
profile |
V současné době podporujeme Směrný plán, Hlavní, Vysoké, High422, High444. Výchozí hodnota je Automaticky. |
|
referenceFrames |
integer |
Počet referenčních rámců, které se mají použít při kódování této vrstvy. Pokud není zadán, kodér určí odpovídající číslo na základě nastavení složitosti kodéru. |
slices |
integer |
Počet řezů, které se mají použít při kódování této vrstvy. Pokud není zadán, výchozí hodnota je nula, což znamená, že kodér použije pro každý snímek jeden řez. |
width |
string |
Šířka výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má poloviční šířku než vstup. |
H264RateControlMode
Režim řízení rychlosti videa
Name | Typ | Description |
---|---|---|
ABR |
string |
Režim ABR (Average Bitrate), který dosáhne cílové přenosové rychlosti: Výchozí režim. |
CBR |
string |
Režim CBR (Constant Bitrate), který zpřísňuje varianty přenosové rychlosti kolem cílové přenosové rychlosti. |
CRF |
string |
Režim CRF (Constant Rate Factor), který cílí na konstantní subjektivní kvalitu. |
H264Video
Popisuje všechny vlastnosti kódování videa pomocí kodeku H.264.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
complexity |
Říká kodéru, jak má zvolit nastavení kódování. Výchozí hodnota je Vyvážené. |
|
keyFrameInterval |
string |
Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadaném ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení se ignoruje, pokud je nastavená hodnota VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat po nastavení vstupního zdroje. |
label |
string |
Volitelný popisek kodeku Popisek se dá použít k řízení chování při muxingu. |
layers |
Kolekce výstupních vrstev H.264 produkovaných kodérem. |
|
rateControlMode |
Režim řízení rychlosti videa |
|
sceneChangeDetection |
boolean |
Určuje, zda má kodér při změnách scény vkládat klíčové snímky. Pokud není zadaný, výchozí hodnota je false. Tento příznak by měl být nastavený na hodnotu true pouze v případě, že kodér konfiguruje vytvoření jednoho výstupního videa. |
stretchMode |
Režim změny velikosti – změna velikosti vstupního videa tak, aby odpovídala požadovaným výstupním rozlišením. Výchozí nastavení je automatické nastavení velikosti. |
|
syncMode |
Režim synchronizace videa |
H264VideoProfile
V současné době podporujeme Směrný plán, Hlavní, Vysoké, High422, High444. Výchozí hodnota je Automaticky.
Name | Typ | Description |
---|---|---|
Auto |
string |
Sděluje kodéru, aby automaticky určil příslušný profil H.264. |
Baseline |
string |
Základní profil |
High |
string |
Vysoký profil. |
High422 |
string |
Vysoký profil 4:2:2. |
High444 |
string |
Vysoký prediktivní profil 4:4:4. |
Main |
string |
Hlavní profil |
H265Complexity
Říká kodéru, jak má zvolit nastavení kódování. Kvalita zajistí vyšší kompresní poměr, ale s vyššími náklady a delším výpočetním časem. Rychlost vytvoří relativně větší soubor, ale je rychlejší a úspornější. Výchozí hodnota je Vyvážené.
Name | Typ | Description |
---|---|---|
Balanced |
string |
Říká kodéru, aby použil nastavení, která zajistí rovnováhu mezi rychlostí a kvalitou. |
Quality |
string |
Říká kodéru, aby použil nastavení, která jsou optimalizovaná tak, aby vytvářela vyšší kvalitu výstupu za cenu pomalejšího celkového kódování. |
Speed |
string |
Říká kodéru, aby použil nastavení optimalizovaná pro rychlejší kódování. Kvalita se obětuje, aby se zkrátila doba kódování. |
H265Layer
Popisuje nastavení, která se mají použít při kódování vstupního videa do požadované vrstvy výstupní přenosové rychlosti pomocí video kodeku H.265.
Name | Typ | Description |
---|---|---|
adaptiveBFrame |
boolean |
Určuje, zda se při kódování této vrstvy mají použít adaptivní rámce B. Pokud ho nezadáte, kodér ho zapne vždy, když profil videa povolí jeho použití. |
bFrames |
integer |
Počet snímků B, které se mají použít při kódování této vrstvy. Pokud není zadaný, kodér zvolí odpovídající číslo na základě profilu a úrovně videa. |
bitrate |
integer |
Průměrná přenosová rychlost v bitech za sekundu, při které se má při generování této vrstvy zakódovat vstupní video. Například cílová přenosová rychlost 3000 Kbps nebo 3 Mbps znamená, že tato hodnota by měla být 3000000 Toto pole je povinné. |
bufferWindow |
string |
Délka okna vyrovnávací paměti VBV. Hodnota by měla být ve formátu ISO 8601. Hodnota by měla být v rozsahu [0,1–100] sekund. Výchozí hodnota je 5 sekund (například PT5S). |
crf |
number |
Hodnota CRF, která se má použít při kódování této vrstvy. Toto nastavení se projeví, když je rateControlMode video kodeku nastaven v režimu CRF. Rozsah hodnot CRF je v rozmezí od 0 do 51, přičemž nižší hodnoty by můžou vést k lepší kvalitě na úkor větších velikostí souborů. Vyšší hodnoty znamenají větší kompresi, ale v určitém okamžiku si všimnete snížení kvality. Výchozí hodnota je 28. |
frameRate |
string |
Snímková frekvence (v snímcích za sekundu), při které se má tato vrstva zakódovat. Hodnota může být ve tvaru M/N, kde M a N jsou celá čísla (například 30000/1001), nebo ve formě čísla (například 30 nebo 29,97). Kodér vynucuje omezení povolené snímkové frekvence na základě profilu a úrovně. Pokud není zadaný, kodér použije stejnou snímkovou frekvenci jako vstupní video. |
height |
string |
Výška výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má o polovinu tolik pixelů na výšku než vstup. |
label |
string |
Alfanumerický popisek této vrstvy, který lze použít při multiplexování různých vrstev videa a zvuku nebo při pojmenování výstupního souboru. |
level |
string |
V současné době podporujeme úroveň až 6.2. Hodnota může být Auto nebo číslo, které odpovídá profilu H.265. Pokud není zadáno, výchozí hodnota je Automaticky, což kodéru umožňuje zvolit úroveň, která je pro tuto vrstvu vhodná. |
maxBitrate |
integer |
Maximální přenosová rychlost (v bitech za sekundu), při které se předpokládá, že se vyrovnávací paměť VBV doplní. Pokud není zadaný, má výchozí hodnotu stejnou hodnotu jako přenosová rychlost. |
profile |
V současné době podporujeme Main. Výchozí hodnota je Automaticky. |
|
referenceFrames |
integer |
Počet referenčních rámců, které se mají použít při kódování této vrstvy. Pokud není zadán, kodér určí odpovídající číslo na základě nastavení složitosti kodéru. |
slices |
integer |
Počet řezů, které se mají použít při kódování této vrstvy. Pokud není zadán, výchozí hodnota je nula, což znamená, že kodér použije pro každý snímek jeden řez. |
width |
string |
Šířka výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má poloviční šířku než vstup. |
H265Video
Popisuje všechny vlastnosti kódování videa pomocí kodeku H.265.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
complexity |
Říká kodéru, jak zvolit nastavení kódování. Kvalita zajistí vyšší kompresní poměr, ale s vyššími náklady a delší výpočetní dobu. Rychlost vytvoří relativně větší soubor, ale je rychlejší a úspornější. Výchozí hodnota je Vyvážená. |
|
keyFrameInterval |
string |
Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadanou ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení je ignorováno, pokud je nastaven VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat podle nastavení vstupního zdroje. |
label |
string |
Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu. |
layers |
Kolekce výstupních vrstev H.265, které má kodér vytvořit. |
|
sceneChangeDetection |
boolean |
Určuje, zda má kodér vložit klíčové snímky při změnách scény. Pokud není zadán, výchozí hodnota je false. Tento příznak by měl být nastaven na hodnotu true pouze v případě, že je kodér nakonfigurován tak, aby vytvořil jedno výstupní video. |
stretchMode |
Režim změny velikosti – jak se změní velikost vstupního videa tak, aby odpovídala požadovaným výstupním rozlišením. Výchozí hodnota je Automatické nastavení velikosti. |
|
syncMode |
Režim synchronizace videa |
H265VideoProfile
V současné době podporujeme Main. Výchozí hodnota je Automaticky.
Name | Typ | Description |
---|---|---|
Auto |
string |
Řekne kodéru, aby automaticky určil příslušný profil H.265. |
Main |
string |
Hlavní profil (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier) |
Main10 |
string |
Hlavní profil 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10) |
Image
Popisuje základní vlastnosti pro generování miniatur ze vstupního videa.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
keyFrameInterval |
string |
Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadaném ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení se ignoruje, pokud je nastavená hodnota VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat po nastavení vstupního zdroje. |
label |
string |
Volitelný popisek kodeku Popisek se dá použít k řízení chování při muxingu. |
range |
string |
Pozice vzhledem k přednastavené počáteční čas transformace ve vstupním videu, ve kterém se má zastavit generování miniatur. Hodnota může být ve formátu ISO 8601 (například PT5M30S zastavit v 5 minutách a 30 sekundách od času spuštění) nebo počet snímků (například 300, pokud se zastaví na 300. snímku od snímku při spuštění. Pokud je tato hodnota 1, znamená to pouze vytvoření jedné miniatury při spuštění) nebo relativní hodnotu k době trvání datového proudu (například 50 %, pokud se zastaví na polovině doby trvání datového proudu od času zahájení). Výchozí hodnota je 100 %, což znamená zastavit na konci datového proudu. |
start |
string |
Pozice ve vstupním videu, odkud se mají začít generovat miniatury. Hodnota může být ve formátu ISO 8601 (například PT05S začíná po 5 sekundách) nebo počet snímků (například 10 pro začátek od 10. snímku) nebo relativní hodnota k době trvání datového proudu (například 10 %, pokud začne na 10 % doby trvání datového proudu). Podporuje také makro {Best}, které kodéru říká, že má vybrat nejlepší miniaturu během prvních několika sekund videa, a vytvoří pouze jednu miniaturu bez ohledu na to, jaká další nastavení jsou pro krok a rozsah. Výchozí hodnota je makro {Best}. |
step |
string |
Intervaly, ve kterých se generují miniatury. Hodnota může být ve formátu ISO 8601 (například PT05S pro jeden obrázek každých 5 sekund) nebo počet snímků (například 30 pro jeden obrázek každých 30 snímků) nebo relativní hodnota k době trvání datového proudu (například 10 % pro jeden obrázek každých 10 % doby trvání datového proudu). Poznámka: Hodnota kroku bude mít vliv na první vygenerovanou miniaturu, což nemusí být přesně ta, která byla zadána v přednastavené době zahájení transformace. Důvodem je kodér, který se snaží vybrat nejlepší miniaturu mezi časem zahájení a umístěním kroku z času spuštění jako první výstup. Vzhledem k tomu, že výchozí hodnota je 10 %, znamená to, že pokud má stream dlouhou dobu trvání, první vygenerovaná miniatura může být daleko od miniatury zadané při spuštění. Zkuste vybrat přiměřenou hodnotu kroku, pokud se očekává, že se první miniatura blíží času zahájení, nebo nastavte hodnotu Rozsah na 1, pokud je v čase spuštění potřeba jenom jedna miniatura. |
stretchMode |
Režim změny velikosti – změna velikosti vstupního videa tak, aby odpovídala požadovaným výstupním rozlišením. Výchozí nastavení je automatické nastavení velikosti. |
|
syncMode |
Režim synchronizace videa |
ImageFormat
Popisuje vlastnosti výstupního souboru obrázku.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
filenamePattern |
string |
Vzor pojmenování souborů použitý k vytvoření výstupních souborů. V názvu souboru jsou podporována následující makra: {Basename} – rozšiřující makro, které bude používat název vstupního videosouboru. Pokud je základní název (přípona souboru není zahrnuta) vstupního videosouboru kratší než 32 znaků, použije se základní název vstupních videosouborů. Pokud délka základního názvu vstupního videosouboru překročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru. |
InsightsType
Definuje typ přehledů, které má služba generovat. Povolené hodnoty jsou AudioInsightsOnly, VideoInsightsOnly a AllInsights. Výchozí hodnota je AllInsights. Pokud tuto možnost nastavíte na AllInsights a vstup bude jenom zvuk, vygenerují se jenom zvukové přehledy. Podobně pokud je vstupem jenom video, vygenerují se jenom přehledy videa. Doporučujeme nepoužívat AudioInsightsOnly, pokud očekáváte, že některé vaše vstupy budou pouze video; nebo použijte VideoInsightsOnly, pokud očekáváte, že některé vstupy budou jenom zvukové. Vaše úlohy v takových podmínkách by došlo k chybě.
Name | Typ | Description |
---|---|---|
AllInsights |
string |
Vygenerujte přehledy zvuku i videa. Selže, pokud se nezdaří přehledy zvuku nebo videa. |
AudioInsightsOnly |
string |
Generování pouze zvukových přehledů Ignorovat video, i když je k dispozici. Pokud není k dispozici žádný zvuk, selže. |
VideoInsightsOnly |
string |
Vygenerujte pouze přehledy videa. Ignorovat zvuk, pokud je k dispozici. Pokud není k dispozici žádné video, selže. |
InterleaveOutput
Nastaví režim prokládání výstupu tak, aby se ovládl způsob ukládání zvuku a videa ve formátu kontejneru. Příklad: Nastavte InterleavedOutput jako NonInterleavedOutput, aby se v samostatných souborech MP4 vytvářely výstupy jen pro zvuk a video.
Name | Typ | Description |
---|---|---|
InterleavedOutput |
string |
Výstup zahrnuje zvuk i video. |
NonInterleavedOutput |
string |
Výstup je jenom video nebo jenom zvuk. |
JpgFormat
Popisuje nastavení pro vytváření miniatur JPEG.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
filenamePattern |
string |
Vzor pojmenování souborů použitý k vytvoření výstupních souborů. V názvu souboru jsou podporována následující makra: {Basename} – rozšiřující makro, které bude používat název vstupního videosouboru. Pokud je základní název (přípona souboru není zahrnuta) vstupního videosouboru kratší než 32 znaků, použije se základní název vstupních videosouborů. Pokud délka základního názvu vstupního videosouboru překročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru. |
JpgImage
Popisuje vlastnosti pro vytvoření řady obrázků JPEG ze vstupního videa.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
keyFrameInterval |
string |
Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadaném ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení se ignoruje, pokud je nastavená hodnota VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat po nastavení vstupního zdroje. |
label |
string |
Volitelný popisek kodeku Popisek se dá použít k řízení chování při muxingu. |
layers |
Jpg |
Kolekce výstupních vrstev obrázků JPEG, které budou vytvořeny kodérem. |
range |
string |
Pozice vzhledem k přednastavené počáteční čas transformace ve vstupním videu, ve kterém se má zastavit generování miniatur. Hodnota může být ve formátu ISO 8601 (například PT5M30S zastavit v 5 minutách a 30 sekundách od času spuštění) nebo počet snímků (například 300, pokud se zastaví na 300. snímku od snímku při spuštění. Pokud je tato hodnota 1, znamená to pouze vytvoření jedné miniatury při spuštění) nebo relativní hodnotu k době trvání datového proudu (například 50 %, pokud se zastaví na polovině doby trvání datového proudu od času zahájení). Výchozí hodnota je 100 %, což znamená zastavit na konci datového proudu. |
spriteColumn |
integer |
Nastaví počet sloupců použitých v obrázku miniatury spritu. Počet řádků se vypočítá automaticky a vygeneruje se soubor VTT s mapováním souřadnic pro každou miniaturu v spritu. Poznámka: Tato hodnota by měla být kladné celé číslo a doporučuje se správná hodnota, aby rozlišení výstupního obrázku nepřesáhla limit maximálního rozlišení pixelů JPEG 65535 × 65535. |
start |
string |
Pozice ve vstupním videu, odkud se mají začít generovat miniatury. Hodnota může být ve formátu ISO 8601 (například PT05S začíná po 5 sekundách) nebo počet snímků (například 10 pro začátek od 10. snímku) nebo relativní hodnota k době trvání datového proudu (například 10 %, pokud začne na 10 % doby trvání datového proudu). Podporuje také makro {Best}, které kodéru říká, že má vybrat nejlepší miniaturu během prvních několika sekund videa, a vytvoří pouze jednu miniaturu bez ohledu na to, jaká další nastavení jsou pro krok a rozsah. Výchozí hodnota je makro {Best}. |
step |
string |
Intervaly, ve kterých se generují miniatury. Hodnota může být ve formátu ISO 8601 (například PT05S pro jeden obrázek každých 5 sekund) nebo počet snímků (například 30 pro jeden obrázek každých 30 snímků) nebo relativní hodnota k době trvání datového proudu (například 10 % pro jeden obrázek každých 10 % doby trvání datového proudu). Poznámka: Hodnota kroku bude mít vliv na první vygenerovanou miniaturu, což nemusí být přesně ta, která byla zadána v přednastavené době zahájení transformace. Důvodem je kodér, který se snaží vybrat nejlepší miniaturu mezi časem zahájení a umístěním kroku z času spuštění jako první výstup. Vzhledem k tomu, že výchozí hodnota je 10 %, znamená to, že pokud má stream dlouhou dobu trvání, první vygenerovaná miniatura může být daleko od miniatury zadané při spuštění. Zkuste vybrat přiměřenou hodnotu kroku, pokud se očekává, že se první miniatura blíží času zahájení, nebo nastavte hodnotu Rozsah na 1, pokud je v čase spuštění potřeba jenom jedna miniatura. |
stretchMode |
Režim změny velikosti – změna velikosti vstupního videa tak, aby odpovídala požadovaným výstupním rozlišením. Výchozí nastavení je automatické nastavení velikosti. |
|
syncMode |
Režim synchronizace videa |
JpgLayer
Popisuje nastavení pro vytvoření obrázku JPEG ze vstupního videa.
Name | Typ | Description |
---|---|---|
height |
string |
Výška výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má o polovinu tolik pixelů na výšku než vstup. |
label |
string |
Alfanumerický popisek této vrstvy, který lze použít při multiplexování různých vrstev videa a zvuku nebo při pojmenování výstupního souboru. |
quality |
integer |
Kvalita komprese výstupu JPEG. Rozsah je od 0 do 100 a výchozí hodnota je 70. |
width |
string |
Šířka výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má poloviční šířku než vstup. |
Mp4Format
Popisuje vlastnosti výstupního souboru ISO MP4.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
filenamePattern |
string |
Vzor pojmenování souborů použitý k vytvoření výstupních souborů. V názvu souboru jsou podporována následující makra: {Basename} – rozšiřující makro, které bude používat název vstupního videosouboru. Pokud je základní název (přípona souboru není zahrnuta) vstupního videosouboru kratší než 32 znaků, použije se základní název vstupních videosouborů. Pokud délka základního názvu vstupního videosouboru překročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru. |
outputFiles |
Seznam výstupních souborů, které se mají vytvořit. Každá položka v seznamu je sada popisků vrstvy zvuku a videa, které se mají spojit dohromady . |
MultiBitrateFormat
Popisuje vlastnosti pro vytvoření kolekce gop zarovnané souborů s více přenosovými rychlostmi. Výchozím chováním je vytvoření jednoho výstupního souboru pro každou vrstvu videa, která se směšuje se všemi zvuky. Přesné výstupní soubory lze řídit zadáním outputFiles kolekce.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
filenamePattern |
string |
Vzor pojmenování souborů použitý k vytvoření výstupních souborů. V názvu souboru jsou podporována následující makra: {Basename} – rozšiřující makro, které bude používat název vstupního videosouboru. Pokud je základní název (přípona souboru není zahrnuta) vstupního videosouboru kratší než 32 znaků, použije se základní název vstupních videosouborů. Pokud délka základního názvu vstupního videosouboru překročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru. |
outputFiles |
Seznam výstupních souborů, které se mají vytvořit. Každá položka v seznamu je sada popisků vrstvy zvuku a videa, které se mají spojit dohromady . |
OnErrorType
Transformace může definovat více než jeden výstup. Tato vlastnost definuje, co má služba dělat, když jeden výstup selže – buď pokračovat ve vytváření dalších výstupů, nebo zastavit ostatní výstupy. Celkový stav úlohy nebude odrážet selhání výstupů zadaných pomocí continuejob. Výchozí hodnota je StopProcessingJob.
Name | Typ | Description |
---|---|---|
ContinueJob |
string |
Sděluje službě, že pokud tento objekt TransformOutput selže, povolí pokračování jakéhokoli jiného objektu TransformOutput. |
StopProcessingJob |
string |
Sděluje službě, že pokud tento objekt TransformOutput selže, je možné zastavit všechny ostatní neúplné objekty TransformOutput. |
OutputFile
Představuje vytvořený výstupní soubor.
Name | Typ | Description |
---|---|---|
labels |
string[] |
Seznam popisků, které popisují, jak má kodér multiplexovat video a zvuk do výstupního souboru. Pokud kodér například vytváří dvě vrstvy videa s popisky v1 a v2 a jednu zvukovou vrstvu s popiskem a1, pak pole jako [v1, a1] řekne kodéru, aby vytvořil výstupní soubor se stopou videa reprezentovanou v1 a zvukovou stopou reprezentovanou a1. |
PngFormat
Popisuje nastavení pro vytváření miniatur PNG.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
filenamePattern |
string |
Vzor pojmenování souborů použitý k vytvoření výstupních souborů. V názvu souboru jsou podporována následující makra: {Basename} – rozšiřující makro, které bude používat název vstupního videosouboru. Pokud je základní název (přípona souboru není zahrnuta) vstupního videosouboru kratší než 32 znaků, použije se základní název vstupních videosouborů. Pokud délka základního názvu vstupního videosouboru překročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru. |
PngImage
Popisuje vlastnosti pro vytvoření řady obrázků PNG ze vstupního videa.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
keyFrameInterval |
string |
Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadaném ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení se ignoruje, pokud je nastavená hodnota VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat po nastavení vstupního zdroje. |
label |
string |
Volitelný popisek kodeku Popisek se dá použít k řízení chování při muxingu. |
layers |
Png |
Kolekce výstupních vrstev obrázků PNG, které budou vytvořeny kodérem. |
range |
string |
Pozice vzhledem k přednastavené počáteční čas transformace ve vstupním videu, ve kterém se má zastavit generování miniatur. Hodnota může být ve formátu ISO 8601 (například PT5M30S zastavit v 5 minutách a 30 sekundách od času spuštění) nebo počet snímků (například 300, pokud se zastaví na 300. snímku od snímku při spuštění. Pokud je tato hodnota 1, znamená to pouze vytvoření jedné miniatury při spuštění) nebo relativní hodnotu k době trvání datového proudu (například 50 %, pokud se zastaví na polovině doby trvání datového proudu od času zahájení). Výchozí hodnota je 100 %, což znamená zastavit na konci datového proudu. |
start |
string |
Pozice ve vstupním videu, odkud se mají začít generovat miniatury. Hodnota může být ve formátu ISO 8601 (například PT05S začíná po 5 sekundách) nebo počet snímků (například 10 pro začátek od 10. snímku) nebo relativní hodnota k době trvání datového proudu (například 10 %, pokud začne na 10 % doby trvání datového proudu). Podporuje také makro {Best}, které kodéru říká, že má vybrat nejlepší miniaturu během prvních několika sekund videa, a vytvoří pouze jednu miniaturu bez ohledu na to, jaká další nastavení jsou pro krok a rozsah. Výchozí hodnota je makro {Best}. |
step |
string |
Intervaly, ve kterých se generují miniatury. Hodnota může být ve formátu ISO 8601 (například PT05S pro jeden obrázek každých 5 sekund) nebo počet snímků (například 30 pro jeden obrázek každých 30 snímků) nebo relativní hodnota k době trvání datového proudu (například 10 % pro jeden obrázek každých 10 % doby trvání datového proudu). Poznámka: Hodnota kroku bude mít vliv na první vygenerovanou miniaturu, což nemusí být přesně ta, která byla zadána v přednastavené době zahájení transformace. Důvodem je kodér, který se snaží vybrat nejlepší miniaturu mezi časem zahájení a umístěním kroku z času spuštění jako první výstup. Vzhledem k tomu, že výchozí hodnota je 10 %, znamená to, že pokud má stream dlouhou dobu trvání, první vygenerovaná miniatura může být daleko od miniatury zadané při spuštění. Zkuste vybrat přiměřenou hodnotu kroku, pokud se očekává, že se první miniatura blíží času zahájení, nebo nastavte hodnotu Rozsah na 1, pokud je v čase spuštění potřeba jenom jedna miniatura. |
stretchMode |
Režim změny velikosti – změna velikosti vstupního videa tak, aby odpovídala požadovaným výstupním rozlišením. Výchozí nastavení je automatické nastavení velikosti. |
|
syncMode |
Režim synchronizace videa |
PngLayer
Popisuje nastavení pro vytvoření obrázku PNG ze vstupního videa.
Name | Typ | Description |
---|---|---|
height |
string |
Výška výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má o polovinu tolik pixelů na výšku než vstup. |
label |
string |
Alfanumerický popisek této vrstvy, který lze použít při multiplexování různých vrstev videa a zvuku nebo při pojmenování výstupního souboru. |
width |
string |
Šířka výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má poloviční šířku než vstup. |
PresetConfigurations
Objekt s volitelným nastavením konfigurace kodéru.
Name | Typ | Description |
---|---|---|
complexity |
Umožňuje nakonfigurovat nastavení kodéru pro řízení rovnováhy mezi rychlostí a kvalitou. Příklad: Pro rychlejší kódování, ale nižší efektivitu komprese nastavíte jako Rychlost. |
|
interleaveOutput |
Nastaví režim prokládání výstupu tak, aby se ovládl způsob ukládání zvuku a videa ve formátu kontejneru. Příklad: Nastavte InterleavedOutput jako NonInterleavedOutput, aby se v samostatných souborech MP4 vytvářely výstupy jen pro zvuk a video. |
|
keyFrameIntervalInSeconds |
number |
Interval klíčového snímku v sekundách. Příklad: Nastavte KeyFrameIntervalInSeconds na hodnotu 2, abyste snížili ukládání do vyrovnávací paměti pro některé přehrávače. |
maxBitrateBps |
integer |
Maximální přenosová rychlost v bitech za sekundu (prahová hodnota pro horní vrstvu videa). Příklad: Nastavte MaxBitrateBps na hodnotu 6000000, abyste se vyhnuli vytváření výstupů s velmi vysokou přenosovou rychlostí pro obsah s vysokou složitostí. |
maxHeight |
integer |
Maximální výška výstupních vrstev videa. Příklad: Nastavte MaxHeight na hodnotu 720, abyste vytvořili výstupní vrstvy až do 720P, i když je vstup 4K. |
maxLayers |
integer |
Maximální počet výstupních vrstev videa. Příklad: Nastavte MaxLayers jako 4, abyste zajistili, že se vytvoří maximálně 4 výstupní vrstvy, které budou řídit celkové náklady na úlohu kódování. |
minBitrateBps |
integer |
Minimální přenosová rychlost v bitech za sekundu (prahová hodnota pro dolní vrstvu videa). Příklad: Nastavte MinBitrateBps na hodnotu 200000 tak, aby měla spodní vrstvu, která pokrývá uživatele s nízkou šířkou pásma sítě. |
minHeight |
integer |
Minimální výška výstupních vrstev videa. Příklad: Nastavte MinHeight na 360, abyste se vyhnuli výstupním vrstvám s menším rozlišením, jako je 180P. |
Priority
Nastaví relativní prioritu TransformOutputs v rámci transformace. Tím se nastaví priorita, kterou služba používá ke zpracování TransformOutputs. Výchozí priorita je Normální.
Name | Typ | Description |
---|---|---|
High |
string |
Používá se pro transformoutputy, které by měly mít přednost před ostatními. |
Low |
string |
Používá se pro TransformOutputs, které lze generovat po normální a vysoké prioritě TransformOutputs. |
Normal |
string |
Používá se pro transformoutputy, které lze generovat s normální prioritou. |
Rectangle
Popisuje vlastnosti obdélníkového okna použitého na vstupní médium před jeho zpracováním.
Name | Typ | Description |
---|---|---|
height |
string |
Výška obdélníkové oblasti v pixelech Může to být absolutní hodnota pixelů (např. 100) nebo relativní vzhledem k velikosti videa (například 50 %). |
left |
string |
Počet pixelů od levého okraje Může to být absolutní hodnota pixelů (např. 100) nebo relativní vzhledem k velikosti videa (například 50 %). |
top |
string |
Počet pixelů od horního okraje. Může to být absolutní hodnota pixelů (např. 100) nebo relativní vzhledem k velikosti videa (například 50 %). |
width |
string |
Šířka obdélníkové oblasti v pixelech. Může to být absolutní hodnota pixelů (např. 100) nebo relativní vzhledem k velikosti videa (například 50 %). |
Rotation
Případné otočení, které se má použít u vstupního videa před kódováním. Výchozí hodnota je Automaticky.
Name | Typ | Description |
---|---|---|
Auto |
string |
Automaticky zjišťovat a otáčet podle potřeby. |
None |
string |
Video neotáčíte. Pokud to výstupní formát podporuje, všechna metadata o rotaci zůstanou beze změny. |
Rotate0 |
string |
Neobměňujte video, ale odeberte všechna metadata o otáčení. |
Rotate180 |
string |
Otočte o 180 stupňů po směru hodinových ručiček. |
Rotate270 |
string |
Otočte o 270 stupňů po směru hodinových ručiček. |
Rotate90 |
string |
Otočte o 90 stupňů po směru hodinových ručiček. |
StandardEncoderPreset
Popisuje všechna nastavení, která se mají použít při kódování vstupního videa pomocí standardního kodéru.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
codecs | Codec[]: |
Seznam kodeků, které se mají použít při kódování vstupního videa. |
experimentalOptions |
object |
Slovník obsahující páry hodnot klíčů pro parametry, které nejsou zpřístupněny v samotné předvolbě |
filters |
Jedna nebo více operací filtrování, které jsou použity na vstupní médium před kódováním. |
|
formats | Format[]: |
Seznam výstupů, které má kodér vytvořit. |
StretchMode
Režim změny velikosti – změna velikosti vstupního videa tak, aby odpovídala požadovaným výstupním rozlišením. Výchozí nastavení je automatické nastavení velikosti.
Name | Typ | Description |
---|---|---|
AutoFit |
string |
Vložte výstup (pomocí pole letterbox nebo pillar box) a respektujte rozlišení výstupu a zároveň se ujistěte, že aktivní oblast videa ve výstupu má stejný poměr stran jako vstup. Pokud je například vstup 1920 × 1080 a předvolba kódování požaduje 1280 × 1280 , výstup bude ve formátu 1280 × 1280, který obsahuje vnitřní obdélník 1280 × 720 v poměru stran 16:9 a oblasti polí sloupků o šířce 280 pixelů vlevo a vpravo. |
AutoSize |
string |
Přepište rozlišení výstupu a změňte ho tak, aby odpovídalo poměru stran zobrazení vstupu bez odsazení. Pokud je například vstup 1920 × 1080 a předvolba kódování požaduje 1280 × 1280 , pak se hodnota v předvolbě přepíše a výstup bude na hodnotě 1280x720, což zachovává poměr stran vstupu 16:9. |
None |
string |
Striktně respektujte rozlišení výstupu bez ohledu na poměr stran pixelů nebo poměr stran zobrazení vstupního videa. |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC) |
createdBy |
string |
Identita, která vytvořila prostředek. |
createdByType |
Typ identity, která prostředek vytvořila. |
|
lastModifiedAt |
string |
Časové razítko poslední změny prostředku (UTC) |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |
Transform
Transformace zapouzdřuje pravidla nebo instrukce pro generování požadovaných výstupů ze vstupního média, například překódováním nebo extrahováním přehledů. Po vytvoření transformace se dá použít na vstupní médium vytvořením úloh.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku} |
name |
string |
Název prostředku |
properties.created |
string |
Datum a čas vytvoření transformace v UTC ve formátu RRRR-MM-DDThh:mm:ssZ. |
properties.description |
string |
Volitelný podrobný popis transformace. |
properties.lastModified |
string |
Datum a čas UTC, kdy byla transformace naposledy aktualizována, ve formátu "RRRR-MM-DDThh:mm:ssZ". |
properties.outputs |
Pole jednoho nebo více objektů TransformOutput, které má transformace vygenerovat. |
|
systemData |
Systémová metadata vztahující se k tomuto prostředku. |
|
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
TransformOutput
Popisuje vlastnosti TransformOutput, což jsou pravidla, která se mají použít při generování požadovaného výstupu.
Name | Typ | Description |
---|---|---|
onError |
Transformace může definovat více než jeden výstup. Tato vlastnost definuje, co má služba dělat, když jeden výstup selže – buď pokračovat ve vytváření dalších výstupů, nebo zastavit ostatní výstupy. Celkový stav úlohy nebude odrážet selhání výstupů zadaných pomocí continuejob. Výchozí hodnota je StopProcessingJob. |
|
preset | Preset: |
Předvolba, která popisuje operace, které se použijí k úpravě, překódování nebo extrahování přehledů ze zdrojového souboru za účelem vygenerování výstupu. |
relativePriority |
Nastaví relativní prioritu TransformOutputs v rámci transformace. Tím se nastaví priorita, kterou služba používá ke zpracování TransformOutputs. Výchozí priorita je Normální. |
TransportStreamFormat
Popisuje vlastnosti pro generování výstupních videosouborů přenosového proudu MPEG-2 (ISO/IEC 13818-1).
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
filenamePattern |
string |
Vzor pojmenování souborů použitý k vytvoření výstupních souborů. V názvu souboru jsou podporována následující makra: {Basename} – rozšiřující makro, které bude používat název vstupního videosouboru. Pokud je základní název (přípona souboru není zahrnuta) vstupního videosouboru kratší než 32 znaků, použije se základní název vstupních videosouborů. Pokud délka základního názvu vstupního videosouboru překročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru. |
outputFiles |
Seznam výstupních souborů, které se mají vytvořit. Každá položka v seznamu je sada popisků vrstvy zvuku a videa, které se mají spojit dohromady . |
Video
Popisuje základní vlastnosti kódování vstupního videa.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
keyFrameInterval |
string |
Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadanou ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení je ignorováno, pokud je nastaven VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat podle nastavení vstupního zdroje. |
label |
string |
Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu. |
stretchMode |
Režim změny velikosti – jak se změní velikost vstupního videa tak, aby odpovídala požadovaným výstupním rozlišením. Výchozí hodnota je Automatické nastavení velikosti. |
|
syncMode |
Režim synchronizace videa |
VideoAnalyzerPreset
Předvolba analyzátoru videa, která extrahuje přehledy (bohatá metadata) ze zvuku i videa a vypíše soubor formátu JSON.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
audioLanguage |
string |
Jazyk datové části zvuku ve vstupu ve formátu BCP-47 jazyka tag-region (např. en-US). Pokud znáte jazyk obsahu, doporučujeme ho zadat. Jazyk musí být určen explicitně pro AudioAnalysisMode::Basic, protože automatické rozpoznávání jazyka není součástí základního režimu. Pokud jazyk není zadaný nebo nastavený na hodnotu null, automatické rozpoznávání jazyka zvolí první zjištěný jazyk a zpracuje ho s vybraným jazykem po dobu trvání souboru. V současné době nepodporuje dynamické přepínání mezi jazyky po zjištění prvního jazyka. Automatická detekce funguje nejlépe se zvukovými nahrávkami s jasně rozpoznatelnou řečí. Pokud se automatickému zjišťování nepodaří jazyk najít, přepis se vrátí do en-US. Seznam podporovaných jazyků je k dispozici tady: https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
Slovník obsahující páry hodnot klíčů pro parametry, které nejsou vystaveny v samotné předvolbě |
insightsToExtract |
Definuje typ přehledů, které má služba generovat. Povolené hodnoty jsou AudioInsightsOnly, VideoInsightsOnly a AllInsights. Výchozí hodnota je AllInsights. Pokud tuto možnost nastavíte na AllInsights a vstup bude jenom zvuk, vygenerují se jenom přehledy zvuku. Podobně pokud je vstupem pouze video, pak se generují pouze přehledy videa. Doporučujeme nepoužívat AudioInsightsOnly, pokud očekáváte, že některé vstupy budou pouze video; nebo použijte VideoInsightsPokud očekáváte, že některé vstupy budou jenom zvukové. Vaše úlohy za takových podmínek by se zobrazily s chybou. |
|
mode |
Určuje sadu operací analýzy zvuku, které se mají provést. Pokud není zadáno, bude zvolena možnost Standard AudioAnalysisMode. |
VideoOverlay
Popisuje vlastnosti překryvného videa.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
audioGainLevel |
number |
Úroveň zesílení zvuku v překryvu. Hodnota by měla být v rozsahu [0, 1,0]. Výchozí hodnota je 1.0. |
cropRectangle |
Volitelné obdélníkové okno, které slouží k oříznutí překryvného obrázku nebo videa. |
|
end |
string |
Koncová pozice s odkazem na vstupní video, na kterém končí překryv. Hodnota by měla být ve formátu ISO 8601. Například PT30S, který ukončí překryv po 30 sekundách vstupního videa. Pokud není zadána hodnota nebo je hodnota větší než doba trvání vstupního videa, bude překrytí použito až do konce vstupního videa, pokud je doba trvání překryvného média větší než doba trvání vstupního videa, jinak překrytí potrvá stejně dlouho jako překryvné médium. |
fadeInDuration |
string |
Doba trvání, po kterou se překryvné zobrazení postupně slábne na vstupní video. Hodnota by měla být ve formátu doby trvání ISO 8601. Pokud není zadaný, výchozí chování je bez prolnutí (stejné jako PT0S). |
fadeOutDuration |
string |
Doba, po kterou překryv ze vstupního videa zmizí. Hodnota by měla být ve formátu doby trvání ISO 8601. Pokud není zadaný, výchozím chováním je bez prolnutí (stejné jako PT0S). |
inputLabel |
string |
Popisek vstupu úlohy, který se má použít jako překryv. Vstup musí obsahovat přesně jeden soubor. Můžete zadat soubor obrázku ve formátu JPG, PNG, GIF nebo BMP, zvukový soubor (například soubor WAV, MP3, WMA nebo M4A) nebo videosoubor. Úplný seznam podporovaných formátů zvukových souborů a videosouborů najdete v tématu https://aka.ms/mesformats . |
opacity |
number |
Neprůhlednost překryvu. Jedná se o hodnotu v rozsahu [0 – 1,0]. Výchozí hodnota je 1.0, což znamená, že překryv je neprůsprostý. |
position |
Umístění ve vstupním videu, kde se překryvný text používá. |
|
start |
string |
Počáteční pozice s odkazem na vstupní video, na kterém začíná překryv. Hodnota by měla být ve formátu ISO 8601. Například PT05S spustí překrytí po 5 sekundách vstupního videa. Pokud není zadaný, překryv se spustí od začátku vstupního videa. |
VideoSyncMode
Režim synchronizace videa
Name | Typ | Description |
---|---|---|
Auto |
string |
Toto je výchozí metoda. V závislosti na možnostech muxeru si vybírá mezi Cfr a Vfr. Pro výstupní formát MP4 je výchozím režimem Cfr. |
Cfr |
string |
Vstupní snímky se podle potřeby opakují nebo vyřadí, aby se dosáhlo přesně požadované konstantní obnovovací frekvence. Doporučuje se, pokud je výstupní snímková frekvence explicitně nastavená na zadanou hodnotu. |
Passthrough |
string |
Časová razítka prezentace na rámcích se předávají ze vstupního souboru do zapisovače výstupního souboru. Doporučuje se, když má vstupní zdroj proměnlivou obnovovací frekvenci a pokouší se ve výstupu vytvořit více vrstev pro adaptivní streamování, které mají zarovnané hranice GOP. Poznámka: Pokud mají dva nebo více snímků ve vstupu duplicitní časová razítka, bude mít výstup stejné chování. |
Vfr |
string |
Podobá se režimu předávání, ale pokud vstup obsahuje rámce s duplicitními časovými razítky, pak se výstupu předá jenom jeden snímek a ostatní se zahodí. Doporučuje se, pokud se očekává, že počet výstupních rámců bude roven počtu vstupních snímků. Výstup se například používá k výpočtu metriky kvality, jako je PSNR, se vstupem. |