Transforms - Create Or Update
Transformatie maken of bijwerken
Hiermee maakt u een nieuwe transformatie of werkt u deze bij.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}?api-version=2022-07-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
De naam van het Media Services-account. |
resource
|
path | True |
string |
De naam van de resourcegroep binnen het Azure-abonnement. |
subscription
|
path | True |
string |
De unieke id voor een Microsoft Azure-abonnement. |
transform
|
path | True |
string |
De naam van de transformatie. |
api-version
|
query | True |
string |
De versie van de API die moet worden gebruikt met de clientaanvraag. |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
properties.outputs | True |
Een matrix van een of meer TransformOutputs die door de transformatie moeten worden gegenereerd. |
|
properties.description |
string |
Een optionele uitgebreide beschrijving van de transformatie. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Gemaakt |
|
Other Status Codes |
Gedetailleerde foutinformatie. |
Voorbeelden
Create or update a Transform
Voorbeeldaanvraag
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/createdTransform?api-version=2022-07-01
{
"properties": {
"description": "Example Transform to illustrate create and update.",
"outputs": [
{
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
}
}
Voorbeeldrespons
{
"name": "createdTransform",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:31.7664818Z",
"description": "Example Transform to illustrate create and update.",
"lastModified": "2022-10-17T23:14:31.7664818Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "Normal",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:31.7664818Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
}
}
{
"name": "createdTransform",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:31.7664818Z",
"description": "Example Transform to illustrate create and update.",
"lastModified": "2022-10-17T23:14:31.7664818Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "Normal",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:31.7664818Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
}
}
Definities
Name | Description |
---|---|
Aac |
Beschrijft de audiocoderingsinstellingen van Advanced Audio Codec (AAC). |
Aac |
Het coderingsprofiel dat moet worden gebruikt bij het coderen van audio met AAC. |
Analysis |
Hiermee geeft u de maximale resolutie op waarmee uw video wordt geanalyseerd. Het standaardgedrag is 'SourceResolution', waardoor de invoervideo op de oorspronkelijke resolutie blijft wanneer deze wordt geanalyseerd. Als u 'StandardDefinition' gebruikt, wordt de grootte van invoervideo's aangepast aan de standaarddefinitie met behoud van de juiste hoogte-breedteverhouding. Het formaat wordt alleen gewijzigd als de video een hogere resolutie heeft. Een invoer van 1920x1080 wordt bijvoorbeeld geschaald naar 640x360 voordat deze wordt verwerkt. Als u overschakelt naar StandardDefinition, wordt de tijd verkort die nodig is om video met een hoge resolutie te verwerken. Het kan ook de kosten voor het gebruik van dit onderdeel verlagen (zie https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics voor meer informatie). Gezichten die uiteindelijk te klein zijn in de video waarvan het formaat is gewijzigd, worden echter mogelijk niet gedetecteerd. |
Audio |
Hiermee definieert u de algemene eigenschappen voor alle audiocodecs. |
Audio |
Bepaalt de set audioanalysebewerkingen die moeten worden uitgevoerd. Als dit niet wordt opgegeven, wordt de Standaard AudioAnalysisMode gekozen. |
Audio |
Met de voorinstelling Audio Analyzer wordt een vooraf gedefinieerde set analysebewerkingen op basis van AI toegepast, waaronder spraaktranscriptie. Op dit moment ondersteunt de voorinstelling de verwerking van inhoud met één audiospoor. |
Audio |
Beschrijft de eigenschappen van een audio-overlay. |
Blur |
Type vervagen |
Built |
Beschrijft een ingebouwde voorinstelling voor het coderen van de invoervideo met de Standard Encoder. |
Complexity |
Hiermee kunt u de encoderinstellingen configureren om de balans tussen snelheid en kwaliteit te regelen. Voorbeeld: stel Complexiteit in op Snelheid voor snellere codering, maar minder compressie-efficiëntie. |
Copy |
Een codecvlag, waarmee de encoder de bitstream van de invoeraudio moet kopiëren. |
Copy |
Een codecvlag, waarmee de encoder de bitstream van de invoervideo moet kopiëren zonder opnieuw te coderen. |
created |
Het type identiteit waarmee de resource is gemaakt. |
DDAudio |
Beschrijft de audiocoderingsinstellingen van Dolby Digital Audio Codec (AC3). De huidige implementatie voor Dolby Digital Audio-ondersteuning is: Audiokanaalnummers bij 1((mono), 2(stereo), 6(5.1side); Frequenties van audiosampling op: 32K/44,1K/48K Hz; Waarden voor audiobitsnelheid zoals AC3-specificatie ondersteunt: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps. |
Deinterlace |
Hierin worden de instellingen voor het verwijderen van interlacing beschreven. |
Deinterlace |
De deinterlacingmodus. De standaardwaarde is AutoPixelAdaptive. |
Deinterlace |
De veldpariteit voor het verwijderen van interlacing wordt standaard ingesteld op Automatisch. |
Encoder |
De ingebouwde voorinstelling die moet worden gebruikt voor het coderen van video's. |
Entropy |
De entropiemodus die voor deze laag moet worden gebruikt. Als dit niet is opgegeven, kiest de encoder de modus die geschikt is voor het profiel en het niveau. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
Face |
Beschrijft alle instellingen die moeten worden gebruikt bij het analyseren van een video om alle aanwezige gezichten te detecteren (en eventueel te redigeren). |
Face |
Deze modus biedt de mogelijkheid om te kiezen tussen de volgende instellingen: 1) Analyseren - alleen voor detectie. In deze modus wordt een JSON-bestand met metagegevens gegenereerd dat de weergaven van gezichten in de video markeert. Waar mogelijk wordt aan de weergaven van dezelfde persoon dezelfde id toegewezen. 2) Gecombineerd: daarnaast worden gedetecteerde gezichten geredigeerd (vervaagt). 3) Redigeren: dit maakt een 2-pass-proces mogelijk, waardoor een subset van gedetecteerde gezichten selectief kan worden bewerkt. Het neemt het metagegevensbestand op van een eerdere analysepas, samen met de bronvideo en een door de gebruiker geselecteerde subset van id's die moeten worden bewerkt. |
Fade |
Beschrijft de eigenschappen van een fade-effect dat wordt toegepast op de invoermedia. |
Filters |
Beschrijft alle filterbewerkingen, zoals het de-interliniëren, draaien, enzovoort, die vóór het coderen moeten worden toegepast op de invoermedia. |
H264Complexity |
Vertelt de encoder hoe de coderingsinstellingen moeten worden gekozen. De standaardwaarde is Gebalanceerd. |
H264Layer |
Beschrijft de instellingen die moeten worden gebruikt bij het coderen van de invoervideo in een gewenste bitrate-uitvoerlaag met de H.264-videocodec. |
H264Rate |
De modus voor het regelen van videofrequenties |
H264Video |
Hierin worden alle eigenschappen beschreven voor het coderen van een video met de H.264-codec. |
H264Video |
We ondersteunen momenteel Basislijn, Main, High, High422, High444. De standaardwaarde is Automatisch. |
H265Complexity |
Vertelt de encoder hoe de coderingsinstellingen moeten worden gekozen. Kwaliteit biedt een hogere compressieverhouding, maar tegen hogere kosten en langere rekentijd. Snelheid produceert een relatief groter bestand, maar is sneller en voordeliger. De standaardwaarde is Gebalanceerd. |
H265Layer |
Beschrijft de instellingen die moeten worden gebruikt bij het coderen van de invoervideo in een gewenste bitrate-uitvoerlaag met de H.265-videocodec. |
H265Video |
Beschrijft alle eigenschappen voor het coderen van een video met de H.265-codec. |
H265Video |
Momenteel wordt Main ondersteund. De standaardwaarde is Automatisch. |
Image |
Beschrijft de basiseigenschappen voor het genereren van miniaturen op basis van de invoervideo |
Image |
Beschrijft de eigenschappen voor een uitvoerafbeeldingsbestand. |
Insights |
Definieert het type inzichten dat de service moet genereren. De toegestane waarden zijn 'AudioInsightsOnly', 'VideoInsightsOnly' en 'AllInsights'. De standaardwaarde is AllInsights. Als u dit instelt op AllInsights en de invoer alleen audio is, worden alleen audio-inzichten gegenereerd. Als de invoer alleen video is, worden alleen video-inzichten gegenereerd. Het is raadzaam audioInsightsOnly niet te gebruiken als u verwacht dat sommige van uw invoer alleen video zijn; of gebruik VideoInsightsOnly als u verwacht dat sommige invoer alleen audio is. Uw taken in dergelijke omstandigheden zouden een foutmelding geven. |
Interleave |
Hiermee stelt u de interleave-modus van de uitvoer in om te bepalen hoe audio en video worden opgeslagen in de containerindeling. Voorbeeld: stel InterleavedOutput in op NonInterleavedOutput om alleen-audio- en video-uitvoer te produceren in afzonderlijke MP4-bestanden. |
Jpg |
Beschrijft de instellingen voor het produceren van JPEG-miniaturen. |
Jpg |
Beschrijft de eigenschappen voor het produceren van een reeks JPEG-afbeeldingen op basis van de invoervideo. |
Jpg |
Beschrijft de instellingen voor het produceren van een JPEG-afbeelding op basis van de invoervideo. |
Mp4Format |
Beschrijft de eigenschappen voor een ISO MP4-uitvoerbestand. |
Multi |
Beschrijft de eigenschappen voor het produceren van een verzameling gop-uitgelijnde multi-bitrate bestanden. Het standaardgedrag is om één uitvoerbestand te produceren voor elke videolaag die samen met alle audio wordt gemuxt. De exacte uitvoerbestanden die worden geproduceerd, kunnen worden beheerd door de verzameling outputFiles op te geven. |
On |
Een transformatie kan meer dan één uitvoer definiëren. Deze eigenschap definieert wat de service moet doen wanneer een uitvoer mislukt. Ga door met het produceren van andere uitvoer of stop de andere uitvoer. De algehele taakstatus geeft geen fouten weer van uitvoer die zijn opgegeven met 'ContinueJob'. De standaardwaarde is 'StopProcessingJob'. |
Output |
Vertegenwoordigt een geproduceerd uitvoerbestand. |
Png |
Hierin worden de instellingen beschreven voor het produceren van PNG-miniaturen. |
Png |
Beschrijft de eigenschappen voor het produceren van een reeks PNG-afbeeldingen op basis van de invoervideo. |
Png |
Beschrijft de instellingen voor het produceren van een PNG-afbeelding op basis van de invoervideo. |
Preset |
Een object met optionele configuratie-instellingen voor encoder. |
Priority |
Hiermee stelt u de relatieve prioriteit van de TransformOutputs binnen een transformatie. Hiermee wordt de prioriteit ingesteld die de service gebruikt voor het verwerken van TransformOutputs. De standaardprioriteit is Normaal. |
Rectangle |
Beschrijft de eigenschappen van een rechthoekig venster dat op de invoermedia wordt toegepast voordat het wordt verwerkt. |
Rotation |
De draaiing, indien aanwezig, die moet worden toegepast op de invoervideo, voordat deze wordt gecodeerd. De standaardwaarde is Automatisch |
Standard |
Hierin worden alle instellingen beschreven die moeten worden gebruikt bij het coderen van de invoervideo met de Standard Encoder. |
Stretch |
De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize |
system |
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource. |
Transform |
Een transformatie omvat de regels of instructies voor het genereren van gewenste uitvoer van invoermedia, zoals door transcodering of door het extraheren van inzichten. Nadat de transformatie is gemaakt, kan deze worden toegepast op invoermedia door taken te maken. |
Transform |
Beschrijft de eigenschappen van een TransformOutput. Dit zijn de regels die moeten worden toegepast tijdens het genereren van de gewenste uitvoer. |
Transport |
Beschrijft de eigenschappen voor het genereren van een MPEG-2 Transport Stream(ISO/IEC 13818-1) uitvoervideobestand(en). |
Video |
Beschrijft de basiseigenschappen voor het coderen van de invoervideo. |
Video |
Een vooraf ingestelde videoanalyse die inzichten (uitgebreide metagegevens) uit zowel audio als video haalt en een bestand in JSON-indeling uitvoert. |
Video |
Beschrijft de eigenschappen van een video-overlay. |
Video |
De videosynchronisatiemodus |
AacAudio
Beschrijft de audiocoderingsinstellingen van Advanced Audio Codec (AAC).
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
bitrate |
integer |
De bitsnelheid, in bits per seconde, van de gecodeerde uitvoer van audio. |
channels |
integer |
Het aantal kanalen in de audio. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
profile |
Het coderingsprofiel dat moet worden gebruikt bij het coderen van audio met AAC. |
|
samplingRate |
integer |
De bemonsteringsfrequentie die moet worden gebruikt voor codering in hertz. |
AacAudioProfile
Het coderingsprofiel dat moet worden gebruikt bij het coderen van audio met AAC.
Name | Type | Description |
---|---|---|
AacLc |
string |
Hiermee geeft u op dat de uitvoeraudio moet worden gecodeerd in AAC Low Complexity Profile (AAC-LC). |
HeAacV1 |
string |
Hiermee geeft u op dat de uitvoeraudio moet worden gecodeerd in een HE-AAC v1-profiel. |
HeAacV2 |
string |
Hiermee geeft u op dat de uitvoeraudio moet worden gecodeerd in een HE-AAC v2-profiel. |
AnalysisResolution
Hiermee geeft u de maximale resolutie op waarmee uw video wordt geanalyseerd. Het standaardgedrag is 'SourceResolution', waardoor de invoervideo op de oorspronkelijke resolutie blijft wanneer deze wordt geanalyseerd. Als u 'StandardDefinition' gebruikt, wordt de grootte van invoervideo's aangepast aan de standaarddefinitie met behoud van de juiste hoogte-breedteverhouding. Het formaat wordt alleen gewijzigd als de video een hogere resolutie heeft. Een invoer van 1920x1080 wordt bijvoorbeeld geschaald naar 640x360 voordat deze wordt verwerkt. Als u overschakelt naar StandardDefinition, wordt de tijd verkort die nodig is om video met een hoge resolutie te verwerken. Het kan ook de kosten voor het gebruik van dit onderdeel verlagen (zie https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics voor meer informatie). Gezichten die uiteindelijk te klein zijn in de video waarvan het formaat is gewijzigd, worden echter mogelijk niet gedetecteerd.
Name | Type | Description |
---|---|---|
SourceResolution |
string |
|
StandardDefinition |
string |
Audio
Hiermee definieert u de algemene eigenschappen voor alle audiocodecs.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
bitrate |
integer |
De bitsnelheid, in bits per seconde, van de gecodeerde uitvoer van audio. |
channels |
integer |
Het aantal kanalen in de audio. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
samplingRate |
integer |
De bemonsteringsfrequentie die moet worden gebruikt voor codering in hertz. |
AudioAnalysisMode
Bepaalt de set audioanalysebewerkingen die moeten worden uitgevoerd. Als dit niet wordt opgegeven, wordt de Standaard AudioAnalysisMode gekozen.
Name | Type | Description |
---|---|---|
Basic |
string |
Met deze modus wordt spraak-naar-teksttranscriptie uitgevoerd en wordt een VTT-ondertitel-/onderschrift-bestand gegenereerd. De uitvoer van deze modus bevat een Insights JSON-bestand met alleen de trefwoorden, transcriptie en tijdsinstellingen. Automatische taaldetectie en sprekerdiarisatie zijn niet opgenomen in deze modus. |
Standard |
string |
Voert alle bewerkingen uit die zijn opgenomen in de basismodus, en voert daarnaast taaldetectie en sprekerdiarisatie uit. |
AudioAnalyzerPreset
Met de voorinstelling Audio Analyzer wordt een vooraf gedefinieerde set analysebewerkingen op basis van AI toegepast, waaronder spraaktranscriptie. Op dit moment ondersteunt de voorinstelling de verwerking van inhoud met één audiospoor.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
audioLanguage |
string |
De taal voor de audiopayload in de invoer met behulp van de BCP-47-indeling van 'language tag-region' (bijvoorbeeld 'en-US'). Als u de taal van uw inhoud kent, is het raadzaam deze op te geven. De taal moet expliciet worden opgegeven voor AudioAnalysisMode::Basic, omdat automatische taaldetectie niet is opgenomen in de basismodus. Als de taal niet is opgegeven of ingesteld op null, kiest automatische taaldetectie de eerste gedetecteerde taal en verwerkt met de geselecteerde taal voor de duur van het bestand. Het biedt momenteel geen ondersteuning voor dynamisch schakelen tussen talen nadat de eerste taal is gedetecteerd. De automatische detectie werkt het beste met audio-opnamen met duidelijk waarneembare spraak. Als automatische detectie de taal niet kan vinden, zou transcriptie terugvallen op 'en-US'. De lijst met ondersteunde talen is hier beschikbaar: https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
Woordenlijst met sleutelwaardeparen voor parameters die niet beschikbaar zijn in de voorinstelling zelf |
mode |
Bepaalt de set audioanalysebewerkingen die moeten worden uitgevoerd. Als dit niet wordt opgegeven, wordt de Standaard AudioAnalysisMode gekozen. |
AudioOverlay
Beschrijft de eigenschappen van een audio-overlay.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
audioGainLevel |
number |
Het versterkingsniveau van audio in de overlay. De waarde moet in het bereik [0, 1,0] liggen. De standaardwaarde is 1.0. |
end |
string |
De eindpositie, met verwijzing naar de invoervideo, waarop de overlay eindigt. De waarde moet de INDELING ISO 8601 hebben. Bijvoorbeeld PT30S om de overlay na 30 seconden te beëindigen in de invoervideo. Als niet is opgegeven of als de waarde groter is dan de duur van de invoervideo, wordt de overlay toegepast tot het einde van de invoervideo als de duur van de overlaymedia groter is dan de duur van de invoervideo, anders duurt de overlay net zo lang als de duur van de overlaymedia. |
fadeInDuration |
string |
De duur waarover de overlay vervaagt in de invoervideo. De waarde moet de ISO 8601-duurnotatie hebben. Als dit niet is opgegeven, is het standaardgedrag dat er geen infade is (hetzelfde als PT0S). |
fadeOutDuration |
string |
De duur gedurende welke de overlay uit de invoervideo vervaagt. De waarde moet de ISO 8601-duurnotatie hebben. Als dit niet is opgegeven, is het standaardgedrag dat er geen fade-out is (hetzelfde als PT0S). |
inputLabel |
string |
Het label van de taakinvoer die moet worden gebruikt als een overlay. De invoer moet precies één bestand opgeven. U kunt een afbeeldingsbestand opgeven in JPG-, PNG-, GIF- of BMP-indeling, of een audiobestand (zoals een WAV-, MP3-, WMA- of M4A-bestand) of een videobestand. Zie https://aka.ms/mesformats voor de volledige lijst met ondersteunde audio- en videobestandsindelingen. |
start |
string |
De beginpositie, met verwijzing naar de invoervideo, waarop de overlay begint. De waarde moet de INDELING ISO 8601 hebben. Bijvoorbeeld PT05S om de overlay op 5 seconden in de invoervideo te starten. Als dit niet is opgegeven, wordt de overlay gestart vanaf het begin van de invoervideo. |
BlurType
Type vervagen
Name | Type | Description |
---|---|---|
Black |
string |
Zwart: Zwart-filter |
Box |
string |
Vak: foutopsporingsfilter, alleen begrenzingsvak |
High |
string |
Hoog: filter voor verwarrende vervaging |
Low |
string |
Laag: vervagingsfilter van box-car |
Med |
string |
Med: Gaussiaans waasfilter |
BuiltInStandardEncoderPreset
Beschrijft een ingebouwde voorinstelling voor het coderen van de invoervideo met de Standard Encoder.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
configurations |
Optionele configuratie-instellingen voor encoder. Configuraties wordt alleen ondersteund voor ContentAwareEncoding en H265ContentAwareEncoding BuiltInStandardEncoderPreset. |
|
presetName |
De ingebouwde voorinstelling die moet worden gebruikt voor het coderen van video's. |
Complexity
Hiermee kunt u de encoderinstellingen configureren om de balans tussen snelheid en kwaliteit te regelen. Voorbeeld: stel Complexiteit in op Snelheid voor snellere codering, maar minder compressie-efficiëntie.
Name | Type | Description |
---|---|---|
Balanced |
string |
Configureert de encoder voor het gebruik van instellingen die een balans tussen snelheid en kwaliteit bereiken. |
Quality |
string |
Hiermee configureert u de encoder voor het gebruik van instellingen die zijn geoptimaliseerd om uitvoer van hogere kwaliteit te produceren, ten koste van een tragere algehele coderingstijd. |
Speed |
string |
Configureert de encoder voor het gebruik van instellingen die zijn geoptimaliseerd voor snellere codering. Kwaliteit wordt opgeofferd om de coderingstijd te verkorten. |
CopyAudio
Een codecvlag, waarmee de encoder de bitstream van de invoeraudio moet kopiëren.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
CopyVideo
Een codecvlag, waarmee de encoder de bitstream van de invoervideo moet kopiëren zonder opnieuw te coderen.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
createdByType
Het type identiteit waarmee de resource is gemaakt.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DDAudio
Beschrijft de audiocoderingsinstellingen van Dolby Digital Audio Codec (AC3). De huidige implementatie voor Dolby Digital Audio-ondersteuning is: Audiokanaalnummers bij 1((mono), 2(stereo), 6(5.1side); Frequenties van audiosampling op: 32K/44,1K/48K Hz; Waarden voor audiobitsnelheid zoals AC3-specificatie ondersteunt: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
bitrate |
integer |
De bitsnelheid, in bits per seconde, van de gecodeerde uitvoer van audio. |
channels |
integer |
Het aantal kanalen in de audio. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
samplingRate |
integer |
De bemonsteringsfrequentie die moet worden gebruikt voor codering in hertz. |
Deinterlace
Hierin worden de instellingen voor het verwijderen van interlacing beschreven.
Name | Type | Description |
---|---|---|
mode |
De deinterlacingmodus. De standaardwaarde is AutoPixelAdaptive. |
|
parity |
De veldpariteit voor het verwijderen van interlacing wordt standaard ingesteld op Automatisch. |
DeinterlaceMode
De deinterlacingmodus. De standaardwaarde is AutoPixelAdaptive.
Name | Type | Description |
---|---|---|
AutoPixelAdaptive |
string |
Automatische pixel-adaptieve de-interlacing toepassen op elk frame in de invoervideo. |
Off |
string |
Schakelt de interlacing van de bronvideo uit. |
DeinterlaceParity
De veldpariteit voor het verwijderen van interlacing wordt standaard ingesteld op Automatisch.
Name | Type | Description |
---|---|---|
Auto |
string |
Automatisch de volgorde van velden detecteren |
BottomFieldFirst |
string |
Pas het onderste veld toe als eerste verwerking van invoervideo. |
TopFieldFirst |
string |
Pas het bovenste veld toe als eerste verwerking van invoervideo. |
EncoderNamedPreset
De ingebouwde voorinstelling die moet worden gebruikt voor het coderen van video's.
Name | Type | Description |
---|---|---|
AACGoodQualityAudio |
string |
Produceert één MP4-bestand met alleen AAC-stereoaudio gecodeerd op 192 kbps. |
AdaptiveStreaming |
string |
Produceert een set GOP-uitgelijnde MP4-bestanden met H.264-video en stereo-AAC-audio. Er wordt automatisch een bitrate-ladder gegenereerd op basis van de invoerresolutie, bitsnelheid en framesnelheid. De automatisch gegenereerde voorinstelling overschrijdt nooit de invoerresolutie. Als de invoer bijvoorbeeld 720p is, blijft de uitvoer maximaal 720p. |
ContentAwareEncoding |
string |
Produceert een set OP GOP's afgestemde MP4's met behulp van inhoudsbewuste codering. Op basis van invoerinhoud voert de service een initiële lichtgewicht analyse van de invoerinhoud uit en gebruikt de resultaten om het optimale aantal lagen, de juiste bitrate- en resolutie-instellingen te bepalen voor levering door adaptieve streaming. Deze voorinstelling is met name effectief voor video's met lage en gemiddelde complexiteit, waarbij de uitvoerbestanden lagere bitrates hebben, maar met een kwaliteit die nog steeds een goede ervaring biedt aan kijkers. De uitvoer bevat MP4-bestanden met video en audio interleaved. |
ContentAwareEncodingExperimental |
string |
Hiermee wordt een experimentele voorinstelling voor inhoudsbewuste codering weergegeven. Op basis van invoerinhoud probeert de service automatisch het optimale aantal lagen, de juiste bitsnelheid en resolutie-instellingen te bepalen voor levering door adaptieve streaming. De onderliggende algoritmen zullen zich in de loop van de tijd blijven ontwikkelen. De uitvoer bevat MP4-bestanden met video en audio interleaved. |
CopyAllBitrateNonInterleaved |
string |
Kopieer alle video- en audiostreams van de invoerasset als niet-interleaved video- en audio-uitvoerbestanden. Deze voorinstelling kan worden gebruikt voor het knippen van een bestaande asset of het converteren van een groep met key frame (GOP) uitgelijnde MP4-bestanden als een asset die kan worden gestreamd. |
DDGoodQualityAudio |
string |
Produceert één MP4-bestand met alleen DD(Digital Dolby) stereoaudio gecodeerd op 192 kbps. |
H264MultipleBitrate1080p |
string |
Produceert een set van 8 GOP-uitgelijnde MP4-bestanden, variërend van 6000 kbps tot 400 kbps, en stereo AAC-audio. De resolutie begint bij 1080p en gaat omlaag naar 180p. |
H264MultipleBitrate720p |
string |
Produceert een set van 6 GOP-uitgelijnde MP4-bestanden, variërend van 3400 kbps tot 400 kbps, en stereo AAC-audio. De resolutie begint bij 720p en gaat omlaag naar 180p. |
H264MultipleBitrateSD |
string |
Produceert een set van 5 GOP-uitgelijnde MP4-bestanden, variërend van 1900kbps tot 400 kbps, en stereo AAC-audio. De resolutie begint bij 480p en gaat omlaag naar 240p. |
H264SingleBitrate1080p |
string |
Produceert een MP4-bestand waarbij de video is gecodeerd met H.264-codec op 6750 kbps en een afbeeldingshoogte van 1080 pixels, en de stereoaudio is gecodeerd met AAC-LC-codec op 128 kbps. |
H264SingleBitrate720p |
string |
Produceert een MP4-bestand waarbij de video is gecodeerd met H.264-codec op 4500 kbps en een afbeeldingshoogte van 720 pixels, en de stereoaudio is gecodeerd met AAC-LC-codec op 128 kbps. |
H264SingleBitrateSD |
string |
Produceert een MP4-bestand waarbij de video is gecodeerd met H.264-codec op 2200 kbps en een afbeeldingshoogte van 480 pixels, en de stereoaudio is gecodeerd met AAC-LC-codec op 128 kbps. |
H265AdaptiveStreaming |
string |
Produceert een set GOP-uitgelijnde MP4-bestanden met H.265-video en stereo-AAC-audio. Er wordt automatisch een bitrate-ladder gegenereerd op basis van de invoerresolutie, bitsnelheid en framesnelheid. De automatisch gegenereerde voorinstelling overschrijdt nooit de invoerresolutie. Als de invoer bijvoorbeeld 720p is, blijft de uitvoer maximaal 720p. |
H265ContentAwareEncoding |
string |
Produceert een set OP GOP's afgestemde MP4's met behulp van inhoudsbewuste codering. Op basis van invoerinhoud voert de service een initiële lichtgewicht analyse van de invoerinhoud uit en gebruikt de resultaten om het optimale aantal lagen, de juiste bitrate- en resolutie-instellingen te bepalen voor levering door adaptieve streaming. Deze voorinstelling is met name effectief voor video's met lage en gemiddelde complexiteit, waarbij de uitvoerbestanden lagere bitrates hebben, maar met een kwaliteit die nog steeds een goede ervaring biedt aan kijkers. De uitvoer bevat MP4-bestanden met video en audio interleaved. |
H265SingleBitrate1080p |
string |
Produceert een MP4-bestand waarbij de video is gecodeerd met H.265-codec op 3500 kbps en een afbeeldingshoogte van 1080 pixels, en de stereoaudio is gecodeerd met AAC-LC-codec op 128 kbps. |
H265SingleBitrate4K |
string |
Produceert een MP4-bestand waarbij de video is gecodeerd met H.265-codec op 9500 kbps en een afbeeldingshoogte van 2160 pixels, en de stereoaudio is gecodeerd met AAC-LC-codec op 128 kbps. |
H265SingleBitrate720p |
string |
Produceert een MP4-bestand waarbij de video is gecodeerd met H.265-codec op 1800 kbps en een afbeeldingshoogte van 720 pixels, en de stereoaudio is gecodeerd met AAC-LC-codec op 128 kbps. |
EntropyMode
De entropiemodus die voor deze laag moet worden gebruikt. Als dit niet is opgegeven, kiest de encoder de modus die geschikt is voor het profiel en het niveau.
Name | Type | Description |
---|---|---|
Cabac |
string |
Context Adaptive Binary Arithmetic Coder (CABAC) entropiecodering. |
Cavlc |
string |
Context Adaptive Variable Length Coder (CAVLC) entropiecodering. |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het type aanvullende informatie. |
ErrorDetail
De foutdetails.
Name | Type | Description |
---|---|---|
additionalInfo |
De fout aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
Het foutobject. |
FaceDetectorPreset
Beschrijft alle instellingen die moeten worden gebruikt bij het analyseren van een video om alle aanwezige gezichten te detecteren (en eventueel te redigeren).
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
blurType |
Type vervagen |
|
experimentalOptions |
object |
Woordenlijst met sleutelwaardeparen voor parameters die niet beschikbaar zijn in de voorinstelling zelf |
mode |
Deze modus biedt de mogelijkheid om te kiezen tussen de volgende instellingen: 1) Analyseren - alleen voor detectie. In deze modus wordt een JSON-bestand met metagegevens gegenereerd dat de weergaven van gezichten in de video markeert. Waar mogelijk wordt aan de weergaven van dezelfde persoon dezelfde id toegewezen. 2) Gecombineerd: daarnaast worden gedetecteerde gezichten geredigeerd (vervaagt). 3) Redigeren: dit maakt een 2-pass-proces mogelijk, waardoor een subset van gedetecteerde gezichten selectief kan worden bewerkt. Het neemt het metagegevensbestand op van een eerdere analysepas, samen met de bronvideo en een door de gebruiker geselecteerde subset van id's die moeten worden bewerkt. |
|
resolution |
Hiermee geeft u de maximale resolutie op waarmee uw video wordt geanalyseerd. Het standaardgedrag is 'SourceResolution', waardoor de invoervideo op de oorspronkelijke resolutie blijft wanneer deze wordt geanalyseerd. Als u 'StandardDefinition' gebruikt, wordt de grootte van invoervideo's aangepast aan de standaarddefinitie met behoud van de juiste hoogte-breedteverhouding. Het formaat wordt alleen gewijzigd als de video een hogere resolutie heeft. Een invoer van 1920x1080 wordt bijvoorbeeld geschaald naar 640x360 voordat deze wordt verwerkt. Als u overschakelt naar StandardDefinition, wordt de tijd verkort die nodig is om video met een hoge resolutie te verwerken. Het kan ook de kosten voor het gebruik van dit onderdeel verlagen (zie https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics voor meer informatie). Gezichten die uiteindelijk te klein zijn in de video waarvan het formaat is gewijzigd, worden echter mogelijk niet gedetecteerd. |
FaceRedactorMode
Deze modus biedt de mogelijkheid om te kiezen tussen de volgende instellingen: 1) Analyseren - alleen voor detectie. In deze modus wordt een JSON-bestand met metagegevens gegenereerd dat de weergaven van gezichten in de video markeert. Waar mogelijk wordt aan de weergaven van dezelfde persoon dezelfde id toegewezen. 2) Gecombineerd: daarnaast worden gedetecteerde gezichten geredigeerd (vervaagt). 3) Redigeren: dit maakt een 2-pass-proces mogelijk, waardoor een subset van gedetecteerde gezichten selectief kan worden bewerkt. Het neemt het metagegevensbestand op van een eerdere analysepas, samen met de bronvideo en een door de gebruiker geselecteerde subset van id's die moeten worden bewerkt.
Name | Type | Description |
---|---|---|
Analyze |
string |
De analysemodus detecteert gezichten en voert een metagegevensbestand uit met de resultaten. Hiermee kunt u het metagegevensbestand bewerken voordat gezichten worden vervaagd met de bewerkingsmodus. |
Combined |
string |
In de gecombineerde modus worden de stappen analyseren en redigeren in één bewerking uitgevoerd wanneer het bewerken van de geanalyseerde gezichten niet gewenst is. |
Redact |
string |
De bewerkingsmodus verbruikt het metagegevensbestand vanuit de analysemodus en bewerkt de gevonden gezichten. |
Fade
Beschrijft de eigenschappen van een fade-effect dat wordt toegepast op de invoermedia.
Name | Type | Description |
---|---|---|
duration |
string |
De duur van het effect vervagen in de video. De waarde kan een ISO 8601-indeling hebben (bijvoorbeeld PT05S om een kleur gedurende 5 seconden te vervagen), of een aantal frames (bijvoorbeeld 10 om 10 frames vanaf de begintijd te vervagen) of een relatieve waarde voor de duur van de stroom (bijvoorbeeld 10% om 10% van de stroomduur te vervagen) |
fadeColor |
string |
De kleur voor de in-/uitfade. het kan zijn op de CSS Level1 kleuren https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords of een RGB/hex-waarde: bijvoorbeeld rgb (255;0;0), 0xFF0000 of #FF0000 |
start |
string |
De positie in de invoervideo vanaf waar u moet beginnen, vervaagt. De waarde kan de indeling ISO 8601 hebben (bijvoorbeeld PT05S om na 5 seconden te beginnen), of een aantal frames (bijvoorbeeld 10 om te beginnen bij het 10e frame) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% om te beginnen bij 10% van de duur van de stroom). De standaardwaarde is 0 |
Filters
Beschrijft alle filterbewerkingen, zoals het de-interliniëren, draaien, enzovoort, die vóór het coderen moeten worden toegepast op de invoermedia.
Name | Type | Description |
---|---|---|
crop |
De parameters voor het rechthoekige venster waarmee de invoervideo moet worden bijgesneden. |
|
deinterlace |
De instellingen voor het verwijderen van interliniëring. |
|
fadeIn |
Beschrijft de eigenschappen van een effect Vervagen dat wordt toegepast op de invoermedia. |
|
fadeOut |
Beschrijft de eigenschappen van een effect Vervagen dat wordt toegepast op de invoermedia. |
|
overlays | Overlay[]: |
De eigenschappen van overlays die moeten worden toegepast op de invoervideo. Dit kunnen audio-, afbeeldings- of video-overlays zijn. |
rotation |
De draaiing, indien aanwezig, die moet worden toegepast op de invoervideo, voordat deze wordt gecodeerd. De standaardwaarde is Automatisch |
H264Complexity
Vertelt de encoder hoe de coderingsinstellingen moeten worden gekozen. De standaardwaarde is Gebalanceerd.
Name | Type | Description |
---|---|---|
Balanced |
string |
Hiermee geeft u aan dat de encoder instellingen moet gebruiken die een balans tussen snelheid en kwaliteit bereiken. |
Quality |
string |
Hiermee wordt aangegeven dat de encoder instellingen moet gebruiken die zijn geoptimaliseerd om uitvoer van hogere kwaliteit te produceren, ten koste van een tragere algehele coderingstijd. |
Speed |
string |
Hiermee geeft u aan dat de encoder instellingen moet gebruiken die zijn geoptimaliseerd voor snellere codering. Kwaliteit wordt opgeofferd om de coderingstijd te verkorten. |
H264Layer
Beschrijft de instellingen die moeten worden gebruikt bij het coderen van de invoervideo in een gewenste bitrate-uitvoerlaag met de H.264-videocodec.
Name | Type | Description |
---|---|---|
adaptiveBFrame |
boolean |
Of adaptieve B-frames moeten worden gebruikt bij het coderen van deze laag. Als dit niet is opgegeven, wordt de encoder ingeschakeld wanneer het videoprofiel het gebruik toestaat. |
bFrames |
integer |
Het aantal B-frames dat moet worden gebruikt bij het coderen van deze laag. Als dit niet is opgegeven, kiest de encoder een geschikt nummer op basis van het videoprofiel en -niveau. |
bitrate |
integer |
De gemiddelde bitsnelheid in bits per seconde waarmee de invoervideo moet worden gecodeerd bij het genereren van deze laag. Dit is een verplicht veld. |
bufferWindow |
string |
De lengte van het VBV-buffervenster. De waarde moet de INDELING ISO 8601 hebben. De waarde moet binnen het bereik [0,1-100] seconden liggen. De standaardwaarde is 5 seconden (bijvoorbeeld PT5S). |
crf |
number |
De waarde van CRF die moet worden gebruikt bij het coderen van deze laag. Deze instelling wordt van kracht wanneer RateControlMode van videocodec is ingesteld op crf-modus. Het bereik van DE CRF-waarde ligt tussen 0 en 51, waarbij lagere waarden leiden tot een betere kwaliteit, ten koste van grotere bestandsgrootten. Hogere waarden betekenen meer compressie, maar op een bepaald moment zal kwaliteitsvermindering worden opgemerkt. De standaardwaarde is 23. |
entropyMode |
De entropiemodus die voor deze laag moet worden gebruikt. Als dit niet is opgegeven, kiest de encoder de modus die geschikt is voor het profiel en het niveau. |
|
frameRate |
string |
De framesnelheid (in frames per seconde) waarmee deze laag moet worden gecodeerd. De waarde kan de vorm van M/N hebben, waarbij M en N gehele getallen zijn (bijvoorbeeld 30000/1001), of in de vorm van een getal (bijvoorbeeld 30 of 29,97). De encoder dwingt beperkingen af voor toegestane framesnelheden op basis van het profiel en het niveau. Als dit niet is opgegeven, gebruikt de encoder dezelfde framesnelheid als de invoervideo. |
height |
string |
De hoogte van de uitvoervideo voor deze laag. De waarde kan absoluut (in pixels) of relatief (in percentage) zijn. 50% betekent bijvoorbeeld dat de uitvoervideo half zoveel pixels hoog is als de invoer. |
label |
string |
Het alfanumerieke label voor deze laag, dat kan worden gebruikt bij het multiplexen van verschillende video- en audiolagen of bij het benoemen van het uitvoerbestand. |
level |
string |
Momenteel wordt niveau tot 6.2 ondersteund. De waarde kan Auto zijn of een getal dat overeenkomt met het H.264-profiel. Als dit niet is opgegeven, is de standaardwaarde Auto, zodat de encoder het niveau kan kiezen dat geschikt is voor deze laag. |
maxBitrate |
integer |
De maximale bitsnelheid (in bits per seconde), waarbij de VBV-buffer moet worden bijgevuld. Als dit niet is opgegeven, wordt standaard dezelfde waarde als bitrate gebruikt. |
profile |
We ondersteunen momenteel Basislijn, Hoofdlijn, Hoog, Hoog422, High444. De standaardwaarde is Automatisch. |
|
referenceFrames |
integer |
Het aantal referentieframes dat moet worden gebruikt bij het coderen van deze laag. Als dit niet is opgegeven, bepaalt de encoder een geschikt getal op basis van de instelling voor de complexiteit van de encoder. |
slices |
integer |
Het aantal segmenten dat moet worden gebruikt bij het coderen van deze laag. Als dit niet is opgegeven, is de standaardwaarde nul, wat betekent dat de encoder één segment voor elk frame gebruikt. |
width |
string |
De breedte van de uitvoervideo voor deze laag. De waarde kan absoluut (in pixels) of relatief (in percentage) zijn. 50% betekent bijvoorbeeld dat de uitvoervideo half zoveel pixels breed heeft als de invoer. |
H264RateControlMode
De modus voor het regelen van videofrequenties
Name | Type | Description |
---|---|---|
ABR |
string |
ABR-modus (Average Bitrate) die de doel-bitrate bereikt: Standaardmodus. |
CBR |
string |
CBR-modus (Constant Bitrate), waarmee bitratevariaties rond de doelbitsnelheid worden aangescherpt. |
CRF |
string |
Crf-modus (Constant Rate Factor) die gericht is op constante subjectieve kwaliteit. |
H264Video
Hierin worden alle eigenschappen beschreven voor het coderen van een video met de H.264-codec.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
complexity |
Vertelt de encoder hoe de coderingsinstellingen moeten worden gekozen. De standaardwaarde is Gebalanceerd. |
|
keyFrameInterval |
string |
De afstand tussen twee belangrijke frames. De waarde moet niet nul zijn in het bereik [0,5, 20] seconden, opgegeven in ISO 8601-indeling. De standaardwaarde is 2 seconden (PT2S). Houd er rekening mee dat deze instelling wordt genegeerd als VideoSyncMode.Passthrough is ingesteld, waarbij de waarde KeyFrameInterval de instelling van de invoerbron volgt. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
layers |
De verzameling H.264-uitvoerlagen die moeten worden geproduceerd door de encoder. |
|
rateControlMode |
De modus voor het regelen van videofrequenties |
|
sceneChangeDetection |
boolean |
Of de encoder sleutelframes bij scènes moet invoegen of niet. Als dit niet is opgegeven, is de standaardwaarde false. Deze vlag moet alleen worden ingesteld op waar wanneer de encoder wordt geconfigureerd voor het produceren van één uitvoervideo. |
stretchMode |
De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize |
|
syncMode |
De videosynchronisatiemodus |
H264VideoProfile
We ondersteunen momenteel Basislijn, Main, High, High422, High444. De standaardwaarde is Automatisch.
Name | Type | Description |
---|---|---|
Auto |
string |
Hiermee wordt automatisch het juiste H.264-profiel bepaald. |
Baseline |
string |
Basislijnprofiel |
High |
string |
Hoog profiel. |
High422 |
string |
Hoog 4:2:2 profiel. |
High444 |
string |
Hoog voorspellend profiel van 4:4:4. |
Main |
string |
Hoofdprofiel |
H265Complexity
Vertelt de encoder hoe de coderingsinstellingen moeten worden gekozen. Kwaliteit biedt een hogere compressieverhouding, maar tegen hogere kosten en langere rekentijd. Snelheid produceert een relatief groter bestand, maar is sneller en voordeliger. De standaardwaarde is Gebalanceerd.
Name | Type | Description |
---|---|---|
Balanced |
string |
Hiermee geeft u aan dat de encoder instellingen moet gebruiken die een balans tussen snelheid en kwaliteit bereiken. |
Quality |
string |
Hiermee wordt aangegeven dat de encoder instellingen moet gebruiken die zijn geoptimaliseerd om uitvoer van hogere kwaliteit te produceren, ten koste van een tragere algehele coderingstijd. |
Speed |
string |
Hiermee geeft u aan dat de encoder instellingen moet gebruiken die zijn geoptimaliseerd voor snellere codering. Kwaliteit wordt opgeofferd om de coderingstijd te verkorten. |
H265Layer
Beschrijft de instellingen die moeten worden gebruikt bij het coderen van de invoervideo in een gewenste bitrate-uitvoerlaag met de H.265-videocodec.
Name | Type | Description |
---|---|---|
adaptiveBFrame |
boolean |
Hiermee geeft u op of adaptieve B-frames moeten worden gebruikt bij het coderen van deze laag. Als dit niet is opgegeven, wordt de encoder ingeschakeld wanneer het videoprofiel het gebruik toestaat. |
bFrames |
integer |
Het aantal B-frames dat moet worden gebruikt bij het coderen van deze laag. Als dit niet is opgegeven, kiest de encoder een geschikt nummer op basis van het videoprofiel en -niveau. |
bitrate |
integer |
De gemiddelde bitsnelheid in bits per seconde waarmee de invoervideo moet worden gecodeerd bij het genereren van deze laag. Bijvoorbeeld: een doelbitsnelheid van 3000Kbps of 3Mbps betekent dat deze waarde 30000000 moet zijn. Dit is een verplicht veld. |
bufferWindow |
string |
De lengte van het VBV-buffervenster. De waarde moet de INDELING ISO 8601 hebben. De waarde moet binnen het bereik [0,1-100] seconden liggen. De standaardwaarde is 5 seconden (bijvoorbeeld PT5S). |
crf |
number |
De waarde van CRF die moet worden gebruikt bij het coderen van deze laag. Deze instelling wordt van kracht wanneer RateControlMode van videocodec is ingesteld op crf-modus. Het bereik van DE CRF-waarde ligt tussen 0 en 51, waarbij lagere waarden leiden tot een betere kwaliteit, ten koste van grotere bestandsgrootten. Hogere waarden betekenen meer compressie, maar op een bepaald moment zal kwaliteitsvermindering worden opgemerkt. De standaardwaarde is 28. |
frameRate |
string |
De framesnelheid (in frames per seconde) waarmee deze laag moet worden gecodeerd. De waarde kan de vorm van M/N hebben, waarbij M en N gehele getallen zijn (bijvoorbeeld 30000/1001), of in de vorm van een getal (bijvoorbeeld 30 of 29,97). De encoder dwingt beperkingen af voor toegestane framesnelheden op basis van het profiel en het niveau. Als dit niet is opgegeven, gebruikt de encoder dezelfde framesnelheid als de invoervideo. |
height |
string |
De hoogte van de uitvoervideo voor deze laag. De waarde kan absoluut (in pixels) of relatief (in percentage) zijn. 50% betekent bijvoorbeeld dat de uitvoervideo half zoveel pixels hoog is als de invoer. |
label |
string |
Het alfanumerieke label voor deze laag, dat kan worden gebruikt bij het multiplexen van verschillende video- en audiolagen of bij het benoemen van het uitvoerbestand. |
level |
string |
Momenteel wordt niveau tot 6.2 ondersteund. De waarde kan Auto zijn of een getal dat overeenkomt met het H.265-profiel. Als dit niet is opgegeven, is de standaardwaarde Auto, zodat de encoder het niveau kan kiezen dat geschikt is voor deze laag. |
maxBitrate |
integer |
De maximale bitsnelheid (in bits per seconde), waarbij de VBV-buffer moet worden bijgevuld. Als dit niet is opgegeven, wordt standaard dezelfde waarde als bitrate gebruikt. |
profile |
Momenteel wordt Main ondersteund. De standaardwaarde is Automatisch. |
|
referenceFrames |
integer |
Het aantal referentieframes dat moet worden gebruikt bij het coderen van deze laag. Als dit niet is opgegeven, bepaalt de encoder een geschikt getal op basis van de instelling voor de complexiteit van de encoder. |
slices |
integer |
Het aantal segmenten dat moet worden gebruikt bij het coderen van deze laag. Als dit niet is opgegeven, is de standaardwaarde nul, wat betekent dat de encoder één segment voor elk frame gebruikt. |
width |
string |
De breedte van de uitvoervideo voor deze laag. De waarde kan absoluut (in pixels) of relatief (in percentage) zijn. 50% betekent bijvoorbeeld dat de uitvoervideo half zoveel pixels breed heeft als de invoer. |
H265Video
Beschrijft alle eigenschappen voor het coderen van een video met de H.265-codec.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
complexity |
Vertelt de encoder hoe de coderingsinstellingen moeten worden gekozen. Kwaliteit biedt een hogere compressieverhouding, maar tegen hogere kosten en langere rekentijd. Snelheid produceert een relatief groter bestand, maar is sneller en voordeliger. De standaardwaarde is Gebalanceerd. |
|
keyFrameInterval |
string |
De afstand tussen twee belangrijke frames. De waarde moet niet nul zijn in het bereik [0,5, 20] seconden, opgegeven in ISO 8601-indeling. De standaardwaarde is 2 seconden (PT2S). Houd er rekening mee dat deze instelling wordt genegeerd als VideoSyncMode.Passthrough is ingesteld, waarbij de waarde KeyFrameInterval de instelling van de invoerbron volgt. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
layers |
De verzameling H.265-uitvoerlagen die moeten worden geproduceerd door de encoder. |
|
sceneChangeDetection |
boolean |
Hiermee geeft u op of de encoder sleutelframes moet invoegen bij scènewijzigingen. Als dit niet is opgegeven, is de standaardwaarde false. Deze vlag moet alleen worden ingesteld op waar wanneer de encoder wordt geconfigureerd voor het produceren van één uitvoervideo. |
stretchMode |
De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize |
|
syncMode |
De videosynchronisatiemodus |
H265VideoProfile
Momenteel wordt Main ondersteund. De standaardwaarde is Automatisch.
Name | Type | Description |
---|---|---|
Auto |
string |
Vertelt de encoder automatisch het juiste H.265-profiel te bepalen. |
Main |
string |
Hoofdprofiel (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier) |
Main10 |
string |
Hoofdprofiel 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10) |
Image
Beschrijft de basiseigenschappen voor het genereren van miniaturen op basis van de invoervideo
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
keyFrameInterval |
string |
De afstand tussen twee belangrijke frames. De waarde moet niet nul zijn in het bereik [0,5, 20] seconden, opgegeven in ISO 8601-indeling. De standaardwaarde is 2 seconden (PT2S). Houd er rekening mee dat deze instelling wordt genegeerd als VideoSyncMode.Passthrough is ingesteld, waarbij de waarde KeyFrameInterval de instelling van de invoerbron volgt. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
range |
string |
De positie ten opzichte van het transformeren van de vooraf ingestelde begintijd in de invoervideo waarop het genereren van miniaturen moet worden gestopt. De waarde kan een ISO 8601-indeling hebben (bijvoorbeeld PT5M30S om te stoppen bij 5 minuten en 30 seconden vanaf de begintijd) of een aantal frames (bijvoorbeeld 300 om te stoppen bij het 300e frame van het frame op de begintijd. Als deze waarde 1 is, betekent dit dat er slechts één miniatuur wordt geproduceerd bij het begintijd) of een relatieve waarde ten opzichte van de duur van de stroom (bijvoorbeeld 50% om te stoppen bij de helft van de duur van de stream vanaf de begintijd). De standaardwaarde is 100%, wat betekent dat u stopt aan het einde van de stream. |
start |
string |
De positie in de invoervideo van waaruit miniaturen moeten worden gegenereerd. De waarde kan de indeling ISO 8601 hebben (bijvoorbeeld PT05S om na 5 seconden te beginnen), of een aantal frames (bijvoorbeeld 10 om te beginnen bij het 10e frame) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% om te beginnen bij 10% van de duur van de stroom). Ondersteunt ook een macro {Best}, die de encoder vertelt om de beste miniatuur te selecteren vanaf de eerste paar seconden van de video en slechts één miniatuur produceert, ongeacht de andere instellingen voor Stap en Bereik. De standaardwaarde is macro {Best}. |
step |
string |
De intervallen waarmee miniaturen worden gegenereerd. De waarde kan de ISO 8601-indeling hebben (bijvoorbeeld PT05S voor één afbeelding elke 5 seconden), of een aantal frames (bijvoorbeeld 30 voor één afbeelding per 30 frames) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% voor één afbeelding per 10% van de duur van de stroom). Opmerking: de stapwaarde is van invloed op de eerste gegenereerde miniatuur, die mogelijk niet precies de miniatuur is die is opgegeven bij de vooraf ingestelde begintijd van de transformatie. Dit komt door de encoder, die de beste miniatuur probeert te selecteren tussen begintijd en Stappositie vanaf de begintijd als eerste uitvoer. Omdat de standaardwaarde 10% is, betekent dit dat als de stream een lange duur heeft, de eerste gegenereerde miniatuur mogelijk ver verwijderd is van de miniatuur die is opgegeven bij het begintijd. Probeer een redelijke waarde te selecteren voor Stap als de eerste miniatuur bijna bij de begintijd wordt verwacht, of stel bereikwaarde in op 1 als er slechts één miniatuur nodig is op het begintijd. |
stretchMode |
De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize |
|
syncMode |
De videosynchronisatiemodus |
ImageFormat
Beschrijft de eigenschappen voor een uitvoerafbeeldingsbestand.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
filenamePattern |
string |
Het naamgevingspatroon voor bestanden dat wordt gebruikt voor het maken van uitvoerbestanden. De volgende macro's worden ondersteund in de bestandsnaam: {Basename} - Een uitbreidingsmacro die de naam van het invoervideobestand gebruikt. Als de basisnaam (het bestandsachtervoegsel is niet opgenomen) van het invoervideobestand minder dan 32 tekens lang is, wordt de basisnaam van de invoervideobestanden gebruikt. Als de basisnaam van het invoervideobestand langer is dan 32 tekens, wordt de basisnaam afgekapt tot de eerste 32 tekens in totale lengte. {Extension} - De juiste extensie voor deze indeling. {Label}: het label dat is toegewezen aan de codec/laag. {Index} - Een unieke index voor miniaturen. Alleen van toepassing op miniaturen. {AudioStream} - tekenreeks "Audio" plus audiostreamnummer (beginnen vanaf 1). {Bitrate} - De audio-/videobitsnelheid in kbps. Niet van toepassing op miniaturen. {Codec} - Het type van de audio-/videocodec. {Resolution} - De videoresolutie. Alle niet-substitueerde macro's worden samengevouwen en uit de bestandsnaam verwijderd. |
InsightsType
Definieert het type inzichten dat de service moet genereren. De toegestane waarden zijn 'AudioInsightsOnly', 'VideoInsightsOnly' en 'AllInsights'. De standaardwaarde is AllInsights. Als u dit instelt op AllInsights en de invoer alleen audio is, worden alleen audio-inzichten gegenereerd. Als de invoer alleen video is, worden alleen video-inzichten gegenereerd. Het is raadzaam audioInsightsOnly niet te gebruiken als u verwacht dat sommige van uw invoer alleen video zijn; of gebruik VideoInsightsOnly als u verwacht dat sommige invoer alleen audio is. Uw taken in dergelijke omstandigheden zouden een foutmelding geven.
Name | Type | Description |
---|---|---|
AllInsights |
string |
Genereer zowel audio- als video-inzichten. Mislukt als audio- of video-inzichten mislukken. |
AudioInsightsOnly |
string |
Genereer alleen audio-inzichten. Video negeren, zelfs als deze aanwezig is. Mislukt als er geen audio aanwezig is. |
VideoInsightsOnly |
string |
Genereer alleen video-inzichten. Audio negeren indien aanwezig. Mislukt als er geen video aanwezig is. |
InterleaveOutput
Hiermee stelt u de interleave-modus van de uitvoer in om te bepalen hoe audio en video worden opgeslagen in de containerindeling. Voorbeeld: stel InterleavedOutput in op NonInterleavedOutput om alleen-audio- en video-uitvoer te produceren in afzonderlijke MP4-bestanden.
Name | Type | Description |
---|---|---|
InterleavedOutput |
string |
De uitvoer bevat zowel audio als video. |
NonInterleavedOutput |
string |
De uitvoer is alleen video of alleen audio. |
JpgFormat
Beschrijft de instellingen voor het produceren van JPEG-miniaturen.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
filenamePattern |
string |
Het naamgevingspatroon voor bestanden dat wordt gebruikt voor het maken van uitvoerbestanden. De volgende macro's worden ondersteund in de bestandsnaam: {Basename} - Een uitbreidingsmacro die de naam van het invoervideobestand gebruikt. Als de basisnaam (het bestandsachtervoegsel is niet opgenomen) van het invoervideobestand minder dan 32 tekens lang is, wordt de basisnaam van de invoervideobestanden gebruikt. Als de basisnaam van het invoervideobestand langer is dan 32 tekens, wordt de basisnaam afgekapt tot de eerste 32 tekens in totale lengte. {Extension} - De juiste extensie voor deze indeling. {Label}: het label dat is toegewezen aan de codec/laag. {Index} - Een unieke index voor miniaturen. Alleen van toepassing op miniaturen. {AudioStream} - tekenreeks "Audio" plus audiostreamnummer (beginnen vanaf 1). {Bitrate} - De audio-/videobitsnelheid in kbps. Niet van toepassing op miniaturen. {Codec} - Het type van de audio-/videocodec. {Resolution} - De videoresolutie. Alle niet-substitueerde macro's worden samengevouwen en uit de bestandsnaam verwijderd. |
JpgImage
Beschrijft de eigenschappen voor het produceren van een reeks JPEG-afbeeldingen op basis van de invoervideo.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
keyFrameInterval |
string |
De afstand tussen twee belangrijke frames. De waarde moet niet nul zijn in het bereik [0,5, 20] seconden, opgegeven in ISO 8601-indeling. De standaardwaarde is 2 seconden (PT2S). Houd er rekening mee dat deze instelling wordt genegeerd als VideoSyncMode.Passthrough is ingesteld, waarbij de waarde KeyFrameInterval de instelling van de invoerbron volgt. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
layers |
Jpg |
Een verzameling jpeg-uitvoerlagen die moeten worden geproduceerd door de encoder. |
range |
string |
De positie ten opzichte van het transformeren van de vooraf ingestelde begintijd in de invoervideo waarop het genereren van miniaturen moet worden gestopt. De waarde kan een ISO 8601-indeling hebben (bijvoorbeeld PT5M30S om te stoppen bij 5 minuten en 30 seconden vanaf de begintijd) of een aantal frames (bijvoorbeeld 300 om te stoppen bij het 300e frame van het frame op de begintijd. Als deze waarde 1 is, betekent dit dat er slechts één miniatuur wordt geproduceerd bij het begintijd) of een relatieve waarde ten opzichte van de duur van de stroom (bijvoorbeeld 50% om te stoppen bij de helft van de duur van de stream vanaf de begintijd). De standaardwaarde is 100%, wat betekent dat u stopt aan het einde van de stream. |
spriteColumn |
integer |
Hiermee stelt u het aantal kolommen in dat wordt gebruikt in de miniatuurafbeelding van sprite. Het aantal rijen wordt automatisch berekend en er wordt een VTT-bestand gegenereerd met de coördinatentoewijzingen voor elke miniatuur in de sprite. Opmerking: deze waarde moet een positief geheel getal zijn en een juiste waarde wordt aanbevolen, zodat de uitvoerafbeeldingsresolutie niet verder gaat dan de maximale JPEG-pixelresolutielimiet 65535x65535. |
start |
string |
De positie in de invoervideo van waaruit miniaturen moeten worden gegenereerd. De waarde kan de indeling ISO 8601 hebben (bijvoorbeeld PT05S om na 5 seconden te beginnen), of een aantal frames (bijvoorbeeld 10 om te beginnen bij het 10e frame) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% om te beginnen bij 10% van de duur van de stroom). Ondersteunt ook een macro {Best}, die de encoder vertelt om de beste miniatuur te selecteren vanaf de eerste paar seconden van de video en slechts één miniatuur produceert, ongeacht de andere instellingen voor Stap en Bereik. De standaardwaarde is macro {Best}. |
step |
string |
De intervallen waarmee miniaturen worden gegenereerd. De waarde kan de ISO 8601-indeling hebben (bijvoorbeeld PT05S voor één afbeelding elke 5 seconden), of een aantal frames (bijvoorbeeld 30 voor één afbeelding per 30 frames) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% voor één afbeelding per 10% van de duur van de stroom). Opmerking: de stapwaarde is van invloed op de eerste gegenereerde miniatuur, die mogelijk niet precies de miniatuur is die is opgegeven bij de vooraf ingestelde begintijd van de transformatie. Dit komt door de encoder, die de beste miniatuur probeert te selecteren tussen begintijd en Stappositie vanaf de begintijd als eerste uitvoer. Omdat de standaardwaarde 10% is, betekent dit dat als de stream een lange duur heeft, de eerste gegenereerde miniatuur mogelijk ver verwijderd is van de miniatuur die is opgegeven bij het begintijd. Probeer een redelijke waarde te selecteren voor Stap als de eerste miniatuur bijna bij de begintijd wordt verwacht, of stel bereikwaarde in op 1 als er slechts één miniatuur nodig is op het begintijd. |
stretchMode |
De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize |
|
syncMode |
De videosynchronisatiemodus |
JpgLayer
Beschrijft de instellingen voor het produceren van een JPEG-afbeelding op basis van de invoervideo.
Name | Type | Description |
---|---|---|
height |
string |
De hoogte van de uitvoervideo voor deze laag. De waarde kan absoluut (in pixels) of relatief (in percentage) zijn. 50% betekent bijvoorbeeld dat de uitvoervideo half zoveel pixels hoog is als de invoer. |
label |
string |
Het alfanumerieke label voor deze laag, dat kan worden gebruikt bij het multiplexen van verschillende video- en audiolagen of bij het benoemen van het uitvoerbestand. |
quality |
integer |
De compressiekwaliteit van de JPEG-uitvoer. Het bereik ligt tussen 0 en 100 en de standaardwaarde is 70. |
width |
string |
De breedte van de uitvoervideo voor deze laag. De waarde kan absoluut (in pixels) of relatief (in percentage) zijn. 50% betekent bijvoorbeeld dat de uitvoervideo half zoveel pixels breed heeft als de invoer. |
Mp4Format
Beschrijft de eigenschappen voor een ISO MP4-uitvoerbestand.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
filenamePattern |
string |
Het naamgevingspatroon voor bestanden dat wordt gebruikt voor het maken van uitvoerbestanden. De volgende macro's worden ondersteund in de bestandsnaam: {Basename} - Een uitbreidingsmacro die de naam van het invoervideobestand gebruikt. Als de basisnaam (het bestandsachtervoegsel is niet opgenomen) van het invoervideobestand minder dan 32 tekens lang is, wordt de basisnaam van de invoervideobestanden gebruikt. Als de basisnaam van het invoervideobestand langer is dan 32 tekens, wordt de basisnaam afgekapt tot de eerste 32 tekens in totale lengte. {Extension} - De juiste extensie voor deze indeling. {Label}: het label dat is toegewezen aan de codec/laag. {Index} - Een unieke index voor miniaturen. Alleen van toepassing op miniaturen. {AudioStream} - tekenreeks "Audio" plus audiostreamnummer (beginnen vanaf 1). {Bitrate} - De audio-/videobitsnelheid in kbps. Niet van toepassing op miniaturen. {Codec} - Het type van de audio-/videocodec. {Resolution} - De videoresolutie. Alle niet-substitueerde macro's worden samengevouwen en uit de bestandsnaam verwijderd. |
outputFiles |
De lijst met uitvoerbestanden die moeten worden geproduceerd. Elke vermelding in de lijst is een set labels voor audio- en videolagen die samen moeten worden gemuxeerd. |
MultiBitrateFormat
Beschrijft de eigenschappen voor het produceren van een verzameling gop-uitgelijnde multi-bitrate bestanden. Het standaardgedrag is om één uitvoerbestand te produceren voor elke videolaag die samen met alle audio wordt gemuxt. De exacte uitvoerbestanden die worden geproduceerd, kunnen worden beheerd door de verzameling outputFiles op te geven.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
filenamePattern |
string |
Het naamgevingspatroon voor bestanden dat wordt gebruikt voor het maken van uitvoerbestanden. De volgende macro's worden ondersteund in de bestandsnaam: {Basename} - Een uitbreidingsmacro die de naam van het invoervideobestand gebruikt. Als de basisnaam (het bestandsachtervoegsel is niet opgenomen) van het invoervideobestand minder dan 32 tekens lang is, wordt de basisnaam van de invoervideobestanden gebruikt. Als de basisnaam van het invoervideobestand langer is dan 32 tekens, wordt de basisnaam afgekapt tot de eerste 32 tekens in totale lengte. {Extension} - De juiste extensie voor deze indeling. {Label}: het label dat is toegewezen aan de codec/laag. {Index} - Een unieke index voor miniaturen. Alleen van toepassing op miniaturen. {AudioStream} - tekenreeks "Audio" plus audiostreamnummer (beginnen vanaf 1). {Bitrate} - De audio-/videobitsnelheid in kbps. Niet van toepassing op miniaturen. {Codec} - Het type van de audio-/videocodec. {Resolution} - De videoresolutie. Alle niet-substitueerde macro's worden samengevouwen en uit de bestandsnaam verwijderd. |
outputFiles |
De lijst met uitvoerbestanden die moeten worden geproduceerd. Elke vermelding in de lijst is een set labels voor audio- en videolagen die samen moeten worden gemuxeerd. |
OnErrorType
Een transformatie kan meer dan één uitvoer definiëren. Deze eigenschap definieert wat de service moet doen wanneer een uitvoer mislukt. Ga door met het produceren van andere uitvoer of stop de andere uitvoer. De algehele taakstatus geeft geen fouten weer van uitvoer die zijn opgegeven met 'ContinueJob'. De standaardwaarde is 'StopProcessingJob'.
Name | Type | Description |
---|---|---|
ContinueJob |
string |
Geeft aan de service door dat als deze TransformOutput mislukt, een andere TransformOutput wordt toegestaan om door te gaan. |
StopProcessingJob |
string |
Vertelt de service dat als deze TransformOutput mislukt, alle andere onvolledige TransformOutputs kunnen worden gestopt. |
OutputFile
Vertegenwoordigt een geproduceerd uitvoerbestand.
Name | Type | Description |
---|---|---|
labels |
string[] |
De lijst met labels die beschrijven hoe de encoder video en audio moet multiplexen in een uitvoerbestand. Als de encoder bijvoorbeeld twee videolagen met labels v1 en v2 en één audiolaag met label a1 produceert, geeft een matrix zoals '[v1, a1]' aan dat de encoder een uitvoerbestand moet produceren met de videotrack die wordt vertegenwoordigd door v1 en het audiospoor dat wordt vertegenwoordigd door a1. |
PngFormat
Hierin worden de instellingen beschreven voor het produceren van PNG-miniaturen.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
filenamePattern |
string |
Het naamgevingspatroon voor bestanden dat wordt gebruikt voor het maken van uitvoerbestanden. De volgende macro's worden ondersteund in de bestandsnaam: {Basename} - Een uitbreidingsmacro die de naam van het invoervideobestand gebruikt. Als de basisnaam (het bestandsachtervoegsel is niet opgenomen) van het invoervideobestand minder dan 32 tekens lang is, wordt de basisnaam van de invoervideobestanden gebruikt. Als de basisnaam van het invoervideobestand langer is dan 32 tekens, wordt de basisnaam afgekapt tot de eerste 32 tekens in totale lengte. {Extension} - De juiste extensie voor deze indeling. {Label}: het label dat is toegewezen aan de codec/laag. {Index} - Een unieke index voor miniaturen. Alleen van toepassing op miniaturen. {AudioStream} - tekenreeks "Audio" plus audiostreamnummer (beginnen vanaf 1). {Bitrate} - De audio-/videobitsnelheid in kbps. Niet van toepassing op miniaturen. {Codec} - Het type van de audio-/videocodec. {Resolution} - De videoresolutie. Alle niet-substitueerde macro's worden samengevouwen en uit de bestandsnaam verwijderd. |
PngImage
Beschrijft de eigenschappen voor het produceren van een reeks PNG-afbeeldingen op basis van de invoervideo.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
keyFrameInterval |
string |
De afstand tussen twee belangrijke frames. De waarde moet niet nul zijn in het bereik [0,5, 20] seconden, opgegeven in ISO 8601-indeling. De standaardwaarde is 2 seconden (PT2S). Houd er rekening mee dat deze instelling wordt genegeerd als VideoSyncMode.Passthrough is ingesteld, waarbij de waarde KeyFrameInterval de instelling van de invoerbron volgt. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
layers |
Png |
Een verzameling uitvoer-PNG-afbeeldingslagen die moeten worden geproduceerd door de encoder. |
range |
string |
De positie ten opzichte van het transformeren van de vooraf ingestelde begintijd in de invoervideo waarop het genereren van miniaturen moet worden gestopt. De waarde kan een ISO 8601-indeling hebben (bijvoorbeeld PT5M30S om te stoppen bij 5 minuten en 30 seconden vanaf de begintijd) of een aantal frames (bijvoorbeeld 300 om te stoppen bij het 300e frame van het frame op de begintijd. Als deze waarde 1 is, betekent dit dat er slechts één miniatuur wordt geproduceerd bij het begintijd) of een relatieve waarde ten opzichte van de duur van de stroom (bijvoorbeeld 50% om te stoppen bij de helft van de duur van de stream vanaf de begintijd). De standaardwaarde is 100%, wat betekent dat u stopt aan het einde van de stream. |
start |
string |
De positie in de invoervideo van waaruit miniaturen moeten worden gegenereerd. De waarde kan de indeling ISO 8601 hebben (bijvoorbeeld PT05S om na 5 seconden te beginnen), of een aantal frames (bijvoorbeeld 10 om te beginnen bij het 10e frame) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% om te beginnen bij 10% van de duur van de stroom). Ondersteunt ook een macro {Best}, die de encoder vertelt om de beste miniatuur te selecteren vanaf de eerste paar seconden van de video en slechts één miniatuur produceert, ongeacht de andere instellingen voor Stap en Bereik. De standaardwaarde is macro {Best}. |
step |
string |
De intervallen waarmee miniaturen worden gegenereerd. De waarde kan de ISO 8601-indeling hebben (bijvoorbeeld PT05S voor één afbeelding elke 5 seconden), of een aantal frames (bijvoorbeeld 30 voor één afbeelding per 30 frames) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% voor één afbeelding per 10% van de duur van de stroom). Opmerking: de stapwaarde is van invloed op de eerste gegenereerde miniatuur, die mogelijk niet precies de miniatuur is die is opgegeven bij de vooraf ingestelde begintijd van de transformatie. Dit komt door de encoder, die de beste miniatuur probeert te selecteren tussen begintijd en Stappositie vanaf de begintijd als eerste uitvoer. Omdat de standaardwaarde 10% is, betekent dit dat als de stream een lange duur heeft, de eerste gegenereerde miniatuur mogelijk ver verwijderd is van de miniatuur die is opgegeven bij het begintijd. Probeer een redelijke waarde te selecteren voor Stap als de eerste miniatuur bijna bij de begintijd wordt verwacht, of stel bereikwaarde in op 1 als er slechts één miniatuur nodig is op het begintijd. |
stretchMode |
De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize |
|
syncMode |
De videosynchronisatiemodus |
PngLayer
Beschrijft de instellingen voor het produceren van een PNG-afbeelding op basis van de invoervideo.
Name | Type | Description |
---|---|---|
height |
string |
De hoogte van de uitvoervideo voor deze laag. De waarde kan absoluut (in pixels) of relatief (in percentage) zijn. 50% betekent bijvoorbeeld dat de uitvoervideo half zoveel pixels in hoogte heeft als de invoer. |
label |
string |
Het alfanumerieke label voor deze laag, dat kan worden gebruikt bij het multiplexen van verschillende video- en audiolagen of bij het benoemen van het uitvoerbestand. |
width |
string |
De breedte van de uitvoervideo voor deze laag. De waarde kan absoluut (in pixels) of relatief (in percentage) zijn. 50% betekent bijvoorbeeld dat de uitvoervideo half zoveel pixels breed is als de invoer. |
PresetConfigurations
Een object met optionele configuratie-instellingen voor encoder.
Name | Type | Description |
---|---|---|
complexity |
Hiermee kunt u de encoderinstellingen configureren om de balans tussen snelheid en kwaliteit te regelen. Voorbeeld: stel Complexiteit in op Snelheid voor snellere codering, maar minder compressie-efficiëntie. |
|
interleaveOutput |
Hiermee stelt u de interleavemodus van de uitvoer in om te bepalen hoe audio en video worden opgeslagen in de containerindeling. Voorbeeld: stel InterleavedOutput in op NonInterleavedOutput om alleen-audio- en video-only-uitvoer in afzonderlijke MP4-bestanden te produceren. |
|
keyFrameIntervalInSeconds |
number |
Het sleutelframeinterval in seconden. Voorbeeld: stel KeyFrameIntervalInSeconds in op 2 om de afspeelbuffer voor sommige spelers te verminderen. |
maxBitrateBps |
integer |
De maximale bitrate in bits per seconde (drempelwaarde voor de bovenste videolaag). Voorbeeld: stel MaxBitrateBps in op 6000000 om te voorkomen dat zeer hoge bitrate-uitvoer wordt geproduceerd voor inhoud met een hoge complexiteit. |
maxHeight |
integer |
De maximale hoogte van uitvoervideolagen. Voorbeeld: stel MaxHeight in op 720 om uitvoerlagen tot 720P te produceren, zelfs als de invoer 4K is. |
maxLayers |
integer |
Het maximum aantal uitvoervideolagen. Voorbeeld: stel MaxLayers in op 4 om ervoor te zorgen dat er maximaal vier uitvoerlagen worden geproduceerd om de totale kosten van de coderingstaak te beheren. |
minBitrateBps |
integer |
De minimale bitrate in bits per seconde (drempelwaarde voor de onderste videolaag). Voorbeeld: stel MinBitrateBps in op 200000 om een onderste laag te hebben die gebruikers met een lage netwerkbandbreedte dekt. |
minHeight |
integer |
De minimale hoogte van uitvoervideolagen. Voorbeeld: stel MinHeight in op 360 om uitvoerlagen met kleinere resoluties zoals 180P te voorkomen. |
Priority
Hiermee stelt u de relatieve prioriteit van de TransformOutputs binnen een transformatie. Hiermee wordt de prioriteit ingesteld die de service gebruikt voor het verwerken van TransformOutputs. De standaardprioriteit is Normaal.
Name | Type | Description |
---|---|---|
High |
string |
Wordt gebruikt voor TransformOutputs die voorrang moeten hebben op andere. |
Low |
string |
Wordt gebruikt voor TransformOutputs die kunnen worden gegenereerd na TransformOutputs met normale en hoge prioriteit. |
Normal |
string |
Wordt gebruikt voor TransformOutputs die kunnen worden gegenereerd met normale prioriteit. |
Rectangle
Beschrijft de eigenschappen van een rechthoekig venster dat op de invoermedia wordt toegepast voordat het wordt verwerkt.
Name | Type | Description |
---|---|---|
height |
string |
De hoogte van het rechthoekige gebied in pixels. Dit kan een absolute pixelwaarde zijn (bijvoorbeeld 100) of ten opzichte van de grootte van de video (bijvoorbeeld 50%). |
left |
string |
Het aantal pixels vanaf de linkermarge. Dit kan een absolute pixelwaarde zijn (bijvoorbeeld 100) of ten opzichte van de grootte van de video (bijvoorbeeld 50%). |
top |
string |
Het aantal pixels vanaf de bovenmarge. Dit kan een absolute pixelwaarde zijn (bijvoorbeeld 100) of ten opzichte van de grootte van de video (bijvoorbeeld 50%). |
width |
string |
De breedte van het rechthoekige gebied in pixels. Dit kan een absolute pixelwaarde zijn (bijvoorbeeld 100) of ten opzichte van de grootte van de video (bijvoorbeeld 50%). |
Rotation
De draaiing, indien aanwezig, die moet worden toegepast op de invoervideo, voordat deze wordt gecodeerd. De standaardwaarde is Automatisch
Name | Type | Description |
---|---|---|
Auto |
string |
Automatisch detecteren en roteren als dat nodig is. |
None |
string |
Draai de video niet. Als de uitvoerindeling dit ondersteunt, worden alle metagegevens over rotatie intact gehouden. |
Rotate0 |
string |
Draai de video niet, maar verwijder metagegevens over de rotatie. |
Rotate180 |
string |
Draai 180 graden met de klok mee. |
Rotate270 |
string |
Draai 270 graden met de klok mee. |
Rotate90 |
string |
Draai 90 graden met de klok mee. |
StandardEncoderPreset
Hierin worden alle instellingen beschreven die moeten worden gebruikt bij het coderen van de invoervideo met de Standard Encoder.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
codecs | Codec[]: |
De lijst met codecs die moeten worden gebruikt bij het coderen van de invoervideo. |
experimentalOptions |
object |
Woordenlijst met sleutelwaardeparen voor parameters die niet beschikbaar zijn in de voorinstelling zelf |
filters |
Een of meer filterbewerkingen die worden toegepast op de invoermedia voordat ze worden gecodeerd. |
|
formats | Format[]: |
De lijst met uitvoer die moet worden geproduceerd door de encoder. |
StretchMode
De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize
Name | Type | Description |
---|---|---|
AutoFit |
string |
Pad de uitvoer (met letterbox of pilaar) om de uitvoerresolutie te behouden, terwijl u ervoor zorgt dat het actieve videogebied in de uitvoer dezelfde hoogte-breedteverhouding heeft als de invoer. Als de invoer bijvoorbeeld 1920x1080 is en de vooraf ingestelde codering vraagt om 1280x1280, is de uitvoer 1280x1280, die een binnenste rechthoek van 1280x720 met een hoogte-breedteverhouding van 16:9 en kolomvakgebieden van 280 pixels breed aan de linkerkant en rechts. |
AutoSize |
string |
Overschrijf de uitvoerresolutie en wijzig deze zodat deze overeenkomt met de hoogte-breedteverhouding van de invoer, zonder opvulling. Als de invoer bijvoorbeeld 1920x1080 is en de voorinstelling voor codering vraagt om 1280x1280, wordt de waarde in de voorinstelling overschreven en is de uitvoer 1280x720, waardoor de hoogte-breedteverhouding van de invoer 16:9 behouden blijft. |
None |
string |
Respecteer de uitvoerresolutie zonder rekening te houden met de pixel-hoogte-breedteverhouding of beeldschermverhouding van de invoervideo. |
systemData
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
De tijdstempel van het maken van resources (UTC). |
createdBy |
string |
De identiteit die de resource heeft gemaakt. |
createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
lastModifiedAt |
string |
Het tijdstempel van de laatste wijziging van de resource (UTC) |
lastModifiedBy |
string |
De identiteit die de resource het laatst heeft gewijzigd. |
lastModifiedByType |
Het type identiteit dat de resource het laatst heeft gewijzigd. |
Transform
Een transformatie omvat de regels of instructies voor het genereren van gewenste uitvoer van invoermedia, zoals door transcodering of door het extraheren van inzichten. Nadat de transformatie is gemaakt, kan deze worden toegepast op invoermedia door taken te maken.
Name | Type | Description |
---|---|---|
id |
string |
Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
De naam van de resource |
properties.created |
string |
De UTC-datum en -tijd waarop de transformatie is gemaakt, in de indeling 'JJJJ-MM-DDThh:mm:ssZ'. |
properties.description |
string |
Een optionele uitgebreide beschrijving van de transformatie. |
properties.lastModified |
string |
De UTC-datum en -tijd waarop de transformatie voor het laatst is bijgewerkt, in de indeling 'JJJJ-MM-DDThh:mm:ssZ'. |
properties.outputs |
Een matrix van een of meer TransformOutputs die door de transformatie moeten worden gegenereerd. |
|
systemData |
De systeemmetagegevens met betrekking tot deze resource. |
|
type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
TransformOutput
Beschrijft de eigenschappen van een TransformOutput. Dit zijn de regels die moeten worden toegepast tijdens het genereren van de gewenste uitvoer.
Name | Type | Description |
---|---|---|
onError |
Een transformatie kan meer dan één uitvoer definiëren. Deze eigenschap definieert wat de service moet doen wanneer een uitvoer mislukt. Ga door met het produceren van andere uitvoer of stop de andere uitvoer. De algehele taakstatus geeft geen fouten weer van uitvoer die zijn opgegeven met 'ContinueJob'. De standaardwaarde is 'StopProcessingJob'. |
|
preset | Preset: |
Vooraf ingesteld die de bewerkingen beschrijft die worden gebruikt voor het wijzigen, transcoderen of extraheren van inzichten uit het bronbestand om de uitvoer te genereren. |
relativePriority |
Hiermee stelt u de relatieve prioriteit van de TransformOutputs binnen een transformatie. Hiermee wordt de prioriteit ingesteld die de service gebruikt voor het verwerken van TransformOutputs. De standaardprioriteit is Normaal. |
TransportStreamFormat
Beschrijft de eigenschappen voor het genereren van een MPEG-2 Transport Stream(ISO/IEC 13818-1) uitvoervideobestand(en).
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
filenamePattern |
string |
Het naamgevingspatroon voor bestanden dat wordt gebruikt voor het maken van uitvoerbestanden. De volgende macro's worden ondersteund in de bestandsnaam: {Basename} - Een uitbreidingsmacro die de naam van het invoervideobestand gebruikt. Als de basisnaam (het bestandsachtervoegsel is niet opgenomen) van het invoervideobestand minder dan 32 tekens lang is, wordt de basisnaam van de invoervideobestanden gebruikt. Als de basisnaam van het invoervideobestand langer is dan 32 tekens, wordt de basisnaam afgekapt tot de eerste 32 tekens in totale lengte. {Extension} - De juiste extensie voor deze indeling. {Label}: het label dat is toegewezen aan de codec/laag. {Index} - Een unieke index voor miniaturen. Alleen van toepassing op miniaturen. {AudioStream} - tekenreeks "Audio" plus audiostreamnummer (beginnen vanaf 1). {Bitrate} - De audio-/videobitsnelheid in kbps. Niet van toepassing op miniaturen. {Codec} - Het type van de audio-/videocodec. {Resolution} - De videoresolutie. Alle niet-substitueerde macro's worden samengevouwen en uit de bestandsnaam verwijderd. |
outputFiles |
De lijst met uitvoerbestanden die moeten worden geproduceerd. Elke vermelding in de lijst is een set labels voor audio- en videolagen die samen moeten worden gemuxeerd. |
Video
Beschrijft de basiseigenschappen voor het coderen van de invoervideo.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
keyFrameInterval |
string |
De afstand tussen twee belangrijke frames. De waarde moet niet nul zijn in het bereik [0,5, 20] seconden, opgegeven in ISO 8601-indeling. De standaardwaarde is 2 seconden (PT2S). Houd er rekening mee dat deze instelling wordt genegeerd als VideoSyncMode.Passthrough is ingesteld, waarbij de waarde KeyFrameInterval de instelling van de invoerbron volgt. |
label |
string |
Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te regelen. |
stretchMode |
De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize |
|
syncMode |
De videosynchronisatiemodus |
VideoAnalyzerPreset
Een vooraf ingestelde videoanalyse die inzichten (uitgebreide metagegevens) uit zowel audio als video haalt en een bestand in JSON-indeling uitvoert.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
audioLanguage |
string |
De taal voor de audiopayload in de invoer met behulp van de BCP-47-indeling van 'language tag-region' (bijvoorbeeld 'en-US'). Als u de taal van uw inhoud kent, is het raadzaam deze op te geven. De taal moet expliciet worden opgegeven voor AudioAnalysisMode::Basic, omdat automatische taaldetectie niet is opgenomen in de basismodus. Als de taal niet is opgegeven of ingesteld op null, kiest automatische taaldetectie de eerste gedetecteerde taal en verwerkt met de geselecteerde taal voor de duur van het bestand. Het biedt momenteel geen ondersteuning voor dynamisch schakelen tussen talen nadat de eerste taal is gedetecteerd. De automatische detectie werkt het beste met audio-opnamen met duidelijk waarneembare spraak. Als automatische detectie de taal niet kan vinden, zou transcriptie terugvallen op 'en-US'. De lijst met ondersteunde talen is hier beschikbaar: https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
Woordenlijst met sleutelwaardeparen voor parameters die niet beschikbaar zijn in de voorinstelling zelf |
insightsToExtract |
Definieert het type inzichten dat de service moet genereren. De toegestane waarden zijn 'AudioInsightsOnly', 'VideoInsightsOnly' en 'AllInsights'. De standaardwaarde is AllInsights. Als u dit instelt op AllInsights en de invoer alleen audio is, worden alleen audio-inzichten gegenereerd. Als de invoer alleen video is, worden alleen video-inzichten gegenereerd. Het is raadzaam audioInsightsOnly niet te gebruiken als u verwacht dat sommige van uw invoer alleen video zijn; of gebruik VideoInsightsOnly als u verwacht dat sommige invoer alleen audio is. Uw taken in dergelijke omstandigheden zouden een foutmelding geven. |
|
mode |
Bepaalt de set audioanalysebewerkingen die moeten worden uitgevoerd. Als dit niet wordt opgegeven, wordt de Standaard AudioAnalysisMode gekozen. |
VideoOverlay
Beschrijft de eigenschappen van een video-overlay.
Name | Type | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
De discriminator voor afgeleide typen. |
audioGainLevel |
number |
Het versterkingsniveau van audio in de overlay. De waarde moet in het bereik [0, 1,0] liggen. De standaardwaarde is 1.0. |
cropRectangle |
Een optioneel rechthoekig venster dat wordt gebruikt om de overlayafbeelding of video bij te snijden. |
|
end |
string |
De eindpositie, met verwijzing naar de invoervideo, waarop de overlay eindigt. De waarde moet de INDELING ISO 8601 hebben. Bijvoorbeeld PT30S om de overlay na 30 seconden te beëindigen in de invoervideo. Als niet is opgegeven of als de waarde groter is dan de duur van de invoervideo, wordt de overlay toegepast tot het einde van de invoervideo als de duur van de overlaymedia groter is dan de duur van de invoervideo, anders duurt de overlay net zo lang als de duur van de overlaymedia. |
fadeInDuration |
string |
De duur waarover de overlay vervaagt in de invoervideo. De waarde moet de ISO 8601-duurnotatie hebben. Als dit niet is opgegeven, is het standaardgedrag dat er geen infade is (hetzelfde als PT0S). |
fadeOutDuration |
string |
De duur gedurende welke de overlay uit de invoervideo vervaagt. De waarde moet de ISO 8601-duurnotatie hebben. Als dit niet is opgegeven, is het standaardgedrag dat er geen fade-out is (hetzelfde als PT0S). |
inputLabel |
string |
Het label van de taakinvoer die moet worden gebruikt als een overlay. De invoer moet precies één bestand opgeven. U kunt een afbeeldingsbestand opgeven in JPG-, PNG-, GIF- of BMP-indeling, of een audiobestand (zoals een WAV-, MP3-, WMA- of M4A-bestand) of een videobestand. Zie https://aka.ms/mesformats voor de volledige lijst met ondersteunde audio- en videobestandsindelingen. |
opacity |
number |
De matheid van de overlay. Dit is een waarde in het bereik [0 - 1,0]. De standaardwaarde is 1,0, wat betekent dat de overlay ondoorzichtig is. |
position |
De locatie in de invoervideo waar de overlay wordt toegepast. |
|
start |
string |
De beginpositie, met verwijzing naar de invoervideo, waarop de overlay begint. De waarde moet de INDELING ISO 8601 hebben. Bijvoorbeeld PT05S om de overlay op 5 seconden in de invoervideo te starten. Als dit niet is opgegeven, wordt de overlay gestart vanaf het begin van de invoervideo. |
VideoSyncMode
De videosynchronisatiemodus
Name | Type | Description |
---|---|---|
Auto |
string |
Dit is de standaardmethode. Kiest tussen Cfr en Vfr, afhankelijk van muxer-mogelijkheden. Voor uitvoerindeling MP4 is de standaardmodus Cfr. |
Cfr |
string |
Invoerframes worden zo nodig herhaald en/of verwijderd om precies de aangevraagde constante framesnelheid te bereiken. Aanbevolen wanneer de uitvoerframesnelheid expliciet is ingesteld op een opgegeven waarde |
Passthrough |
string |
De tijdstempels van de presentatie op frames worden doorgegeven van het invoerbestand naar de schrijver van het uitvoerbestand. Aanbevolen wanneer de invoerbron een variabele framesnelheid heeft en meerdere lagen probeert te produceren voor adaptieve streaming in de uitvoer met uitgelijnde GOP-grenzen. Opmerking: als twee of meer frames in de invoer dubbele tijdstempels hebben, heeft de uitvoer ook hetzelfde gedrag |
Vfr |
string |
Vergelijkbaar met de passthrough-modus, maar als de invoer frames bevat met dubbele tijdstempels, wordt slechts één frame doorgegeven aan de uitvoer en worden andere frames verwijderd. Aanbevolen wanneer het aantal uitvoerframes naar verwachting gelijk is aan het aantal invoerframes. De uitvoer wordt bijvoorbeeld gebruikt om een kwaliteitswaarde zoals PSNR te berekenen op basis van de invoer |