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
accountName
path True

string

De naam van het Media Services-account.

resourceGroupName
path True

string

De naam van de resourcegroep binnen het Azure-abonnement.

subscriptionId
path True

string

De unieke id voor een Microsoft Azure-abonnement.

transformName
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

TransformOutput[]

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

Transform

OK

201 Created

Transform

Gemaakt

Other Status Codes

ErrorResponse

Gedetailleerde foutinformatie.

Voorbeelden

Create or update a Transform

Sample Request

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"
        }
      }
    ]
  }
}

Sample Response

{
  "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
AacAudio

Beschrijft de audiocoderingsinstellingen van Advanced Audio Codec (AAC).

AacAudioProfile

Het coderingsprofiel dat moet worden gebruikt bij het coderen van audio met AAC.

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.

Audio

Hiermee definieert u de algemene eigenschappen voor alle audiocodecs.

AudioAnalysisMode

Bepaalt de set audioanalysebewerkingen die moeten worden uitgevoerd. Als dit niet wordt opgegeven, wordt de Standaard AudioAnalysisMode gekozen.

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.

AudioOverlay

Beschrijft de eigenschappen van een audio-overlay.

BlurType

Type vervagen

BuiltInStandardEncoderPreset

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.

CopyAudio

Een codecvlag, waarmee de encoder de bitstream van de invoeraudio moet kopiëren.

CopyVideo

Een codecvlag, waarmee de encoder de bitstream van de invoervideo moet kopiëren zonder opnieuw te coderen.

createdByType

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.

DeinterlaceMode

De deinterlacingmodus. De standaardwaarde is AutoPixelAdaptive.

DeinterlaceParity

De veldpariteit voor het verwijderen van interlacing wordt standaard ingesteld op Automatisch.

EncoderNamedPreset

De ingebouwde voorinstelling die moet worden gebruikt voor het coderen van video's.

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.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

FaceDetectorPreset

Beschrijft alle instellingen die moeten worden gebruikt bij het analyseren van een video om alle aanwezige gezichten te detecteren (en eventueel te redigeren).

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.

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.

H264RateControlMode

De modus voor het regelen van videofrequenties

H264Video

Hierin worden alle eigenschappen beschreven voor het coderen van een video met de H.264-codec.

H264VideoProfile

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.

H265VideoProfile

Momenteel wordt Main ondersteund. De standaardwaarde is Automatisch.

Image

Beschrijft de basiseigenschappen voor het genereren van miniaturen op basis van de invoervideo

ImageFormat

Beschrijft de eigenschappen voor een uitvoerafbeeldingsbestand.

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.

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.

JpgFormat

Beschrijft de instellingen voor het produceren van JPEG-miniaturen.

JpgImage

Beschrijft de eigenschappen voor het produceren van een reeks JPEG-afbeeldingen op basis van de invoervideo.

JpgLayer

Beschrijft de instellingen voor het produceren van een JPEG-afbeelding op basis van de invoervideo.

Mp4Format

Beschrijft de eigenschappen voor een ISO MP4-uitvoerbestand.

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.

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

OutputFile

Vertegenwoordigt een geproduceerd uitvoerbestand.

PngFormat

Hierin worden de instellingen beschreven voor het produceren van PNG-miniaturen.

PngImage

Beschrijft de eigenschappen voor het produceren van een reeks PNG-afbeeldingen op basis van de invoervideo.

PngLayer

Beschrijft de instellingen voor het produceren van een PNG-afbeelding op basis van de invoervideo.

PresetConfigurations

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

StandardEncoderPreset

Hierin worden alle instellingen beschreven die moeten worden gebruikt bij het coderen van de invoervideo met de Standard Encoder.

StretchMode

De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize

systemData

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.

TransformOutput

Beschrijft de eigenschappen van een TransformOutput. Dit zijn de regels die moeten worden toegepast tijdens het genereren van de gewenste uitvoer.

TransportStreamFormat

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.

VideoAnalyzerPreset

Een vooraf ingestelde videoanalyse die inzichten (uitgebreide metagegevens) uit zowel audio als video haalt en een bestand in JSON-indeling uitvoert.

VideoOverlay

Beschrijft de eigenschappen van een video-overlay.

VideoSyncMode

De videosynchronisatiemodus

AacAudio

Beschrijft de audiocoderingsinstellingen van Advanced Audio Codec (AAC).

Name Type Description
@odata.type string:

#Microsoft.Media.AacAudio

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

AacAudioProfile

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

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

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

AudioAnalysisMode

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

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

De discriminator voor afgeleide typen.

configurations

PresetConfigurations

Optionele configuratie-instellingen voor encoder. Configuraties wordt alleen ondersteund voor ContentAwareEncoding en H265ContentAwareEncoding BuiltInStandardEncoderPreset.

presetName

EncoderNamedPreset

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

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

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

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

DeinterlaceMode

De deinterlacingmodus. De standaardwaarde is AutoPixelAdaptive.

parity

DeinterlaceParity

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

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

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

De discriminator voor afgeleide typen.

blurType

BlurType

Type vervagen

experimentalOptions

object

Woordenlijst met sleutelwaardeparen voor parameters die niet beschikbaar zijn in de voorinstelling zelf

mode

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.

resolution

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.

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

Rectangle

De parameters voor het rechthoekige venster waarmee de invoervideo moet worden bijgesneden.

deinterlace

Deinterlace

De instellingen voor het verwijderen van interliniëring.

fadeIn

Fade

Beschrijft de eigenschappen van een effect Vervagen dat wordt toegepast op de invoermedia.

fadeOut

Fade

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

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

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

H264VideoProfile

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

De discriminator voor afgeleide typen.

complexity

H264Complexity

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

H264Layer[]

De verzameling H.264-uitvoerlagen die moeten worden geproduceerd door de encoder.

rateControlMode

H264RateControlMode

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

StretchMode

De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize

syncMode

VideoSyncMode

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

H265VideoProfile

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

De discriminator voor afgeleide typen.

complexity

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.

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

H265Layer[]

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

StretchMode

De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize

syncMode

VideoSyncMode

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

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

StretchMode

De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize

syncMode

VideoSyncMode

De videosynchronisatiemodus

ImageFormat

Beschrijft de eigenschappen voor een uitvoerafbeeldingsbestand.

Name Type Description
@odata.type string:

#Microsoft.Media.ImageFormat

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

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

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

JpgLayer[]

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

StretchMode

De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize

syncMode

VideoSyncMode

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

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

OutputFile[]

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

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

OutputFile[]

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

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

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

PngLayer[]

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

StretchMode

De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize

syncMode

VideoSyncMode

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

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

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

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

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

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

createdByType

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

TransformOutput[]

Een matrix van een of meer TransformOutputs die door de transformatie moeten worden gegenereerd.

systemData

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

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

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

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.

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

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

OutputFile[]

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

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

StretchMode

De formaatmodus: hoe de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize

syncMode

VideoSyncMode

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

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

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.

mode

AudioAnalysisMode

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

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

Rectangle

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

Rectangle

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