Sdílet prostřednictvím


Transforms - Get

Získat transformaci
Získá transformaci.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}?api-version=2022-07-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
accountName
path True

string

Název účtu služby Media Services.

resourceGroupName
path True

string

Název skupiny prostředků v rámci předplatného Azure.

subscriptionId
path True

string

Jedinečný identifikátor předplatného Microsoft Azure.

transformName
path True

string

Název transformace.

api-version
query True

string

Verze rozhraní API, která se má použít s žádostí klienta.

Odpovědi

Name Typ Description
200 OK

Transform

OK

Other Status Codes

ErrorResponse

Podrobné informace o chybě

Příklady

Get a Transform by name

Ukázkový požadavek

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/sampleTransform?api-version=2022-07-01

Ukázková odpověď

{
  "name": "sampleTransform",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/sampleTransform",
  "type": "Microsoft.Media/mediaservices/transforms",
  "properties": {
    "created": "2022-10-17T23:14:31.6281097Z",
    "description": "A sample Transform using the Standard Encoder with a built in preset.",
    "lastModified": "2022-10-17T23:14:31.6281097Z",
    "outputs": [
      {
        "onError": "StopProcessingJob",
        "relativePriority": "Normal",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "H264MultipleBitrate1080p"
        }
      }
    ]
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:31.6281097Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:31.6281097Z"
  }
}

Definice

Name Description
AacAudio

Popisuje nastavení kódování zvuku AAC (Advanced Audio Codec).

AacAudioProfile

Profil kódování, který se má použít při kódování zvuku pomocí AAC.

AnalysisResolution

Určuje maximální rozlišení, při kterém se video analyzuje. Výchozí chování je SourceResolution, což při analýze zachová vstupní video v původním rozlišení. Použitím standardu "StandardDefinition" změníte velikost vstupních videí na standardní definici při zachování příslušného poměru stran. Velikost se změní jenom v případě, že má video vyšší rozlišení. Například vstup 1920 × 1080 by se před zpracováním škáloval na 640 × 360. Přepnutím na StandardDefinition se zkrátí doba potřebná ke zpracování videa ve vysokém rozlišení. Může také snížit náklady na používání této komponenty (podrobnosti viz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Tváře, které budou ve změně velikosti videa příliš malé, ale nemusí být rozpoznány.

Audio

Definuje společné vlastnosti pro všechny zvukové kodeky.

AudioAnalysisMode

Určuje sadu operací analýzy zvuku, které mají být provedeny. Pokud není zadán, bude zvolena možnost Standard AudioAnalysisMode.

AudioAnalyzerPreset

Předvolba Analyzátoru zvuku použije předdefinované sady analytických operací založených na umělé inteligenci, včetně přepisu řeči. V současné době předvolba podporuje zpracování obsahu pomocí jedné zvukové stopy.

AudioOverlay

Popisuje vlastnosti překryvu zvuku.

BlurType

Typ rozostření

BuiltInStandardEncoderPreset

Popisuje integrovanou předvolbu pro kódování vstupního videa pomocí standardního kodéru.

Complexity

Umožňuje nakonfigurovat nastavení kodéru pro řízení rovnováhy mezi rychlostí a kvalitou. Příklad: Pro rychlejší kódování, ale nižší efektivitu komprese nastavíte jako Rychlost.

CopyAudio

Příznak kodeku, který kodéru říká, aby zkopíroval vstupní datový proud zvuku.

CopyVideo

Příznak kodeku, který říká kodéru, aby zkopíroval vstupní datový proud videa bez opětovného kódování.

createdByType

Typ identity, která prostředek vytvořila.

DDAudio

Popisuje nastavení kódování zvuku Ac3 (Dolby Digital Audio Codec). Aktuální implementace pro podporu Dolby Digital Audio jsou: Čísla zvukových kanálů na 1((mono), 2(stereo), 6(5.1side); Frekvence vzorkování zvuku: 32K/44.1K/48K Hz; Hodnoty přenosové rychlosti zvuku, které specifikace AC3 podporuje: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.

Deinterlace

Popisuje nastavení prokládání.

DeinterlaceMode

Režim prolnutí. Výchozí hodnota je AutoPixelAdaptive.

DeinterlaceParity

Parita pole pro prokládání je ve výchozím nastavení nastavená na Automaticky.

EncoderNamedPreset

Integrovaná předvolba, která se použije pro kódování videí.

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ň.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě

ErrorResponse

Chybová odpověď

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.

FaceRedactorMode

Tento režim poskytuje možnost výběru mezi následujícími nastaveními: 1) Analyzovat – pouze pro detekci. Tento režim vygeneruje soubor JSON s metadaty označující vzhled tváří v celém videu. Tam, kde je to možné, se vzhledy stejné osoby přiřadí ke stejnému ID. 2) Kombinace – navíc rediguje (rozostřuje) rozpoznané tváře. 3) Redigovat – to umožňuje 2-pass proces, který umožňuje selektivní redakci podmnožinu detekovaných tváří. Převezme soubor metadat z předchozího průchodu analýzy spolu se zdrojovým videem a uživatelem vybranou podmnožinou ID, která vyžadují redigování.

Fade

Popisuje vlastnosti efektu Fade použitého na vstupní médium.

Filters

Popisuje všechny operace filtrování, jako je zrušení prokládání, otočení atd., které se mají použít na vstupní médium před kódováním.

H264Complexity

Říká kodéru, jak zvolit nastavení kódování. Výchozí hodnota je Vyvážená.

H264Layer

Popisuje nastavení, která se mají použít při kódování vstupního videa do požadované výstupní vrstvy přenosové rychlosti pomocí kodeku videa H.264.

H264RateControlMode

Režim řízení rychlosti videa

H264Video

Popisuje všechny vlastnosti kódování videa pomocí kodeku H.264.

H264VideoProfile

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.

H265VideoProfile

V současné době podporujeme Main. Výchozí hodnota je Automaticky.

Image

Popisuje základní vlastnosti pro generování miniatur ze vstupního videa.

ImageFormat

Popisuje vlastnosti výstupního souboru obrázku.

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ě.

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.

JpgFormat

Popisuje nastavení pro vytváření miniatur JPEG.

JpgImage

Popisuje vlastnosti pro vytvoření řady obrázků JPEG ze vstupního videa.

JpgLayer

Popisuje nastavení pro vytvoření obrázku JPEG ze vstupního videa.

Mp4Format

Popisuje vlastnosti výstupního souboru ISO MP4.

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.

OnErrorType

Transformace může definovat více než jeden výstup. Tato vlastnost definuje, co má služba dělat, když jeden výstup selže – buď pokračovat ve vytváření dalších výstupů, nebo zastavit ostatní výstupy. Celkový stav úlohy nebude odrážet selhání výstupů zadaných pomocí continuejob. Výchozí hodnota je StopProcessingJob.

OutputFile

Představuje vytvořený výstupní soubor.

PngFormat

Popisuje nastavení pro vytváření miniatur PNG.

PngImage

Popisuje vlastnosti pro vytvoření řady obrázků PNG ze vstupního videa.

PngLayer

Popisuje nastavení pro vytvoření obrázku PNG ze vstupního videa.

PresetConfigurations

Objekt volitelného nastavení konfigurace kodéru.

Priority

Nastaví relativní prioritu TransformOutputs v rámci transformace. Tím se nastaví priorita, kterou služba používá ke zpracování TransformOutputs. Výchozí priorita je Normální.

Rectangle

Popisuje vlastnosti obdélníkového okna použitého na vstupní médium před jeho zpracováním.

Rotation

Případné otočení, které se má použít u vstupního videa před kódováním. Výchozí hodnota je Automaticky.

StandardEncoderPreset

Popisuje všechna nastavení, která se mají použít při kódování vstupního videa pomocí standardního kodéru.

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.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Transform

Transformace zapouzdřuje pravidla nebo instrukce pro generování požadovaných výstupů ze vstupního média, například překódováním nebo extrahováním přehledů. Po vytvoření transformace se dá použít na vstupní médium vytvořením úloh.

TransformOutput

Popisuje vlastnosti TransformOutput, což jsou pravidla, která se mají použít při generování požadovaného výstupu.

TransportStreamFormat

Popisuje vlastnosti pro generování výstupních videosouborů mpeg-2 Transport Stream (ISO/IEC 13818-1).

Video

Popisuje základní vlastnosti kódování vstupního videa.

VideoAnalyzerPreset

Předvolba analyzátoru videa, která extrahuje přehledy (bohatá metadata) ze zvuku i videa a vypíše soubor formátu JSON.

VideoOverlay

Popisuje vlastnosti překryvného videa.

VideoSyncMode

Režim synchronizace videa

AacAudio

Popisuje nastavení kódování zvuku AAC (Advanced Audio Codec).

Name Typ Description
@odata.type string:

#Microsoft.Media.AacAudio

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

AacAudioProfile

Profil kódování, který se má použít při kódování zvuku pomocí AAC.

samplingRate

integer

Vzorkovací frekvence, která se má použít pro kódování v hertz.

AacAudioProfile

Profil kódování, který se má použít při kódování zvuku pomocí AAC.

Name Typ Description
AacLc

string

Určuje, že výstupní zvuk se má zakódovat do profilu AAC s nízkou složitostí (AAC-LC).

HeAacV1

string

Určuje, že výstupní zvuk se má zakódovat do profilu HE-AAC v1.

HeAacV2

string

Určuje, že výstupní zvuk se má zakódovat do profilu HE-AAC v2.

AnalysisResolution

Určuje maximální rozlišení, při kterém se video analyzuje. Výchozí chování je SourceResolution, což při analýze zachová vstupní video v původním rozlišení. Použitím standardu "StandardDefinition" změníte velikost vstupních videí na standardní definici při zachování příslušného poměru stran. Velikost se změní jenom v případě, že má video vyšší rozlišení. Například vstup 1920 × 1080 by se před zpracováním škáloval na 640 × 360. Přepnutím na StandardDefinition se zkrátí doba potřebná ke zpracování videa ve vysokém rozlišení. Může také snížit náklady na používání této komponenty (podrobnosti viz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Tváře, které budou ve změně velikosti videa příliš malé, ale nemusí být rozpoznány.

Name Typ Description
SourceResolution

string

StandardDefinition

string

Audio

Definuje společné vlastnosti pro všechny zvukové kodeky.

Name Typ Description
@odata.type string:

#Microsoft.Media.Audio

Diskriminátor pro odvozené typy.

bitrate

integer

Přenosová rychlost výstupu zakódovaného zvuku v bitech za sekundu.

channels

integer

Počet kanálů ve zvuku.

label

string

Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu.

samplingRate

integer

Vzorkovací frekvence, která se má použít pro kódování v hertz.

AudioAnalysisMode

Určuje sadu operací analýzy zvuku, které mají být provedeny. Pokud není zadán, bude zvolena možnost Standard AudioAnalysisMode.

Name Typ Description
Basic

string

Tento režim provádí přepis řeči na text a generování souboru titulků/popis VTT. Výstup tohoto režimu zahrnuje soubor JSON přehledů, který obsahuje pouze klíčová slova, přepis a informace o načasování. Automatický rozpoznávání jazyka a diarizace mluvčího nejsou v tomto režimu zahrnuty.

Standard

string

Provádí všechny operace zahrnuté v základním režimu a navíc provádí rozpoznávání jazyka a diarizaci mluvčího.

AudioAnalyzerPreset

Předvolba Analyzátoru zvuku použije předdefinované sady analytických operací založených na umělé inteligenci, včetně přepisu řeči. V současné době předvolba podporuje zpracování obsahu pomocí jedné zvukové stopy.

Name Typ Description
@odata.type string:

#Microsoft.Media.AudioAnalyzerPreset

Diskriminátor pro odvozené typy.

audioLanguage

string

Jazyk datové části zvuku ve vstupu ve formátu BCP-47 jazyka tag-region (např. en-US). Pokud znáte jazyk obsahu, doporučujeme ho zadat. Jazyk musí být určen explicitně pro AudioAnalysisMode::Basic, protože automatické rozpoznávání jazyka není součástí základního režimu. Pokud jazyk není zadaný nebo nastavený na hodnotu null, automatické rozpoznávání jazyka zvolí první zjištěný jazyk a zpracuje ho s vybraným jazykem po dobu trvání souboru. V současné době nepodporuje dynamické přepínání mezi jazyky po zjištění prvního jazyka. Automatická detekce funguje nejlépe se zvukovými záznamy s jasně rozpoznatelnou řečí. Pokud se automatickému zjišťování nepodaří najít jazyk, přepis se vrátí do en-US. Seznam podporovaných jazyků je k dispozici tady: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

Slovník obsahující páry hodnot klíčů pro parametry, které nejsou zpřístupněny v samotné předvolbě

mode

AudioAnalysisMode

Určuje sadu operací analýzy zvuku, které mají být provedeny. Pokud není zadán, bude zvolena možnost Standard AudioAnalysisMode.

AudioOverlay

Popisuje vlastnosti překryvu zvuku.

Name Typ Description
@odata.type string:

#Microsoft.Media.AudioOverlay

Diskriminátor pro odvozené typy.

audioGainLevel

number

Úroveň zesílení zvuku v překryvu. Hodnota by měla být v rozsahu [0, 1,0]. Výchozí hodnota je 1.0.

end

string

Koncová pozice s odkazem na vstupní video, na kterém končí překryv. Hodnota by měla být ve formátu ISO 8601. Například PT30S, který ukončí překryv po 30 sekundách vstupního videa. Pokud není zadána hodnota nebo je hodnota větší než doba trvání vstupního videa, bude překrytí použito až do konce vstupního videa, pokud je doba trvání překryvného média větší než doba trvání vstupního videa, jinak překrytí potrvá stejně dlouho jako překryvné médium.

fadeInDuration

string

Doba trvání, po kterou se překryvné zobrazení postupně slábne na vstupní video. Hodnota by měla být ve formátu doby trvání ISO 8601. Pokud není zadaný, výchozí chování je bez prolnutí (stejné jako PT0S).

fadeOutDuration

string

Doba, po kterou překryv ze vstupního videa zmizí. Hodnota by měla být ve formátu doby trvání ISO 8601. Pokud není zadaný, výchozím chováním je bez prolnutí (stejné jako PT0S).

inputLabel

string

Popisek vstupu úlohy, který se má použít jako překryv. Vstup musí obsahovat přesně jeden soubor. Můžete zadat soubor obrázku ve formátu JPG, PNG, GIF nebo BMP, zvukový soubor (například soubor WAV, MP3, WMA nebo M4A) nebo videosoubor. Úplný seznam podporovaných formátů zvukových souborů a videosouborů najdete v tématu https://aka.ms/mesformats .

start

string

Počáteční pozice s odkazem na vstupní video, na kterém začíná překryv. Hodnota by měla být ve formátu ISO 8601. Například PT05S spustí překrytí po 5 sekundách vstupního videa. Pokud není zadaný, překryv se spustí od začátku vstupního videa.

BlurType

Typ rozostření

Name Typ Description
Black

string

Black: Black out filter

Box

string

Pole: filtr ladění, pouze ohraničující rámeček

High

string

Vysoká: Záměně filtr rozostření

Low

string

Nízký: filtr rozostření krabicového vozu

Med

string

Med: Gaussian rozostření filtr

BuiltInStandardEncoderPreset

Popisuje integrovanou předvolbu pro kódování vstupního videa pomocí standardního kodéru.

Name Typ Description
@odata.type string:

#Microsoft.Media.BuiltInStandardEncoderPreset

Diskriminátor pro odvozené typy.

configurations

PresetConfigurations

Volitelná nastavení konfigurace pro kodér Konfigurace se podporují jenom pro ContentAwareEncoding a H265ContentAwareEncoding BuiltInStandardEncoderPreset.

presetName

EncoderNamedPreset

Integrovaná předvolba, která se použije pro kódování videí.

Complexity

Umožňuje nakonfigurovat nastavení kodéru pro řízení rovnováhy mezi rychlostí a kvalitou. Příklad: Pro rychlejší kódování, ale nižší efektivitu komprese nastavíte jako Rychlost.

Name Typ Description
Balanced

string

Nakonfiguruje kodér tak, aby používal nastavení, která zajistí rovnováhu mezi rychlostí a kvalitou.

Quality

string

Konfiguruje kodér tak, aby používal nastavení optimalizovaná pro vyšší kvalitu výstupu na úkor zpomalení celkové doby kódování.

Speed

string

Nakonfiguruje kodér tak, aby používal nastavení optimalizovaná pro rychlejší kódování. Kvalita se obětuje, aby se zkrátila doba kódování.

CopyAudio

Příznak kodeku, který kodéru říká, aby zkopíroval vstupní datový proud zvuku.

Name Typ Description
@odata.type string:

#Microsoft.Media.CopyAudio

Diskriminátor pro odvozené typy.

label

string

Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu.

CopyVideo

Příznak kodeku, který říká kodéru, aby zkopíroval vstupní datový proud videa bez opětovného kódování.

Name Typ Description
@odata.type string:

#Microsoft.Media.CopyVideo

Diskriminátor pro odvozené typy.

label

string

Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu.

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

DDAudio

Popisuje nastavení kódování zvuku Ac3 (Dolby Digital Audio Codec). Aktuální implementace pro podporu Dolby Digital Audio jsou: Čísla zvukových kanálů na 1((mono), 2(stereo), 6(5.1side); Frekvence vzorkování zvuku: 32K/44.1K/48K Hz; Hodnoty přenosové rychlosti zvuku, které specifikace AC3 podporuje: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.

Name Typ Description
@odata.type string:

#Microsoft.Media.DDAudio

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

DeinterlaceMode

Režim prokládání. Výchozí hodnota je AutoPixelAdaptive.

parity

DeinterlaceParity

Parita pole pro prokládání je ve výchozím nastavení automaticky.

DeinterlaceMode

Režim prolnutí. Výchozí hodnota je AutoPixelAdaptive.

Name Typ Description
AutoPixelAdaptive

string

Použijte automatické adaptivní dělení pixelů na každý snímek ve vstupním videu.

Off

string

Zakáže prokládání zdrojového videa.

DeinterlaceParity

Parita pole pro prokládání je ve výchozím nastavení nastavená na Automaticky.

Name Typ Description
Auto

string

Automaticky zjistit pořadí polí

BottomFieldFirst

string

Použití dolního pole jako první zpracování vstupního videa

TopFieldFirst

string

Použití horního pole jako první zpracování vstupního videa

EncoderNamedPreset

Integrovaná předvolba, která se použije pro kódování videí.

Name Typ Description
AACGoodQualityAudio

string

Vytvoří jeden soubor MP4 obsahující pouze stereofonní zvuk AAC kódovaný rychlostí 192 kb/s.

AdaptiveStreaming

string

Vytváří sadu souborů MP4 zarovnaných gop s videem H.264 a stereo zvukem AAC. Automaticky generuje žebřík přenosových rychlostí na základě vstupního rozlišení, přenosové rychlosti a snímkové frekvence. Automaticky generovaná předvolba nikdy nepřekročí rozlišení vstupu. Pokud je například vstup 720p, výstup zůstane v nejlepším případě 720p.

ContentAwareEncoding

string

Vytvoří sadu mp4 zarovnaných s gop pomocí kódování s podporou obsahu. Na základě jakéhokoli vstupního obsahu služba provede počáteční zjednodušenou analýzu vstupního obsahu a na základě výsledků určí optimální počet vrstev, odpovídající nastavení přenosové rychlosti a rozlišení pro doručení pomocí adaptivního streamování. Tato předvolba je zvláště účinná pro videa s nízkou a střední složitostí, kde budou výstupní soubory s nižší přenosovou rychlostí, ale v kvalitě, která divákům stále poskytuje dobré prostředí. Výstup bude obsahovat soubory MP4 s prokládáním videa a zvuku.

ContentAwareEncodingExperimental

string

Zpřístupňuje experimentální předvolbu pro kódování s podporou obsahu. Na základě jakéhokoli vstupního obsahu se služba pokusí automaticky určit optimální počet vrstev, nastavení odpovídající přenosové rychlosti a rozlišení pro doručování pomocí adaptivního streamování. Základní algoritmy se budou v průběhu času dál vyvíjet. Výstup bude obsahovat soubory MP4 s prokládáním videa a zvuku.

CopyAllBitrateNonInterleaved

string

Zkopírujte všechny streamy videa a zvuku ze vstupního prostředku jako neprokládané video a výstupní zvukové soubory. Tuto předvolbu můžete použít k vystřihoávání existujícího prostředku nebo k převedení skupiny souborů MP4 zarovnaných s klíčovými snímky (GOP) na asset, který lze streamovat.

DDGoodQualityAudio

string

Vytvoří jeden soubor MP4 obsahující pouze stereofonní zvuk DD(Digital Dolby) kódovaný rychlostí 192 kb/s.

H264MultipleBitrate1080p

string

Vytvoří sadu 8 souborů MP4 zarovnaných pomocí GOP v rozsahu od 6000 kb/s do 400 kb/s a stereofonního zvuku AAC. Řešení začíná na 1080p a klesne na 180p.

H264MultipleBitrate720p

string

Vytvoří sadu 6 souborů MP4 zarovnaných přes GOP v rozsahu od 3400 kb/s do 400 kbps a stereofonního zvuku AAC. Rozlišení začíná na 720p a klesne na 180p.

H264MultipleBitrateSD

string

Vytvoří sadu 5 souborů MP4 zarovnaných přes GOP v rozsahu od 1900 kb/s do 400 kb/s a stereofonního zvuku AAC. Rozlišení začíná na 480p a klesne na 240p.

H264SingleBitrate1080p

string

Vytvoří soubor MP4, ve kterém je video kódované pomocí kodeku H.264 v rozlišení 6750 kb/s a výšky obrázku 1080 pixelů a stereofonní zvuk je kódovaný kodekem AAC-LC rychlostí 128 kb/s.

H264SingleBitrate720p

string

Vytvoří soubor MP4, ve kterém je video kódované pomocí kodeku H.264 v rozlišení 4500 kb/s a výšky obrázku 720 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s.

H264SingleBitrateSD

string

Vytvoří soubor MP4, ve kterém je video zakódované pomocí kodeku H.264 s rychlostí 2200 kb/s a výšky obrázku 480 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s.

H265AdaptiveStreaming

string

Vytváří sadu souborů MP4 zarovnaných gop s videem H.265 a stereo zvukem AAC. Automaticky generuje žebřík přenosových rychlostí na základě vstupního rozlišení, přenosové rychlosti a snímkové frekvence. Automaticky generovaná předvolba nikdy nepřekročí rozlišení vstupu. Pokud je například vstup 720p, výstup zůstane v nejlepším případě 720p.

H265ContentAwareEncoding

string

Vytvoří sadu mp4 zarovnaných s gop pomocí kódování s podporou obsahu. Na základě jakéhokoli vstupního obsahu služba provede počáteční zjednodušenou analýzu vstupního obsahu a na základě výsledků určí optimální počet vrstev, odpovídající nastavení přenosové rychlosti a rozlišení pro doručení pomocí adaptivního streamování. Tato předvolba je zvláště účinná pro videa s nízkou a střední složitostí, kde budou výstupní soubory s nižší přenosovou rychlostí, ale v kvalitě, která divákům stále poskytuje dobré prostředí. Výstup bude obsahovat soubory MP4 s prokládáním videa a zvuku.

H265SingleBitrate1080p

string

Vytvoří soubor MP4, ve kterém je video kódované pomocí kodeku H.265 při 3500 kb/s a výšky obrázku 1080 pixelů a stereofonní zvuk je kódovaný kodekem AAC-LC ve formátu 128 kb/s.

H265SingleBitrate4K

string

Vytvoří soubor MP4, ve kterém je video zakódované pomocí kodeku H.265 v rozlišení 9500 kb/s a výšky obrázku 2160 pixelů a stereofonní zvuk je kódovaný kodekem AAC-LC rychlostí 128 kb/s.

H265SingleBitrate720p

string

Vytvoří soubor MP4, kde je video zakódované pomocí kodeku H.265 při 1800 kb/s a výšky obrázku 720 pixelů a stereofonní zvuk je kódovaný kodekem AAC-LC rychlostí 128 kb/s.

EntropyMode

Režim entropie, který se má použít pro tuto vrstvu. Pokud není zadán, kodér zvolí režim, který je vhodný pro profil a úroveň.

Name Typ Description
Cabac

string

Kódování entropie CABAC (Context Adaptive Binary Binary Aritmetic Coder).

Cavlc

string

Kódování entropie jazyka CAVLC (Context Adaptive Variable Length Coder).

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Typ další informace.

ErrorDetail

Podrobnosti o chybě

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

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.Media.FaceDetectorPreset

Diskriminátor pro odvozené typy.

blurType

BlurType

Typ rozostření

experimentalOptions

object

Slovník obsahující páry hodnot klíčů pro parametry, které nejsou zpřístupněny v samotné předvolbě

mode

FaceRedactorMode

Tento režim poskytuje možnost výběru mezi následujícími nastaveními: 1) Analyzovat – pouze pro detekci. Tento režim vygeneruje soubor JSON s metadaty označující vzhled tváří v celém videu. Tam, kde je to možné, se vzhledy stejné osoby přiřadí ke stejnému ID. 2) Kombinace – navíc rediguje (rozostřuje) rozpoznané tváře. 3) Redigovat – to umožňuje 2-pass proces, který umožňuje selektivní redakci podmnožinu detekovaných tváří. Převezme soubor metadat z předchozího průchodu analýzy spolu se zdrojovým videem a uživatelem vybranou podmnožinou ID, která vyžadují redigování.

resolution

AnalysisResolution

Určuje maximální rozlišení, při kterém se video analyzuje. Výchozí chování je SourceResolution, což při analýze zachová vstupní video v původním rozlišení. Použitím standardu "StandardDefinition" změníte velikost vstupních videí na standardní definici při zachování příslušného poměru stran. Velikost se změní jenom v případě, že má video vyšší rozlišení. Například vstup 1920 × 1080 by se před zpracováním škáloval na 640 × 360. Přepnutím na StandardDefinition se zkrátí doba potřebná ke zpracování videa ve vysokém rozlišení. Může také snížit náklady na používání této komponenty (podrobnosti viz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Tváře, které budou ve změně velikosti videa příliš malé, ale nemusí být rozpoznány.

FaceRedactorMode

Tento režim poskytuje možnost výběru mezi následujícími nastaveními: 1) Analyzovat – pouze pro detekci. Tento režim vygeneruje soubor JSON s metadaty označující vzhled tváří v celém videu. Tam, kde je to možné, se vzhledy stejné osoby přiřadí ke stejnému ID. 2) Kombinace – navíc rediguje (rozostřuje) rozpoznané tváře. 3) Redigovat – to umožňuje 2-pass proces, který umožňuje selektivní redakci podmnožinu detekovaných tváří. Převezme soubor metadat z předchozího průchodu analýzy spolu se zdrojovým videem a uživatelem vybranou podmnožinou ID, která vyžadují redigování.

Name Typ Description
Analyze

string

Režim analýzy detekuje tváře a vypíše soubor metadat s výsledky. Umožňuje úpravy souboru metadat před rozostřením tváří v režimu redigování.

Combined

string

Kombinovaný režim provádí kroky Analyzovat a Redigovat jedním průchodem, když není úprava analyzovaných tváří žádoucí.

Redact

string

Režim redigování využívá soubor metadat z režimu Analyzovat a rediguje nalezené tváře.

Fade

Popisuje vlastnosti efektu Fade použitého na vstupní médium.

Name Typ Description
duration

string

The Duration of the fade effect in the video. Hodnota může být ve formátu ISO 8601 (například PT05S k vyblednutí barvy in/out během 5 sekund) nebo počet snímků (například 10 snímků od začátku) nebo relativní hodnota k době trvání streamu (například 10 %, aby zeslámlala 10 % doby trvání datového proudu).

fadeColor

string

Barva pro slábnutí in/out. může být v barvách https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords CSS Level1 nebo v hodnotě RGB/hex: například rgb(255,0,0), 0xFF0000 nebo #FF0000

start

string

Pozice ve vstupním videu, odkud se má začít slábnout. Hodnota může být ve formátu ISO 8601 (například PT05S začínat na 5 sekundách) nebo počet snímků (například 10 pro začátek od 10. rámce) nebo relativní hodnota doby trvání datového proudu (například 10 % pro začátek na 10 % doby trvání datového proudu). Výchozí hodnota je 0.

Filters

Popisuje všechny operace filtrování, jako je zrušení prokládání, otočení atd., které se mají použít na vstupní médium před kódováním.

Name Typ Description
crop

Rectangle

Parametry obdélníkového okna, pomocí kterého chcete oříznout vstupní video.

deinterlace

Deinterlace

Nastavení de-interlacing.

fadeIn

Fade

Popisuje vlastnosti efektu Prolnutí použitého na vstupní médium.

fadeOut

Fade

Popisuje vlastnosti efektu Prolnutí použitého na vstupní médium.

overlays Overlay[]:

Vlastnosti překryvů, které se mají použít u vstupního videa. Můžou to být překryvy zvuku, obrázku nebo videa.

rotation

Rotation

Otočení, pokud existuje, které se použije u vstupního videa před jeho zakódování. Výchozí hodnota je Auto

H264Complexity

Říká kodéru, jak zvolit nastavení kódování. Výchozí hodnota je Vyvážená.

Name Typ Description
Balanced

string

Říká kodéru, aby používal nastavení, která zajistí rovnováhu mezi rychlostí a kvalitou.

Quality

string

Říká kodéru, aby používal nastavení optimalizovaná pro vyšší kvalitu výstupu na úkor zpomalení celkového času kódování.

Speed

string

Řekne kodéru, aby používal nastavení optimalizovaná pro rychlejší kódování. Kvalita se obětuje, aby se zkrátila doba kódování.

H264Layer

Popisuje nastavení, která se mají použít při kódování vstupního videa do požadované výstupní vrstvy přenosové rychlosti pomocí kodeku videa H.264.

Name Typ Description
adaptiveBFrame

boolean

Určuje, jestli se při kódování této vrstvy mají použít adaptivní rámce B. Pokud ho nezadáte, kodér ho zapne vždy, když profil videa povolí jeho použití.

bFrames

integer

Počet snímků B, které se mají použít při kódování této vrstvy. Pokud není zadaný, kodér zvolí odpovídající číslo na základě profilu a úrovně videa.

bitrate

integer

Průměrná přenosová rychlost v bitech za sekundu, při které se má při generování této vrstvy zakódovat vstupní video. Toto je povinné pole.

bufferWindow

string

Délka okna vyrovnávací paměti VBV. Hodnota by měla být ve formátu ISO 8601. Hodnota by měla být v rozsahu [0,1–100] sekund. Výchozí hodnota je 5 sekund (například PT5S).

crf

number

Hodnota CRF, která se má použít při kódování této vrstvy. Toto nastavení se projeví, když je rateControlMode video kodeku nastaven v režimu CRF. Rozsah hodnot CRF je v rozmezí od 0 do 51, přičemž nižší hodnoty by můžou vést k lepší kvalitě na úkor větších velikostí souborů. Vyšší hodnoty znamenají větší kompresi, ale v určitém okamžiku si všimnete snížení kvality. Výchozí hodnota je 23.

entropyMode

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

H264VideoProfile

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.Media.H264Video

Diskriminátor pro odvozené typy.

complexity

H264Complexity

Říká kodéru, jak zvolit nastavení kódování. Výchozí hodnota je Vyvážená.

keyFrameInterval

string

Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadanou ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení je ignorováno, pokud je nastaven VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat podle nastavení vstupního zdroje.

label

string

Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu.

layers

H264Layer[]

Kolekce výstupních vrstev H.264, které mají být vytvořeny kodérem.

rateControlMode

H264RateControlMode

Režim řízení rychlosti videa

sceneChangeDetection

boolean

Zda má kodér vložit klíčové snímky při změně scény. Pokud není zadán, výchozí hodnota je false. Tento příznak by měl být nastaven na hodnotu true pouze v případě, že je kodér nakonfigurován tak, aby vytvořil jedno výstupní video.

stretchMode

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

VideoSyncMode

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

H265VideoProfile

V současné době podporujeme Main. Výchozí hodnota je Automaticky.

referenceFrames

integer

Počet referenčních rámců, které se mají použít při kódování této vrstvy. Pokud není zadán, kodér určí odpovídající číslo na základě nastavení složitosti kodéru.

slices

integer

Počet řezů, které se mají použít při kódování této vrstvy. Pokud není zadán, výchozí hodnota je nula, což znamená, že kodér použije pro každý snímek jeden řez.

width

string

Šířka výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má poloviční šířku než vstup.

H265Video

Popisuje všechny vlastnosti kódování videa pomocí kodeku H.265.

Name Typ Description
@odata.type string:

#Microsoft.Media.H265Video

Diskriminátor pro odvozené typy.

complexity

H265Complexity

Říká kodéru, jak zvolit nastavení kódování. Kvalita zajistí vyšší kompresní poměr, ale s vyššími náklady a delší výpočetní dobu. Rychlost vytvoří relativně větší soubor, ale je rychlejší a úspornější. Výchozí hodnota je Vyvážená.

keyFrameInterval

string

Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadanou ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení je ignorováno, pokud je nastaven VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat podle nastavení vstupního zdroje.

label

string

Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu.

layers

H265Layer[]

Kolekce výstupních vrstev H.265, které má kodér vytvořit.

sceneChangeDetection

boolean

Určuje, zda má kodér vložit klíčové snímky při změnách scény. Pokud není zadán, výchozí hodnota je false. Tento příznak by měl být nastaven na hodnotu true pouze v případě, že je kodér nakonfigurován tak, aby vytvořil jedno výstupní video.

stretchMode

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

VideoSyncMode

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.Media.Image

Diskriminátor pro odvozené typy.

keyFrameInterval

string

Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadanou ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení je ignorováno, pokud je nastaven VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat podle nastavení vstupního zdroje.

label

string

Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu.

range

string

Pozice vzhledem k času spuštění přednastavené transformace ve vstupním videu, na kterém se mají zastavit generování miniatur. Hodnota může být ve formátu ISO 8601 (například PT5M30S zastavit v 5 minutách a 30 sekundách od počátečního času) nebo počet snímků (například 300 k zastavení na 300. snímku od rámce při zahájení. Pokud je tato hodnota 1, znamená to, že se při zahájení vytvoří jenom jedna miniatura) nebo relativní hodnota k době trvání streamu (například 50 % pro zastavení na polovinu doby trvání datového proudu od počátečního času). Výchozí hodnota je 100 %, což znamená zastavit na konci datového proudu.

start

string

Pozice ve vstupním videu, odkud se mají začít generovat miniatury. Hodnota může být ve formátu ISO 8601 (například PT05S začínat na 5 sekundách) nebo počet snímků (například 10 pro začátek od 10. rámce) nebo relativní hodnota doby trvání datového proudu (například 10 % pro začátek na 10 % doby trvání datového proudu). Podporuje také makro {Best}, které kodéru říká, že má vybrat nejlepší miniaturu z prvních několika sekund videa, a vytvoří pouze jednu miniaturu bez ohledu na to, jaká jsou další nastavení pro krok a rozsah. Výchozí hodnota je makro {Best}.

step

string

Intervaly, ve kterých se generují miniatury. Hodnota může být ve formátu ISO 8601 (například PT05S pro jeden obrázek každých 5 sekund) nebo počet snímků (například 30 pro jeden obrázek každých 30 snímků) nebo relativní hodnota doby trvání datového proudu (například 10 % pro jeden obrázek každých 10 % doby trvání datového proudu). Poznámka: Hodnota kroku bude mít vliv na první vygenerovanou miniaturu, což nemusí být přesně ta zadaná při počátečním čase přednastavení transformace. Důvodem je kodér, který se snaží vybrat nejlepší miniaturu mezi časem zahájení a umístěním kroku z počátečního času jako první výstup. Vzhledem k tomu, že výchozí hodnota je 10 %, znamená to, že pokud má stream dlouhou dobu trvání, může být první vygenerovaná miniatura vzdálená od miniatury zadané při spuštění. Zkuste vybrat přiměřenou hodnotu pro Krok, pokud se očekává, že se první miniatura blíží času zahájení, nebo nastavte hodnotu Rozsah na 1, pokud je v době zahájení potřeba pouze jedna miniatura.

stretchMode

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

VideoSyncMode

Režim synchronizace videa

ImageFormat

Popisuje vlastnosti výstupního souboru obrázku.

Name Typ Description
@odata.type string:

#Microsoft.Media.ImageFormat

Diskriminátor pro odvozené typy.

filenamePattern

string

Vzor pojmenování souborů použitý k vytvoření výstupních souborů V názvu souboru jsou podporována následující makra: {Basename} – rozšiřující makro, které bude používat název vstupního videosouboru. Pokud je základní název (přípona souboru není zahrnuta) vstupního videosouboru kratší než 32 znaků, použije se základní název vstupních videosouborů. Pokud délka základního názvu vstupního videosouboru přesahuje 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušné rozšíření pro tento formát. {Label} – popisek přiřazený kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začíná od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ kodeku pro zvuk/video. {Resolution} – rozlišení videa. Všechna nesubstituovaná makra se sbalí a odeberou z názvu souboru.

InsightsType

Definuje typ přehledů, které má služba generovat. Povolené hodnoty jsou AudioInsightsOnly, VideoInsightsOnly a AllInsights. Výchozí hodnota je AllInsights. Pokud tuto možnost nastavíte na AllInsights a vstup bude jenom zvuk, vygenerují se jenom zvukové přehledy. Podobně pokud je vstupem jenom video, vygenerují se jenom přehledy videa. Doporučujeme nepoužívat AudioInsightsOnly, pokud očekáváte, že některé vaše vstupy budou pouze video; nebo použijte VideoInsightsOnly, pokud očekáváte, že některé vstupy budou jenom zvukové. Vaše úlohy v takových podmínkách by došlo k chybě.

Name Typ Description
AllInsights

string

Vygenerujte přehledy zvuku i videa. Selže, pokud se nezdaří přehledy zvuku nebo videa.

AudioInsightsOnly

string

Generování pouze zvukových přehledů Ignorovat video, i když je k dispozici. Pokud není k dispozici žádný zvuk, selže.

VideoInsightsOnly

string

Vygenerujte pouze přehledy videa. Ignorovat zvuk, pokud je k dispozici. Pokud není k dispozici žádné video, selže.

InterleaveOutput

Nastaví režim prokládání výstupu tak, aby se ovládl způsob ukládání zvuku a videa ve formátu kontejneru. Příklad: Nastavte InterleavedOutput jako NonInterleavedOutput, aby se v samostatných souborech MP4 vytvářely výstupy jen pro zvuk a video.

Name Typ Description
InterleavedOutput

string

Výstup zahrnuje zvuk i video.

NonInterleavedOutput

string

Výstup je jenom video nebo jenom zvuk.

JpgFormat

Popisuje nastavení pro vytváření miniatur JPEG.

Name Typ Description
@odata.type string:

#Microsoft.Media.JpgFormat

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.Media.JpgImage

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

JpgLayer[]

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

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

VideoSyncMode

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.Media.Mp4Format

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

OutputFile[]

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.Media.MultiBitrateFormat

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

OutputFile[]

Seznam výstupních souborů, které se mají vytvořit. Každá položka v seznamu je sada popisků vrstvy zvuku a videa, které se mají směšovat dohromady .

OnErrorType

Transformace může definovat více než jeden výstup. Tato vlastnost definuje, co má služba dělat, když jeden výstup selže – buď pokračovat ve vytváření dalších výstupů, nebo zastavit ostatní výstupy. Celkový stav úlohy nebude odrážet selhání výstupů zadaných pomocí continuejob. Výchozí hodnota je StopProcessingJob.

Name Typ Description
ContinueJob

string

Sděluje službě, že pokud tento objekt TransformOutput selže, povolí pokračování jakéhokoli jiného objektu TransformOutput.

StopProcessingJob

string

Sděluje službě, že pokud tento objekt TransformOutput selže, je možné zastavit všechny ostatní neúplné objekty TransformOutput.

OutputFile

Představuje vytvořený výstupní soubor.

Name Typ Description
labels

string[]

Seznam popisků, které popisují, jak má kodér multiplexovat video a zvuk do výstupního souboru. Pokud kodér například vytváří dvě vrstvy videa s popisky v1 a v2 a jednu zvukovou vrstvu s popiskem a1, pak pole jako [v1, a1] řekne kodéru, aby vytvořil výstupní soubor se stopou videa reprezentovanou v1 a zvukovou stopou reprezentovanou a1.

PngFormat

Popisuje nastavení pro vytváření miniatur PNG.

Name Typ Description
@odata.type string:

#Microsoft.Media.PngFormat

Diskriminátor pro odvozené typy.

filenamePattern

string

Vzor pojmenování souborů použitý k vytvoření výstupních souborů V názvu souboru jsou podporována následující makra: {Basename} – rozšiřující makro, které bude používat název vstupního videosouboru. Pokud je základní název (přípona souboru není zahrnuta) vstupního videosouboru kratší než 32 znaků, použije se základní název vstupních videosouborů. Pokud délka základního názvu vstupního videosouboru překročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru.

PngImage

Popisuje vlastnosti pro vytvoření řady obrázků PNG ze vstupního videa.

Name Typ Description
@odata.type string:

#Microsoft.Media.PngImage

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

PngLayer[]

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

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

VideoSyncMode

Režim synchronizace videa

PngLayer

Popisuje nastavení pro vytvoření obrázku PNG ze vstupního videa.

Name Typ Description
height

string

Výška výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má o polovinu tolik pixelů na výšku než vstup.

label

string

Alfanumerický popisek této vrstvy, který lze použít při multiplexování různých vrstev videa a zvuku nebo při pojmenování výstupního souboru.

width

string

Šířka výstupního videa pro tuto vrstvu Hodnota může být absolutní (v pixelech) nebo relativní (v procentech). Například 50 % znamená, že výstupní video má poloviční šířku než vstup.

PresetConfigurations

Objekt volitelného nastavení konfigurace kodéru.

Name Typ Description
complexity

Complexity

Umožňuje nakonfigurovat nastavení kodéru pro řízení rovnováhy mezi rychlostí a kvalitou. Příklad: Pokud chcete rychlejší kódování, ale menší efektivitu komprese, nastavte na hodnotu Complexity (Složitost) na hodnotu Speed (Rychlost).

interleaveOutput

InterleaveOutput

Nastaví režim prokládání výstupu tak, aby se ovládl způsob ukládání zvuku a videa ve formátu kontejneru. Příklad: Nastavte InterleavedOutput jako NonInterleavedOutput, aby se v samostatných souborech MP4 vytvářely výstupy pouze pro zvuk a video.

keyFrameIntervalInSeconds

number

Interval klíčového snímku v sekundách. Příklad: Nastavením hodnoty KeyFrameIntervalInSeconds na hodnotu 2 omezíte ukládání do vyrovnávací paměti přehrávání u některých přehrávačů.

maxBitrateBps

integer

Maximální přenosová rychlost v bitech za sekundu (prahová hodnota pro horní vrstvu videa). Příklad: Nastavte hodnotu MaxBitrateBps na 6000000, abyste zabránili vytváření výstupů s velmi vysokou přenosovou rychlostí pro obsah s vysokou složitostí.

maxHeight

integer

Maximální výška výstupních vrstev videa Příklad: Nastavení hodnoty MaxHeight jako 720 pro vytváření výstupních vrstev až do 720P, i když je vstup 4K.

maxLayers

integer

Maximální počet výstupních vrstev videa. Příklad: Nastavte Hodnotu MaxLayers na hodnotu 4, abyste měli jistotu, že se vytvoří maximálně 4 výstupní vrstvy, které řídí celkové náklady na úlohu kódování.

minBitrateBps

integer

Minimální přenosová rychlost v bitech za sekundu (prahová hodnota pro dolní vrstvu videa). Příklad: Nastavte MinBitrateBps na 200000 tak, aby měla dolní vrstvu, která pokrývá uživatele s malou šířkou pásma sítě.

minHeight

integer

Minimální výška výstupních vrstev videa. Příklad: Nastavte MinHeight na 360, abyste se vyhnuli výstupním vrstvám s menšími rozlišeními, jako je 180P.

Priority

Nastaví relativní prioritu TransformOutputs v rámci transformace. Tím se nastaví priorita, kterou služba používá ke zpracování TransformOutputs. Výchozí priorita je Normální.

Name Typ Description
High

string

Používá se pro transformoutputy, které by měly mít přednost před ostatními.

Low

string

Používá se pro TransformOutputs, které lze generovat po normální a vysoké prioritě TransformOutputs.

Normal

string

Používá se pro transformoutputy, které lze generovat s normální prioritou.

Rectangle

Popisuje vlastnosti obdélníkového okna použitého na vstupní médium před jeho zpracováním.

Name Typ Description
height

string

Výška obdélníkové oblasti v pixelech Může to být absolutní hodnota pixelů (např. 100) nebo relativní vzhledem k velikosti videa (například 50 %).

left

string

Počet pixelů od levého okraje Může to být absolutní hodnota pixelů (např. 100) nebo relativní vzhledem k velikosti videa (například 50 %).

top

string

Počet pixelů od horního okraje. Může to být absolutní hodnota pixelů (např. 100) nebo relativní vzhledem k velikosti videa (například 50 %).

width

string

Šířka obdélníkové oblasti v pixelech. Může to být absolutní hodnota pixelů (např. 100) nebo relativní vzhledem k velikosti videa (například 50 %).

Rotation

Případné otočení, které se má použít u vstupního videa před kódováním. Výchozí hodnota je Automaticky.

Name Typ Description
Auto

string

Automaticky zjišťovat a otáčet podle potřeby.

None

string

Video neotáčíte. Pokud to výstupní formát podporuje, všechna metadata o rotaci zůstanou beze změny.

Rotate0

string

Neobměňujte video, ale odeberte všechna metadata o otáčení.

Rotate180

string

Otočte o 180 stupňů po směru hodinových ručiček.

Rotate270

string

Otočte o 270 stupňů po směru hodinových ručiček.

Rotate90

string

Otočte o 90 stupňů po směru hodinových ručiček.

StandardEncoderPreset

Popisuje všechna nastavení, která se mají použít při kódování vstupního videa pomocí standardního kodéru.

Name Typ Description
@odata.type string:

#Microsoft.Media.StandardEncoderPreset

Diskriminátor pro odvozené typy.

codecs Codec[]:

Seznam kodeků, které se mají použít při kódování vstupního videa.

experimentalOptions

object

Slovník obsahující páry hodnot klíčů pro parametry, které nejsou zpřístupněny v samotné předvolbě

filters

Filters

Jedna nebo více operací filtrování, které jsou použity na vstupní médium před kódováním.

formats Format[]:

Seznam výstupů, které má kodér vytvořit.

StretchMode

Režim změny velikosti – změna velikosti vstupního videa tak, aby odpovídala požadovaným výstupním rozlišením. Výchozí nastavení je automatické nastavení velikosti.

Name Typ Description
AutoFit

string

Vložte výstup (pomocí pole letterbox nebo pillar box) a respektujte rozlišení výstupu a zároveň se ujistěte, že aktivní oblast videa ve výstupu má stejný poměr stran jako vstup. Pokud je například vstup 1920 × 1080 a předvolba kódování požaduje 1280 × 1280 , výstup bude ve formátu 1280 × 1280, který obsahuje vnitřní obdélník 1280 × 720 v poměru stran 16:9 a oblasti polí sloupků o šířce 280 pixelů vlevo a vpravo.

AutoSize

string

Přepište rozlišení výstupu a změňte ho tak, aby odpovídalo poměru stran zobrazení vstupu bez odsazení. Pokud je například vstup 1920 × 1080 a předvolba kódování požaduje 1280 × 1280 , pak se hodnota v předvolbě přepíše a výstup bude na hodnotě 1280x720, což zachovává poměr stran vstupu 16:9.

None

string

Striktně respektujte rozlišení výstupu bez ohledu na poměr stran pixelů nebo poměr stran zobrazení vstupního videa.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC)

createdBy

string

Identita, která vytvořila prostředek.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.

Transform

Transformace zapouzdřuje pravidla nebo instrukce pro generování požadovaných výstupů ze vstupního média, například překódováním nebo extrahováním přehledů. Po vytvoření transformace se dá použít na vstupní médium vytvořením úloh.

Name Typ Description
id

string

Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku}

name

string

Název prostředku

properties.created

string

Datum a čas vytvoření transformace v UTC ve formátu RRRR-MM-DDThh:mm:ssZ.

properties.description

string

Volitelný podrobný popis transformace.

properties.lastModified

string

Datum a čas UTC, kdy byla transformace naposledy aktualizována, ve formátu "RRRR-MM-DDThh:mm:ssZ".

properties.outputs

TransformOutput[]

Pole jednoho nebo více objektů TransformOutput, které má transformace vygenerovat.

systemData

systemData

Systémová metadata vztahující se k tomuto prostředku.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

TransformOutput

Popisuje vlastnosti TransformOutput, což jsou pravidla, která se mají použít při generování požadovaného výstupu.

Name Typ Description
onError

OnErrorType

Transformace může definovat více než jeden výstup. Tato vlastnost definuje, co má služba dělat, když jeden výstup selže – buď pokračovat ve vytváření dalších výstupů, nebo zastavit ostatní výstupy. Celkový stav úlohy nebude odrážet selhání výstupů zadaných pomocí continuejob. Výchozí hodnota je StopProcessingJob.

preset Preset:

Předvolba, která popisuje operace, které se použijí k úpravě, překódování nebo extrahování přehledů ze zdrojového souboru za účelem vygenerování výstupu.

relativePriority

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í.

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.Media.TransportStreamFormat

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

OutputFile[]

Seznam výstupních souborů, které se mají vytvořit. Každá položka v seznamu je sada popisků vrstvy zvuku a videa, které se mají směšovat dohromady .

Video

Popisuje základní vlastnosti kódování vstupního videa.

Name Typ Description
@odata.type string:

#Microsoft.Media.Video

Diskriminátor pro odvozené typy.

keyFrameInterval

string

Vzdálenost mezi dvěma klíčovými snímky. Hodnota by měla být nenulová v rozsahu [0,5, 20] sekund zadanou ve formátu ISO 8601. Výchozí hodnota je 2 sekundy (PT2S). Všimněte si, že toto nastavení je ignorováno, pokud je nastaven VideoSyncMode.Passthrough, kde hodnota KeyFrameInterval bude následovat podle nastavení vstupního zdroje.

label

string

Volitelný popisek kodeku. Popisek se dá použít k řízení chování muxingu.

stretchMode

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

VideoSyncMode

Režim synchronizace videa

VideoAnalyzerPreset

Předvolba analyzátoru videa, která extrahuje přehledy (bohatá metadata) ze zvuku i videa a vypíše soubor formátu JSON.

Name Typ Description
@odata.type string:

#Microsoft.Media.VideoAnalyzerPreset

Diskriminátor pro odvozené typy.

audioLanguage

string

Jazyk datové části zvuku ve vstupu ve formátu BCP-47 jazyka tag-region (např. en-US). Pokud znáte jazyk obsahu, doporučujeme ho zadat. Jazyk musí být určen explicitně pro AudioAnalysisMode::Basic, protože automatické rozpoznávání jazyka není součástí základního režimu. Pokud jazyk není zadaný nebo nastavený na hodnotu null, automatické rozpoznávání jazyka zvolí první zjištěný jazyk a zpracuje ho s vybraným jazykem po dobu trvání souboru. V současné době nepodporuje dynamické přepínání mezi jazyky po zjištění prvního jazyka. Automatická detekce funguje nejlépe se zvukovými záznamy s jasně rozpoznatelnou řečí. Pokud se automatickému zjišťování nepodaří najít jazyk, přepis se vrátí do en-US. Seznam podporovaných jazyků je k dispozici tady: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

Slovník obsahující páry hodnot klíčů pro parametry, které nejsou zpřístupněny v samotné předvolbě

insightsToExtract

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 přehledy zvuku. Podobně pokud je vstupem pouze video, pak se generují pouze přehledy videa. Doporučujeme nepoužívat AudioInsightsOnly, pokud očekáváte, že některé vstupy budou pouze video; nebo použijte VideoInsightsPokud očekáváte, že některé vstupy budou jenom zvukové. Vaše úlohy za takových podmínek by se zobrazily s chybou.

mode

AudioAnalysisMode

Určuje sadu operací analýzy zvuku, které mají být provedeny. Pokud není zadán, bude zvolena možnost Standard AudioAnalysisMode.

VideoOverlay

Popisuje vlastnosti překryvného videa.

Name Typ Description
@odata.type string:

#Microsoft.Media.VideoOverlay

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

Rectangle

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

Rectangle

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.