Sdílet prostřednictvím


Transforms - Update

Aktualizovat transformaci
Aktualizace transformace.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
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.

Text požadavku

Name Vyžadováno Typ Description
properties.outputs True

TransformOutput[]

Pole s jedním nebo více objekty TransformOutputs, které by měla transformace vygenerovat.

properties.description

string

Volitelný podrobný popis transformace.

Odpovědi

Name Typ Description
200 OK

Transform

OK

Other Status Codes

ErrorResponse

Podrobné informace o chybě

Příklady

Update a Transform.

Ukázkový požadavek

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

{
  "properties": {
    "description": "Example transform to illustrate update.",
    "outputs": [
      {
        "relativePriority": "High",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "H264MultipleBitrate720p"
        }
      }
    ]
  }
}

Ukázková odpověď

{
  "name": "transformToUpdate",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/transformToUpdate",
  "type": "Microsoft.Media/mediaservices/transforms",
  "properties": {
    "created": "2022-10-17T23:14:32.1435128Z",
    "description": "Example transform to illustrate update.",
    "lastModified": "2022-10-17T23:14:32.1455494Z",
    "outputs": [
      {
        "onError": "StopProcessingJob",
        "relativePriority": "High",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "H264MultipleBitrate720p"
        }
      }
    ]
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:32.1435128Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:32.1455494Z"
  }
}

Definice

Name Description
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, které při analýze zachová vstupní video v původním rozlišení. Při použití standardu "StandardDefinition" změníte velikost vstupních videí na standardní definici při zachování příslušného poměru stran. Velikost se změní jenom v případě, že má video vyšší rozlišení. Například vstup 1920x1080 by se před zpracováním škáloval na 640x360. Přepnutím na StandardDefinition se zkrátí doba potřebná ke zpracování videa ve vysokém rozlišení. Může také snížit náklady na používání této komponenty (podrobnosti viz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Tváře, které jsou ve videu se změněnou velikostí příliš malé, ale nemusí být rozpoznány.

Audio

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

AudioAnalysisMode

Určuje sadu operací analýzy zvuku, které se mají provést. Pokud není zadáno, 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 při: 32K/44.1K/48K Hz; Hodnoty přenosových rychlostí zvuku, které podporuje specifikace AC3: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 b/s.

Deinterlace

Popisuje nastavení prokládání.

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 má použít 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 umožňuje zvolit mezi následujícími nastaveními: 1) Analyzovat – pouze pro detekci. Tento režim vygeneruje soubor JSON metadat označující vzhled tváří v celém videu. Pokud je to možné, přiřazuje se vzhledům stejné osoby stejné ID. 2) Kombinace – navíc rediguje (rozostřuje) rozpoznané tváře. 3) Redact – to umožňuje 2-pass proces, který umožňuje selektivní redakci podmnožina detekovaných tváří. Přebírá soubor metadat z předchozího předání analýzy spolu se zdrojovým videem a uživatelem vybranou podmnožinou ID, která vyžadují redigování.

Fade

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

Filters

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

H264Complexity

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

H264Layer

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

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 zarovnané souborů s více přenosovými rychlostmi. Výchozím chováním je vytvoření jednoho výstupního souboru pro každou vrstvu videa, která se směšuje se všemi zvuky. Přesné výstupní soubory lze řídit zadáním outputFiles kolekce.

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 s volitelným nastavením konfigurace kodéru.

Priority

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

Rectangle

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

Rotation

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

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ů přenosového proudu MPEG-2 (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ýstupního zakódovaného zvuku (v bitech za sekundu).

channels

integer

Počet kanálů ve zvuku.

label

string

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

profile

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

AacAudioProfile

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

Name Typ Description
AacLc

string

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

HeAacV1

string

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

HeAacV2

string

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

AnalysisResolution

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

Name Typ Description
SourceResolution

string

StandardDefinition

string

Audio

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

Name Typ Description
@odata.type string:

#Microsoft.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é se mají provést. Pokud není zadáno, bude zvolena možnost Standard AudioAnalysisMode.

Name Typ Description
Basic

string

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

Standard

string

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

AudioAnalyzerPreset

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

Name Typ Description
@odata.type string:

#Microsoft.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

Č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.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 při: 32K/44.1K/48K Hz; Hodnoty přenosových rychlostí zvuku, které podporuje specifikace AC3: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 b/s.

Name Typ Description
@odata.type string:

#Microsoft.Media.DDAudio

Diskriminátor pro odvozené typy.

bitrate

integer

Přenosová rychlost výstupního zakódovaného zvuku (v bitech za sekundu).

channels

integer

Počet kanálů ve zvuku.

label

string

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

samplingRate

integer

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

Deinterlace

Popisuje nastavení prokládání.

Name Typ Description
mode

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 má použít pro kódování videí.

Name Typ Description
AACGoodQualityAudio

string

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

AdaptiveStreaming

string

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

ContentAwareEncoding

string

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

ContentAwareEncodingExperimental

string

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

CopyAllBitrateNonInterleaved

string

Zkopírujte všechny video a zvukové streamy ze vstupního prostředku jako neprokládané výstupní video a zvukové výstupní soubory. Tuto předvolbu můžete použít k oříznutí existujícího prostředku nebo k převodu souborů MP4 zarovnaných do skupiny klíčových snímků (GOP) jako prostředku, který lze streamovat.

DDGoodQualityAudio

string

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

H264MultipleBitrate1080p

string

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

H264MultipleBitrate720p

string

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

H264MultipleBitrateSD

string

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

H264SingleBitrate1080p

string

Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.264 rychlostí 6750 kb/s a výškou obrázku 1080 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s.

H264SingleBitrate720p

string

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

H264SingleBitrateSD

string

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

H265AdaptiveStreaming

string

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

H265ContentAwareEncoding

string

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

H265SingleBitrate1080p

string

Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.265 rychlostí 3500 kb/s a výškou obrázku 1080 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s.

H265SingleBitrate4K

string

Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.265 při 9500 kb/s a výškou obrázku 2160 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s.

H265SingleBitrate720p

string

Vytvoří soubor MP4, ve kterém je video kódováno kodekem H.265 rychlostí 1800 kb/s a výškou obrázku 720 pixelů a stereofonní zvuk je kódován kodekem AAC-LC rychlostí 128 kb/s.

EntropyMode

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

Name Typ Description
Cabac

string

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

Cavlc

string

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

ErrorAdditionalInfo

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

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě

Name Typ Description
additionalInfo

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 umožňuje zvolit mezi následujícími nastaveními: 1) Analyzovat – pouze pro detekci. Tento režim vygeneruje soubor JSON metadat označující vzhled tváří v celém videu. Pokud je to možné, přiřazuje se vzhledům stejné osoby stejné ID. 2) Kombinace – navíc rediguje (rozostřuje) rozpoznané tváře. 3) Redact – to umožňuje 2-pass proces, který umožňuje selektivní redakci podmnožina detekovaných tváří. Přebírá soubor metadat z předchozího předání analýzy spolu se zdrojovým videem a uživatelem vybranou podmnožinou ID, která vyžadují redigování.

Name Typ Description
Analyze

string

Režim analyzovat rozpozná tváře a vypíše soubor metadat s výsledky. Umožňuje úpravy souboru metadat před rozostřením tváří v režimu Redact.

Combined

string

Kombinovaný režim provádí kroky Analyzovat a Redact najednou, když není žádoucí upravovat analyzované tváře.

Redact

string

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

Fade

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

Name Typ Description
duration

string

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

fadeColor

string

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

start

string

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

Filters

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

Name Typ Description
crop

Rectangle

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

deinterlace

Deinterlace

Nastavení prokládání.

fadeIn

Fade

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

fadeOut

Fade

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

Rotation

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

H264Complexity

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

Name Typ Description
Balanced

string

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

Quality

string

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

Speed

string

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

H264Layer

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

Name Typ Description
adaptiveBFrame

boolean

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

bFrames

integer

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

bitrate

integer

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

bufferWindow

string

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

crf

number

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

entropyMode

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 má zvolit nastavení kódování. Výchozí hodnota je Vyvážené.

keyFrameInterval

string

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

label

string

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

layers

H264Layer[]

Kolekce výstupních vrstev H.264 produkovaných kodérem.

rateControlMode

H264RateControlMode

Režim řízení rychlosti videa

sceneChangeDetection

boolean

Určuje, zda má kodér při změnách scény vkládat klíčové snímky. Pokud není zadaný, výchozí hodnota je false. Tento příznak by měl být nastavený na hodnotu true pouze v případě, že kodér konfiguruje vytvoření jednoho výstupního videa.

stretchMode

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

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

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

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řekročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru.

InsightsType

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

Name Typ Description
AllInsights

string

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

AudioInsightsOnly

string

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

VideoInsightsOnly

string

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

InterleaveOutput

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

Name Typ Description
InterleavedOutput

string

Výstup zahrnuje zvuk i video.

NonInterleavedOutput

string

Výstup je jenom video nebo jenom zvuk.

JpgFormat

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

Name Typ Description
@odata.type string:

#Microsoft.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řekročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru.

JpgImage

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

Name Typ Description
@odata.type string:

#Microsoft.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 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

JpgLayer[]

Kolekce výstupních vrstev obrázků JPEG, které budou vytvořeny kodérem.

range

string

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

spriteColumn

integer

Nastaví počet sloupců použitých v obrázku miniatury spritu. Počet řádků se vypočítá automaticky a vygeneruje se soubor VTT s mapováním souřadnic pro každou miniaturu v spritu. Poznámka: Tato hodnota by měla být kladné celé číslo a doporučuje se správná hodnota, aby rozlišení výstupního obrázku nepřesáhla limit maximálního rozlišení pixelů JPEG 65535 × 65535.

start

string

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

step

string

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

stretchMode

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

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řekročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru.

outputFiles

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

MultiBitrateFormat

Popisuje vlastnosti pro vytvoření kolekce gop zarovnané souborů s více přenosovými rychlostmi. Výchozím chováním je vytvoření jednoho výstupního souboru pro každou vrstvu videa, která se směšuje se všemi zvuky. Přesné výstupní soubory lze řídit zadáním outputFiles kolekce.

Name Typ Description
@odata.type string:

#Microsoft.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řekročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru.

outputFiles

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

OnErrorType

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

Name Typ Description
ContinueJob

string

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

StopProcessingJob

string

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

OutputFile

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

Name Typ Description
labels

string[]

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

PngFormat

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

Name Typ Description
@odata.type string:

#Microsoft.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 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

PngLayer[]

Kolekce výstupních vrstev obrázků PNG, které budou vytvořeny kodérem.

range

string

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

start

string

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

step

string

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

stretchMode

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

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 s volitelným nastavením konfigurace kodéru.

Name Typ Description
complexity

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

InterleaveOutput

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

keyFrameIntervalInSeconds

number

Interval klíčového snímku v sekundách. Příklad: Nastavte KeyFrameIntervalInSeconds na hodnotu 2, abyste snížili ukládání do vyrovnávací paměti pro některé přehrávače.

maxBitrateBps

integer

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

maxHeight

integer

Maximální výška výstupních vrstev videa. Příklad: Nastavte MaxHeight na hodnotu 720, abyste vytvořili výstupní vrstvy až do 720P, i když je vstup 4K.

maxLayers

integer

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

minBitrateBps

integer

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

minHeight

integer

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

Priority

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

Name Typ Description
High

string

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

Low

string

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

Normal

string

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

Rectangle

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

Name Typ Description
height

string

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

left

string

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

top

string

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

width

string

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

Rotation

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

Name Typ Description
Auto

string

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

None

string

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

Rotate0

string

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

Rotate180

string

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

Rotate270

string

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

Rotate90

string

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

StandardEncoderPreset

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

Name Typ Description
@odata.type string:

#Microsoft.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ů přenosového proudu MPEG-2 (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řekročí 32 znaků, základní název se zkrátí na prvních 32 znaků v celkové délce. {Extension} – příslušná přípona pro tento formát. {Label} – popisek přiřazený k kodeku nebo vrstvě. {Index} – jedinečný index pro miniatury. Platí jenom pro miniatury. {AudioStream} – řetězec "Audio" plus číslo zvukového streamu (začátek od 1). {Bitrate} – přenosová rychlost zvuku/videa v kb/s. Nevztahuje se na miniatury. {Codec} – typ zvukového nebo obrazového kodeku. {Resolution} – rozlišení videa. Všechna nepodstituovaná makra se sbalí a odeberou z názvu souboru.

outputFiles

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

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