Jobs - Update
Úloha aktualizace
Aktualizace se podporuje jenom pro popis a prioritu. Priorita aktualizace se projeví, když je stav úlohy ve frontě nebo naplánovaný a v závislosti na načasování může být aktualizace priority ignorována.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}/jobs/{jobName}?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. |
job
|
path | True |
string |
Název úlohy. |
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.input | True | JobInput: |
Vstupy pro úlohu. |
properties.outputs | True | JobOutput[]: |
Výstupy pro úlohu. |
properties.correlationData |
object |
Klíč poskytnutý zákazníkem a páry hodnot, které se vrátí v událostech stavu Job a JobOutput. |
|
properties.description |
string |
Volitelný popis úlohy zadal zákazník. |
|
properties.priority |
Priorita, se kterou má být úloha zpracována. Úlohy s vyšší prioritou se zpracovávají před úlohami s nižší prioritou. Pokud není nastavená, výchozí hodnota je normální. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Podrobné informace o chybě |
Příklady
Update a Job
Ukázkový požadavek
PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/exampleTransform/jobs/job1?api-version=2022-07-01
{
"properties": {
"description": "Example job to illustrate update.",
"input": {
"@odata.type": "#Microsoft.Media.JobInputAsset",
"assetName": "job1-InputAsset"
},
"outputs": [
{
"@odata.type": "#Microsoft.Media.JobOutputAsset",
"assetName": "job1-OutputAsset"
}
],
"priority": "High"
}
}
Ukázková odpověď
{
"name": "job1",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/exampleTransform/jobs/job1",
"type": "Microsoft.Media/mediaservices/transforms/jobs",
"properties": {
"created": "2021-06-01T00:00:00Z",
"state": "Queued",
"description": "Example job to illustrate update.",
"input": {
"@odata.type": "#Microsoft.Media.JobInputs",
"inputs": [
{
"@odata.type": "#Microsoft.Media.JobInputAsset",
"files": [],
"inputDefinitions": [],
"assetName": "job1-InputAsset"
}
]
},
"lastModified": "2022-10-17T23:14:33.9584586Z",
"outputs": [
{
"@odata.type": "#Microsoft.Media.JobOutputAsset",
"state": "Queued",
"progress": 0,
"label": "example-custom-label",
"assetName": "job1-OutputAsset"
}
],
"priority": "High",
"correlationData": {}
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2021-06-01T00:00:00Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:33.9584586Z"
}
}
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. |
Absolute |
Určuje čas klipu jako absolutní časovou pozici v multimediálním souboru. Absolutní čas může ukazovat na jinou pozici v závislosti na tom, jestli multimediální soubor začíná od časového razítka nula nebo ne. |
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. |
Attribute |
Typ AtributFilter, který se použije pro TrackAttribute, aby bylo možné vybrat stopy. |
Audio |
Definuje společné vlastnosti všech zvukových kodeků. |
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 s jednou zvukovou stopou. |
Audio |
Popisuje vlastnosti překryvu zvuku. |
Audio |
A TrackSelection pro výběr zvukových stop. |
Blur |
Typ rozostření |
Built |
Popisuje integrovanou předvolbu pro kódování vstupního videa pomocí standardního kodéru. |
Channel |
Volitelné označení pro zvukové stopy s jedním kanálem. Lze použít ke kombinování skladeb do stereofonní nebo vícekanálové zvukové stopy. |
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í bitstream zvuku. |
Copy |
Příznak kodeku, který kodéru říká, aby zkopíroval vstupní bitový stream videa bez opětovného kódování. |
created |
Typ identity, která vytvořila prostředek. |
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 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 |
Odpověď na chybu |
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 Prolnutí 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. |
From |
InputDefinition, který hledá ve všech souborech, které jsou k dispozici pro výběr stop určených IncludedTracks vlastnost. Běžně se používá s AudioTrackByAttribute a VideoTrackByAttribute k povolení výběru jedné stopy napříč sadou vstupních souborů. |
From |
InputDefinition, který se podívá na každý vstupní soubor zadaný pro výběr stop určených IncludedTracks vlastnost. Běžně se používá s AudioTrackByAttribute a VideoTrackByAttribute k výběru stop z každého zadaného souboru. |
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. |
Input |
InputDefinition pro jeden soubor. TrackSelections jsou vymezeny na zadaný soubor. |
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. |
Job |
Typ prostředku Úloha. Průběh a stav lze získat dotazováním úlohy nebo přihlášením k odběru událostí pomocí EventGrid. |
Job |
Podrobnosti o chybách JobOutput |
Job |
Pomáhá se kategorizací chyb. |
Job |
Kód chyby popisující chybu |
Job |
Podrobnosti o chybách JobOutput |
Job |
Představuje prostředek pro vstup do úlohy. |
Job |
Představuje vstupní soubory pro úlohu. |
Job |
Představuje vstup úlohy HTTPS. |
Job |
Popisuje seznam vstupů do úlohy. |
Job |
Sekvence obsahuje seřazený seznam klipů, kde každý klip je JobInput. Sekvence bude považována za jeden vstup. |
Job |
Představuje prostředek použitý jako JobOutput. |
Job |
Označuje, že může být možné zkusit úlohu zopakovat. Pokud je opakování neúspěšné, kontaktujte podpora Azure prostřednictvím webu Azure Portal. |
Job |
Popisuje stav JobOutput. |
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. |
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 Auto |
Select |
Ze vstupu vyberte zvukové stopy zadáním atributu a filtru atributů. |
Select |
Ze vstupu vyberte zvukové stopy zadáním identifikátoru stopy. |
Select |
Vyberte video stopy ze vstupu zadáním atributu a filtru atributů. |
Select |
Vyberte video stopy ze vstupu zadáním identifikátoru stopy. |
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 |
Track |
TrackAttribute pro filtrování stop. |
Transport |
Popisuje vlastnosti pro generování výstupních videosouborů mpeg-2 Transport Stream (ISO/IEC 13818-1). |
Utc |
Určuje čas klipu jako pozici času UTC v multimediálním souboru. Čas UTC může ukazovat na jinou pozici v závislosti na tom, jestli multimediální soubor začíná od časového razítka nula nebo ne. |
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 výstup souboru formátu JSON. |
Video |
Popisuje vlastnosti překryvného videa. |
Video |
Režim synchronizace videa |
Video |
A TrackSelection pro výběr video stop. |
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. |
AbsoluteClipTime
Určuje čas klipu jako absolutní časovou pozici v multimediálním souboru. Absolutní čas může ukazovat na jinou pozici v závislosti na tom, jestli multimediální soubor začíná od časového razítka nula nebo ne.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
time |
string |
Časová pozice na časové ose vstupního média. Obvykle se zadává jako ISO8601 období. například PT30S po dobu 30 sekund. |
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 |
AttributeFilter
Typ AtributFilter, který se použije pro TrackAttribute, aby bylo možné vybrat stopy.
Name | Typ | Description |
---|---|---|
All |
string |
Všechny stopy budou zahrnuty. |
Bottom |
string |
První stopa bude zahrnuta, jakmile bude atribut seřazen vzestupně. Obvykle se používá k výběru nejmenší přenosové rychlosti. |
Top |
string |
První stopa bude zahrnuta, jakmile bude atribut seřazen v sestupném pořadí. Obecně se používá k výběru největší přenosové rychlosti. |
ValueEquals |
string |
Budou zahrnuty všechny stopy, které mají atribut, který se rovná zadané hodnotě. |
Audio
Definuje společné vlastnosti všech zvukových kodeků.
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. |
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 s jednou zvukovou stopou.
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 'language tag-region' (např. "en-US"). Pokud znáte jazyk svého obsahu, doporučujeme ho zadat. Jazyk musí být explicitně zadán 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 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ě |
mode |
Určuje sadu operací analýzy zvuku, které se mají provést. Pokud není zadáno, 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. |
AudioTrackDescriptor
A TrackSelection pro výběr zvukových stop.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
channelMapping |
Volitelné označení pro zvukové stopy s jedním kanálem. Lze použít ke kombinování skladeb do stereofonní nebo vícekanálové zvukové stopy. |
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 kodéru Konfigurace se podporují jenom pro ContentAwareEncoding a H265ContentAwareEncoding BuiltInStandardEncoderPreset. |
|
presetName |
Integrovaná předvolba, která se má použít pro kódování videí. |
ChannelMapping
Volitelné označení pro zvukové stopy s jedním kanálem. Lze použít ke kombinování skladeb do stereofonní nebo vícekanálové zvukové stopy.
Name | Typ | Description |
---|---|---|
BackLeft |
string |
Levý zadní kanál. Někdy se označuje jako levý prostorový kanál. |
BackRight |
string |
Pravý zadní kanál. Někdy se označuje jako pravý prostorový kanál. |
Center |
string |
Středový kanál. |
FrontLeft |
string |
Přední levý kanál. |
FrontRight |
string |
Pravý přední kanál. |
LowFrequencyEffects |
string |
Kanál nízkofrekvenčních efektů. Někdy se označuje jako subwoofer. |
StereoLeft |
string |
Levý stereofonní kanál. Někdy se označuje jako kombinace dolů doleva. |
StereoRight |
string |
Pravý stereofonní kanál. Někdy se označuje jako dolů mix vpravo. |
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í bitstream 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í při muxingu. |
CopyVideo
Příznak kodeku, který kodéru říká, aby zkopíroval vstupní bitový stream 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í při muxingu. |
createdByType
Typ identity, která vytvořila prostředek.
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 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 |
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
Odpověď na chybu
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 vystaveny v samotné předvolbě |
mode |
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í. |
|
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é jsou ve videu se změněnou velikostí 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 Prolnutí použitého na vstupní médium.
Name | Typ | Description |
---|---|---|
duration |
string |
Doba trvání efektu prolnutí ve videu. Hodnota může být ve formátu ISO 8601 (například PT05S pro roztmínění barvy během 5 sekund) nebo počet snímků (například 10 až 10 snímků od začátku) nebo relativní hodnota doby trvání datového proudu (například 10 %, až 10 % doby trvání datového proudu). |
fadeColor |
string |
Barva pro prolnutí nebo zeslabování. Může být na úrovni barev https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords CSS úrovně1 nebo v šestnáctkové hodnotě RGB/šestnáctkové: 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čí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). 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. |
FromAllInputFile
InputDefinition, který hledá ve všech souborech, které jsou k dispozici pro výběr stop určených IncludedTracks vlastnost. Běžně se používá s AudioTrackByAttribute a VideoTrackByAttribute k povolení výběru jedné stopy napříč sadou vstupních souborů.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
includedTracks | TrackDescriptor[]: |
Seznam popisovačů TrackDescriptor, které definují metadata a výběr stop ve vstupu. |
FromEachInputFile
InputDefinition, který se podívá na každý vstupní soubor zadaný pro výběr stop určených IncludedTracks vlastnost. Běžně se používá s AudioTrackByAttribute a VideoTrackByAttribute k výběru stop z každého zadaného souboru.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
includedTracks | TrackDescriptor[]: |
Seznam popisovačů TrackDescriptor, které definují metadata a výběr stop ve vstupu. |
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 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 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 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 Auto. |
|
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 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é. |
|
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.265, které mají být vytvořeny kodérem. |
|
sceneChangeDetection |
boolean |
Určuje, jestli 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 |
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ř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. |
InputFile
InputDefinition pro jeden soubor. TrackSelections jsou vymezeny na zadaný soubor.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
filename |
string |
Název souboru, na který se tato vstupní definice vztahuje. |
includedTracks | TrackDescriptor[]: |
Seznam popisovačů TrackDescriptor, které definují metadata a výběr stop ve vstupu. |
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. |
Job
Typ prostředku Úloha. Průběh a stav lze získat dotazováním úlohy nebo přihlášením k odběru událostí pomocí EventGrid.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku. Příklad – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Název prostředku |
properties.correlationData |
object |
Klíč poskytnutý zákazníkem a páry hodnot, které se vrátí v událostech stavu Job a JobOutput. |
properties.created |
string |
Datum a čas UTC, kdy zákazník vytvořil úlohu, ve formátu RRRR-MM-DDThh:mm:ssZ. |
properties.description |
string |
Volitelný popis úlohy zadal zákazník. |
properties.endTime |
string |
Datum a čas UTC, ke kterému se dokončilo zpracování této úlohy. |
properties.input | JobInput: |
Vstupy pro úlohu. |
properties.lastModified |
string |
Datum a čas UTC, kdy zákazník naposledy aktualizoval úlohu, ve formátu RRRR-MM-DDThh:mm:ssZ. |
properties.outputs | JobOutput[]: |
Výstupy pro úlohu. |
properties.priority |
Priorita, se kterou má být úloha zpracována. Úlohy s vyšší prioritou se zpracovávají před úlohami s nižší prioritou. Pokud není nastavená, výchozí hodnota je normální. |
|
properties.startTime |
string |
Datum a čas UTC, kdy tato úloha začala zpracovávat. |
properties.state |
Aktuální stav úlohy. |
|
systemData |
Systémová metadata týkající se tohoto prostředku. |
|
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
JobError
Podrobnosti o chybách JobOutput
Name | Typ | Description |
---|---|---|
category |
Pomáhá se kategorizací chyb. |
|
code |
Kód chyby popisující chybu |
|
details |
Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě. |
|
message |
string |
Lidsky čitelná jazyková reprezentace chyby. |
retry |
Označuje, že může být možné zkusit úlohu zopakovat. Pokud je opakování neúspěšné, kontaktujte podpora Azure prostřednictvím webu Azure Portal. |
JobErrorCategory
Pomáhá se kategorizací chyb.
Name | Typ | Description |
---|---|---|
Account |
string |
Chyba souvisí s informacemi o účtu. |
Configuration |
string |
Chyba souvisí s konfigurací. |
Content |
string |
Chyba souvisí s daty ve vstupních souborech. |
Download |
string |
Chyba souvisí se stahováním. |
Service |
string |
Chyba souvisí se službou. |
Upload |
string |
Chyba souvisí s nahráváním. |
JobErrorCode
Kód chyby popisující chybu
Name | Typ | Description |
---|---|---|
ConfigurationUnsupported |
string |
Došlo k potížím s kombinací vstupních souborů a použitých nastavení konfigurace, opravit nastavení konfigurace a zkusit to znovu se stejným vstupem nebo změnit vstup tak, aby odpovídal konfiguraci. |
ContentMalformed |
string |
Došlo k problému se vstupním obsahem (například s nulovými bajtovými soubory nebo poškozenými nebo dekódovatelnými soubory), zkontrolujte vstupní soubory. |
ContentUnsupported |
string |
Došlo k problému s formátem vstupu (neplatný multimediální soubor nebo nepodporovaný soubor nebo kodek) a zkontrolujte platnost vstupních souborů. |
DownloadNotAccessible |
string |
Při pokusu o stažení vstupních souborů nebyly tyto soubory přístupné. Zkontrolujte dostupnost zdroje. |
DownloadTransientError |
string |
Při pokusu o stažení vstupních souborů došlo k problému během přenosu (chyba služby úložiště, sítě), podívejte se na podrobnosti a zkontrolujte zdroj. |
IdentityUnsupported |
string |
Při ověřování identity účtu došlo k chybě. Zkontrolujte a opravte konfigurace identit a zkuste to znovu. V případě neúspěchu kontaktujte podporu. |
ServiceError |
string |
Závažná chyba služby, obraťte se na podporu. |
ServiceTransientError |
string |
Přechodná chyba, zkuste to znovu. Pokud je opakování neúspěšné, obraťte se na podporu. |
UploadNotAccessible |
string |
Při pokusu o nahrání výstupních souborů nebyl cíl dostupný. Zkontrolujte dostupnost cíle. |
UploadTransientError |
string |
Při pokusu o nahrání výstupních souborů došlo k problému během přenosu (služba úložiště, chyby sítě), projděte si podrobnosti a zkontrolujte cíl. |
JobErrorDetail
Podrobnosti o chybách JobOutput
Name | Typ | Description |
---|---|---|
code |
string |
Kód popisující podrobnosti o chybě |
message |
string |
Lidsky čitelná reprezentace chyby. |
JobInputAsset
Představuje prostředek pro vstup do úlohy.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
assetName |
string |
Název vstupního prostředku. |
end | ClipTime: |
Definuje bod na časové ose vstupního média, na kterém skončí zpracování. Výchozí hodnota je konec vstupního média. |
files |
string[] |
Seznam souborů. Povinné pro JobInputHttp. Maximálně 4 000 znaků. Řetězce dotazů se v odpovědích služby nevrátí, aby se zabránilo odhalení citlivých dat. |
inputDefinitions | InputDefinition[]: |
Definuje seznam InputDefinitions. Pro každou InputDefinition definuje seznam výběrů tras a souvisejících metadat. |
label |
string |
Popisek, který je přiřazen jobInputClip, který se používá k uspokojení odkazu použitého v transformaci. Transformovat se může například tak, že vezme soubor obrázku s popiskem "xyz" a použije ho jako překryv na vstupní video před kódováním. Při odesílání úlohy by měl být přesně jedním z jobInputs soubor obrázku a měl by mít popisek xyz. |
start | ClipTime: |
Definuje bod na časové ose vstupního média, na kterém se zahájí zpracování. Výchozí hodnota je začátek vstupního média. |
JobInputClip
Představuje vstupní soubory pro úlohu.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
end | ClipTime: |
Definuje bod na časové ose vstupního média, na kterém skončí zpracování. Výchozí hodnota je konec vstupního média. |
files |
string[] |
Seznam souborů. Povinné pro JobInputHttp. Maximálně 4 000 znaků. Řetězce dotazů se v odpovědích služby nevrátí, aby se zabránilo odhalení citlivých dat. |
inputDefinitions | InputDefinition[]: |
Definuje seznam InputDefinitions. Pro každou InputDefinition definuje seznam výběrů tras a souvisejících metadat. |
label |
string |
Popisek, který je přiřazen jobInputClip, který se používá k uspokojení odkazu použitého v transformaci. Transformovat se může například tak, že vezme soubor obrázku s popiskem "xyz" a použije ho jako překryv na vstupní video před kódováním. Při odesílání úlohy by měl být přesně jedním z jobInputs soubor obrázku a měl by mít popisek xyz. |
start | ClipTime: |
Definuje bod na časové ose vstupního média, na kterém se zahájí zpracování. Výchozí hodnota je začátek vstupního média. |
JobInputHttp
Představuje vstup úlohy HTTPS.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
baseUri |
string |
Základní identifikátor URI pro vstup úlohy HTTPS Bude zřetězen se zadanými názvy souborů. Pokud není zadán žádný základní identifikátor URI, předpokládá se, že zadaný seznam souborů je plně kvalifikovaný uris. Maximální délka je 4000 znaků. Řetězce dotazu nebudou vráceny v odpovědích služby, aby se zabránilo odhalení citlivých dat. |
end | ClipTime: |
Definuje bod na časové ose vstupního média, na kterém skončí zpracování. Výchozí hodnota je konec vstupního média. |
files |
string[] |
Seznam souborů. Povinné pro JobInputHttp. Maximálně 4 000 znaků. Řetězce dotazů se v odpovědích služby nevrátí, aby se zabránilo odhalení citlivých dat. |
inputDefinitions | InputDefinition[]: |
Definuje seznam InputDefinitions. Pro každou InputDefinition definuje seznam výběrů tras a souvisejících metadat. |
label |
string |
Popisek, který je přiřazen jobInputClip, který se používá k uspokojení odkazu použitého v transformaci. Transformovat se může například tak, že vezme soubor obrázku s popiskem "xyz" a použije ho jako překryv na vstupní video před kódováním. Při odesílání úlohy by měl být přesně jedním z jobInputs soubor obrázku a měl by mít popisek xyz. |
start | ClipTime: |
Definuje bod na časové ose vstupního média, na kterém se zahájí zpracování. Výchozí hodnota je začátek vstupního média. |
JobInputs
Popisuje seznam vstupů do úlohy.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
inputs | JobInput[]: |
Seznam vstupů do úlohy |
JobInputSequence
Sekvence obsahuje seřazený seznam klipů, kde každý klip je JobInput. Sekvence bude považována za jeden vstup.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
inputs | JobInputClip[]: |
Úlohy, které tvoří časovou osu. |
JobOutputAsset
Představuje prostředek použitý jako JobOutput.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
assetName |
string |
Název výstupního prostředku. |
endTime |
string |
Datum a čas UTC, kdy výstup úlohy dokončil zpracování. |
error |
Pokud je hodnota JobOutput v chybovém stavu, obsahuje podrobnosti o chybě. |
|
label |
string |
Popisek, který je přiřazený k JobOutputu, aby bylo možné ho jednoznačně identifikovat. To je užitečné, když transformace obsahuje více než jeden objekt TransformOutput, přičemž úloha má více než jedenoutput Úlohy. V takových případech při odeslání úlohy přidáte dva nebo více objektů JobOutput ve stejném pořadí jako TransformOutputs v transformaci. Následně, když načtete úlohu, buď prostřednictvím událostí, nebo na požadavku GET, můžete použít popisek ke snadné identifikaci JobOutput. Pokud popisek není zadaný, použije se výchozí hodnota {presetName}_{outputIndex}, kde název přednastavení je název předvolby v odpovídající hodnotě TransformOutput a index výstupu je relativním indexem tohoto výstupu Úlohy. Všimněte si, že tento index je stejný jako relativní index odpovídajícího objektu TransformOutput v rámci transformace. |
presetOverride | Preset: |
Předvolba, která se používá k přepsání přednastavení v odpovídajícím výstupu transformace. |
progress |
integer |
Pokud je hodnota JobOutput ve stavu Zpracování, obsahuje procento dokončení úlohy. Hodnota je odhad a není určená k předpovídání časů dokončení úlohy. Chcete-li zjistit, zda jobOutput je dokončen, použijte State vlastnost. |
startTime |
string |
Datum a čas UTC, kdy se tento výstup úlohy začal zpracovávat. |
state |
Popisuje stav JobOutput. |
JobRetry
Označuje, že může být možné zkusit úlohu zopakovat. Pokud je opakování neúspěšné, kontaktujte podpora Azure prostřednictvím webu Azure Portal.
Name | Typ | Description |
---|---|---|
DoNotRetry |
string |
Problém je potřeba prošetřit a poté úlohu znovu odeslat s opravami nebo opakovat po opravě základního problému. |
MayRetry |
string |
Problém se může vyřešit po určitou dobu čekání a opětovném odeslání stejné úlohy. |
JobState
Popisuje stav JobOutput.
Name | Typ | Description |
---|---|---|
Canceled |
string |
Úloha byla zrušena. Toto je konečný stav úlohy. |
Canceling |
string |
Úloha se právě ruší. Jedná se o přechodný stav úlohy. |
Error |
string |
V úloze došlo k chybě. Toto je konečný stav úlohy. |
Finished |
string |
Úloha je dokončena. Toto je konečný stav úlohy. |
Processing |
string |
Úloha se zpracovává. Jedná se o přechodný stav úlohy. |
Queued |
string |
Úloha je ve frontě a čeká na zpřístupnění prostředků. Jedná se o přechodný stav. |
Scheduled |
string |
Úloha se plánuje tak, aby běžela na dostupném prostředku. Jedná se o přechodný stav mezi stavy zařazeným do fronty a stavem zpracování. |
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 . |
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ř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. |
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 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 v pixelech (například 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 v pixelech (například 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 v pixelech (například 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 v pixelech (například 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 Auto
Name | Typ | Description |
---|---|---|
Auto |
string |
Automaticky zjišťovat a otáčet podle potřeby. |
None |
string |
Video neotáčejte. Pokud to výstupní formát podporuje, všechna metadata o rotaci zůstanou nedotčená. |
Rotate0 |
string |
Video neotáčíte, ale odeberte všechna metadata o otoč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ňů ve směru hodinových ručiček. |
SelectAudioTrackByAttribute
Ze vstupu vyberte zvukové stopy zadáním atributu a filtru atributů.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
attribute |
TrackAttribute pro filtrování stop. |
|
channelMapping |
Volitelné označení pro zvukové stopy s jedním kanálem. Lze použít ke kombinování skladeb do stereofonní nebo vícekanálové zvukové stopy. |
|
filter |
Typ AtributFilteru, který se má použít pro TrackAttribute, aby bylo možné vybrat stopy. |
|
filterValue |
string |
Hodnota, podle které chcete filtrovat stopy. Používá se pouze v případě, že AttributeFilter.ValueEquals je zadán pro vlastnost Filter. |
SelectAudioTrackById
Ze vstupu vyberte zvukové stopy zadáním identifikátoru stopy.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
channelMapping |
Volitelné označení pro zvukové stopy s jedním kanálem. Lze použít ke kombinování skladeb do stereofonní nebo vícekanálové zvukové stopy. |
|
trackId |
integer |
Sledovat identifikátor, který chcete vybrat |
SelectVideoTrackByAttribute
Vyberte video stopy ze vstupu zadáním atributu a filtru atributů.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
attribute |
TrackAttribute pro filtrování stop. |
|
filter |
Typ AtributFilteru, který se má použít pro TrackAttribute, aby bylo možné vybrat stopy. |
|
filterValue |
string |
Hodnota, podle které chcete filtrovat stopy. Používá se pouze v případě, že AttributeFilter.ValueEquals je zadán pro vlastnost Filter. V případě TrackAttribute.Bitrate by to měla být celočíselná hodnota v bitech za sekundu (např. 1500000). TrackAttribute.Language se nepodporuje pro video stopy. |
SelectVideoTrackById
Vyberte video stopy ze vstupu zadáním identifikátoru stopy.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
trackId |
integer |
Sledovat identifikátor, který chcete vybrat |
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 vystaveny v samotné předvolbě |
filters |
Jedna nebo více operací filtrování, které se před kódováním použijí na vstupní médium. |
|
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á prostředek vytvořila. |
createdByType |
Typ identity, která vytvořila prostředek. |
|
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. |
TrackAttribute
TrackAttribute pro filtrování stop.
Name | Typ | Description |
---|---|---|
Bitrate |
string |
Přenosová rychlost stopy. |
Language |
string |
Jazyk skladby. |
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 . |
UtcClipTime
Určuje čas klipu jako pozici času UTC v multimediálním souboru. Čas UTC může ukazovat na jinou pozici v závislosti na tom, jestli multimediální soubor začíná od časového razítka nula nebo ne.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |
time |
string |
Pozice času na časové ose vstupního média na základě času UTC. |
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 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. |
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 |
VideoAnalyzerPreset
Předvolba analyzátoru videa, která extrahuje přehledy (bohatá metadata) ze zvuku i videa a výstup souboru 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 'language tag-region' (např. "en-US"). Pokud znáte jazyk svého obsahu, doporučujeme ho zadat. Jazyk musí být explicitně zadán 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 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 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ě. |
|
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. |
VideoTrackDescriptor
A TrackSelection pro výběr video stop.
Name | Typ | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminátor pro odvozené typy. |