Transforms - Get
Získat transformaci
Získá transformaci.
GET 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. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Podrobné informace o chybě |
Příklady
Get a Transform by name
Ukázkový požadavek
Ukázková odpověď
{
"name": "sampleTransform",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/sampleTransform",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:31.6281097Z",
"description": "A sample Transform using the Standard Encoder with a built in preset.",
"lastModified": "2022-10-17T23:14:31.6281097Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "Normal",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "H264MultipleBitrate1080p"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:31.6281097Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:31.6281097Z"
}
}
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, 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. |
Audio |
Definuje společné vlastnosti pro všechny zvukové kodeky. |
Audio |
Určuje sadu operací analýzy zvuku, které mají být provedeny. Pokud není zadán, 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: 32K/44.1K/48K Hz; Hodnoty přenosové rychlosti zvuku, které specifikace AC3 podporuje: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps. |
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 použije 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 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í. |
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 sladěných 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á je promíchaná společně se všemi zvuky. Přesné výstupní soubory lze řídit zadáním kolekce outputFiles. |
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 volitelného nastavení 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ů mpeg-2 Transport Stream (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ý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. |
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í v 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, 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.
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é mají být provedeny. Pokud není zadán, 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 zahrnuje 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 |
Black: Black out filter |
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ý: filtr rozostření krabicového vozu |
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: 32K/44.1K/48K Hz; Hodnoty přenosové rychlosti zvuku, které specifikace AC3 podporuje: 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. |
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. |
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 použije 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 |
Vytváří sadu souborů MP4 zarovnaných gop s videem H.264 a stereo zvukem AAC. Automaticky generuje žebřík přenosových rychlostí na základě vstupního rozlišení, přenosové rychlosti a snímkové frekvence. Automaticky generovaná předvolba nikdy nepřekročí rozlišení vstupu. Pokud je například vstup 720p, výstup zůstane v nejlepším případě 720p. |
ContentAwareEncoding |
string |
Vytvoří sadu mp4 zarovnaných s gop pomocí kódování s podporou obsahu. Na základě jakéhokoli vstupního obsahu služba provede počáteční zjednodušenou analýzu vstupního obsahu a na základě výsledků určí optimální počet vrstev, odpovídající nastavení přenosové rychlosti a rozlišení pro doručení pomocí adaptivního streamování. Tato předvolba je zvláště účinná pro videa s nízkou a střední složitostí, kde budou výstupní soubory s nižší přenosovou rychlostí, ale v kvalitě, která divákům stále poskytuje dobré prostředí. Výstup bude obsahovat soubory MP4 s prokládáním videa a zvuku. |
ContentAwareEncodingExperimental |
string |
Zpřístupňuje experimentální předvolbu pro kódování s podporou obsahu. Na základě jakéhokoli vstupního obsahu se služba pokusí automaticky určit optimální počet vrstev, nastavení odpovídající přenosové rychlosti a rozlišení pro doručování pomocí adaptivního streamování. 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 streamy videa a zvuku ze vstupního prostředku jako neprokládané video a výstupní zvukové soubory. Tuto předvolbu můžete použít k vystřihoávání existujícího prostředku nebo k převedení skupiny souborů MP4 zarovnaných s klíčovými snímky (GOP) na asset, 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 pomocí GOP v rozsahu od 6000 kb/s do 400 kb/s a stereofonního zvuku AAC. Řešení začíná na 1080p a klesne na 180p. |
H264MultipleBitrate720p |
string |
Vytvoří sadu 6 souborů MP4 zarovnaných přes GOP v rozsahu od 3400 kb/s do 400 kbps a stereofonního zvuku AAC. Rozlišení začíná na 720p a klesne na 180p. |
H264MultipleBitrateSD |
string |
Vytvoří sadu 5 souborů MP4 zarovnaných přes GOP 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ódované pomocí kodeku H.264 v rozlišení 6750 kb/s a výšky obrázku 1080 pixelů a stereofonní zvuk je kódovaný kodekem AAC-LC rychlostí 128 kb/s. |
H264SingleBitrate720p |
string |
Vytvoří soubor MP4, ve kterém je video kódované pomocí kodeku H.264 v rozlišení 4500 kb/s a výšky 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 zakódované pomocí kodeku H.264 s rychlostí 2200 kb/s a výšky obrázku 480 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s. |
H265AdaptiveStreaming |
string |
Vytváří sadu souborů MP4 zarovnaných gop s videem H.265 a stereo zvukem AAC. Automaticky generuje žebřík přenosových rychlostí na základě vstupního rozlišení, přenosové rychlosti a snímkové frekvence. Automaticky generovaná předvolba nikdy nepřekročí rozlišení vstupu. Pokud je například vstup 720p, výstup zůstane v nejlepším případě 720p. |
H265ContentAwareEncoding |
string |
Vytvoří sadu mp4 zarovnaných s gop pomocí kódování s podporou obsahu. Na základě jakéhokoli vstupního obsahu služba provede počáteční zjednodušenou analýzu vstupního obsahu a na základě výsledků určí optimální počet vrstev, odpovídající nastavení přenosové rychlosti a rozlišení pro doručení pomocí adaptivního streamování. Tato předvolba je zvláště účinná pro videa s nízkou a střední složitostí, kde budou výstupní soubory s nižší přenosovou rychlostí, ale v kvalitě, která divákům stále poskytuje dobré prostředí. 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ódované pomocí kodeku H.265 při 3500 kb/s a výšky obrázku 1080 pixelů a stereofonní zvuk je kódovaný kodekem AAC-LC ve formátu 128 kb/s. |
H265SingleBitrate4K |
string |
Vytvoří soubor MP4, ve kterém je video zakódované pomocí kodeku H.265 v rozlišení 9500 kb/s a výšky obrázku 2160 pixelů a stereofonní zvuk je kódovaný kodekem AAC-LC rychlostí 128 kb/s. |
H265SingleBitrate720p |
string |
Vytvoří soubor MP4, kde je video zakódované pomocí kodeku H.265 při 1800 kb/s a výšky obrázku 720 pixelů a stereofonní zvuk je kódovaný 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 |
Typ další informace. |
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 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í.
Name | Typ | Description |
---|---|---|
Analyze |
string |
Režim analýzy detekuje tváře a vypíše soubor metadat s výsledky. Umožňuje úpravy souboru metadat před rozostřením tváří v režimu redigování. |
Combined |
string |
Kombinovaný režim provádí kroky Analyzovat a Redigovat jedním průchodem, když není úprava analyzovaných tváří žádoucí. |
Redact |
string |
Režim redigování 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í de-interlacing. |
|
fadeIn |
Popisuje vlastnosti efektu Prolnutí použitého na vstupní médium. |
|
fadeOut |
Popisuje vlastnosti efektu Prolnutí použitého na vstupní médium. |
|
overlays | Overlay[]: |
Vlastnosti překryvů, které se mají použít u vstupního videa. Můžou to být překryvy zvuku, obrázku nebo videa. |
rotation |
Otočení, pokud existuje, které se použije u vstupního videa před jeho zakódování. Výchozí hodnota je Auto |
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 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 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.264, které mají být vytvořeny kodérem. |
|
rateControlMode |
Režim řízení rychlosti videa |
|
sceneChangeDetection |
boolean |
Zda má kodér vložit klíčové snímky při změně 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 |
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 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. |
range |
string |
Pozice vzhledem k času spuštění přednastavené transformace ve vstupním videu, na kterém se mají 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 počátečního času) nebo počet snímků (například 300 k zastavení na 300. snímku od rámce při zahájení. Pokud je tato hodnota 1, znamená to, že se při zahájení vytvoří jenom jedna miniatura) nebo relativní hodnota k době trvání streamu (například 50 % pro zastavení na polovinu doby trvání datového proudu od počátečního času). 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čí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). Podporuje také makro {Best}, které kodéru říká, že má vybrat nejlepší miniaturu z prvních několika sekund videa, a vytvoří pouze jednu miniaturu bez ohledu na to, jaká jsou další nastavení 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 doby 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 zadaná při počátečním čase přednastavení transformace. Důvodem je kodér, který se snaží vybrat nejlepší miniaturu mezi časem zahájení a umístěním kroku z počátečního času jako první výstup. Vzhledem k tomu, že výchozí hodnota je 10 %, znamená to, že pokud má stream dlouhou dobu trvání, může být první vygenerovaná miniatura vzdálená od miniatury zadané při spuštění. Zkuste vybrat přiměřenou hodnotu pro Krok, pokud se očekává, že se první miniatura blíží času zahájení, nebo nastavte hodnotu Rozsah na 1, pokud je v době zahájení potřeba pouze jedna miniatura. |
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 |
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řesahuje 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušné rozšíření pro tento formát. {Label} – popisek přiřazený kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začíná od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ kodeku pro zvuk/video. {Resolution} – rozlišení videa. Všechna nesubstituovaná 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řesahuje 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušné rozšíření pro tento formát. {Label} – popisek přiřazený kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začíná od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ kodeku pro zvuk/video. {Resolution} – rozlišení videa. Všechna nesubstituovaná 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 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 |
Jpg |
Kolekce výstupních vrstev obrázků JPEG, které mají být vytvořeny kodérem. |
range |
string |
Pozice vzhledem k času spuštění přednastavené transformace ve vstupním videu, na kterém se mají 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 počátečního času) nebo počet snímků (například 300 k zastavení na 300. snímku od rámce při zahájení. Pokud je tato hodnota 1, znamená to, že se při zahájení vytvoří jenom jedna miniatura) nebo relativní hodnota k době trvání streamu (například 50 % pro zastavení na polovinu doby trvání datového proudu od počátečního času). 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 sprite miniatury. 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 65535x65535. |
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čí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). Podporuje také makro {Best}, které kodéru říká, že má vybrat nejlepší miniaturu z prvních několika sekund videa, a vytvoří pouze jednu miniaturu bez ohledu na to, jaká jsou další nastavení 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 doby 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 zadaná při počátečním čase přednastavení transformace. Důvodem je kodér, který se snaží vybrat nejlepší miniaturu mezi časem zahájení a umístěním kroku z počátečního času jako první výstup. Vzhledem k tomu, že výchozí hodnota je 10 %, znamená to, že pokud má stream dlouhou dobu trvání, může být první vygenerovaná miniatura vzdálená od miniatury zadané při spuštění. Zkuste vybrat přiměřenou hodnotu pro Krok, pokud se očekává, že se první miniatura blíží času zahájení, nebo nastavte hodnotu Rozsah na 1, pokud je v době zahájení potřeba pouze jedna miniatura. |
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 |
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řesahuje 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušné rozšíření pro tento formát. {Label} – popisek přiřazený kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začíná od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ kodeku pro zvuk/video. {Resolution} – rozlišení videa. Všechna nesubstituovaná 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í směšovat dohromady . |
MultiBitrateFormat
Popisuje vlastnosti pro vytvoření kolekce gop sladěných 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á je promíchaná společně se všemi zvuky. Přesné výstupní soubory lze řídit zadáním kolekce outputFiles.
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řesahuje 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušné rozšíření pro tento formát. {Label} – popisek přiřazený kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začíná od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ kodeku pro zvuk/video. {Resolution} – rozlišení videa. Všechna nesubstituovaná 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í směšovat 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 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 |
Png |
Kolekce výstupních vrstev obrázků PNG, které mají být vytvořeny kodérem. |
range |
string |
Pozice vzhledem k času spuštění přednastavené transformace ve vstupním videu, na kterém se mají 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 počátečního času) nebo počet snímků (například 300 k zastavení na 300. snímku od rámce při zahájení. Pokud je tato hodnota 1, znamená to, že se při zahájení vytvoří jenom jedna miniatura) nebo relativní hodnota k době trvání streamu (například 50 % pro zastavení na polovinu doby trvání datového proudu od počátečního času). 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čí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). Podporuje také makro {Best}, které kodéru říká, že má vybrat nejlepší miniaturu z prvních několika sekund videa, a vytvoří pouze jednu miniaturu bez ohledu na to, jaká jsou další nastavení 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 doby 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 zadaná při počátečním čase přednastavení transformace. Důvodem je kodér, který se snaží vybrat nejlepší miniaturu mezi časem zahájení a umístěním kroku z počátečního času jako první výstup. Vzhledem k tomu, že výchozí hodnota je 10 %, znamená to, že pokud má stream dlouhou dobu trvání, může být první vygenerovaná miniatura vzdálená od miniatury zadané při spuštění. Zkuste vybrat přiměřenou hodnotu pro Krok, pokud se očekává, že se první miniatura blíží času zahájení, nebo nastavte hodnotu Rozsah na 1, pokud je v době zahájení potřeba pouze jedna miniatura. |
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 |
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 volitelného nastavení konfigurace kodéru.
Name | Typ | Description |
---|---|---|
complexity |
Umožňuje nakonfigurovat nastavení kodéru pro řízení rovnováhy mezi rychlostí a kvalitou. Příklad: Pokud chcete rychlejší kódování, ale menší efektivitu komprese, nastavte na hodnotu Complexity (Složitost) na hodnotu Speed (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 pouze pro zvuk a video. |
|
keyFrameIntervalInSeconds |
number |
Interval klíčového snímku v sekundách. Příklad: Nastavením hodnoty KeyFrameIntervalInSeconds na hodnotu 2 omezíte ukládání do vyrovnávací paměti přehrávání u některých přehrávačů. |
maxBitrateBps |
integer |
Maximální přenosová rychlost v bitech za sekundu (prahová hodnota pro horní vrstvu videa). Příklad: Nastavte hodnotu MaxBitrateBps na 6000000, abyste zabránili 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: Nastavení hodnoty MaxHeight jako 720 pro vytváření výstupních vrstev až do 720P, i když je vstup 4K. |
maxLayers |
integer |
Maximální počet výstupních vrstev videa. Příklad: Nastavte Hodnotu MaxLayers na hodnotu 4, abyste měli jistotu, že se vytvoří maximálně 4 výstupní vrstvy, které řídí 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 200000 tak, aby měla dolní vrstvu, která pokrývá uživatele s malou šíř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šími rozlišeními, 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ů mpeg-2 Transport Stream (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řesahuje 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušné rozšíření pro tento formát. {Label} – popisek přiřazený kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začíná od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ kodeku pro zvuk/video. {Resolution} – rozlišení videa. Všechna nesubstituovaná 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í směšovat 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 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ě |
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é mají být provedeny. Pokud není zadán, 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. |