Jobs - Create

Taak maken
Hiermee maakt u een taak.

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

URI-parameters

Name In Vereist Type Description
accountName
path True

string

De naam van het Media Services-account.

jobName
path True

string

De taaknaam.

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.input True JobInput:

De invoer voor de taak.

properties.outputs True JobOutput[]:

JobOutputAsset[]

De uitvoer voor de taak.

properties.correlationData

object

De klant heeft sleutel, waardeparen opgegeven die worden geretourneerd in de statusgebeurtenissen Job en JobOutput.

properties.description

string

Optioneel heeft de klant een beschrijving van de taak opgegeven.

properties.priority

Priority

Prioriteit waarmee de taak moet worden verwerkt. Taken met een hogere prioriteit worden verwerkt vóór taken met een lagere prioriteit. Als dit niet is ingesteld, is de standaardwaarde normaal.

Antwoorden

Name Type Description
201 Created

Job

Gemaakt

Other Status Codes

ErrorResponse

Gedetailleerde foutinformatie.

Voorbeelden

Create a Job

Sample Request

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

{
  "properties": {
    "input": {
      "@odata.type": "#Microsoft.Media.JobInputAsset",
      "assetName": "job1-InputAsset"
    },
    "outputs": [
      {
        "@odata.type": "#Microsoft.Media.JobOutputAsset",
        "assetName": "job1-OutputAsset"
      }
    ],
    "correlationData": {
      "key1": "value1",
      "Key 2": "Value 2"
    }
  }
}

Sample Response

{
  "name": "job1",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/exampleTransform/jobs/job1",
  "type": "Microsoft.Media/mediaservices/transforms/jobs",
  "properties": {
    "created": "2022-10-17T23:14:33.6140749Z",
    "state": "Queued",
    "input": {
      "@odata.type": "#Microsoft.Media.JobInputAsset",
      "files": [],
      "inputDefinitions": [],
      "assetName": "job1-InputAsset"
    },
    "lastModified": "2022-10-17T23:14:33.6140749Z",
    "outputs": [
      {
        "@odata.type": "#Microsoft.Media.JobOutputAsset",
        "state": "Queued",
        "progress": 0,
        "label": "BuiltInStandardEncoderPreset_0",
        "assetName": "job1-OutputAsset"
      }
    ],
    "priority": "Normal",
    "correlationData": {
      "key1": "value1",
      "Key 2": "Value 2"
    }
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:33.6140749Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:33.6140749Z"
  }
}

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.

AbsoluteClipTime

Hiermee geeft u de cliptijd op als een absolute tijdpositie in het mediabestand. De absolute tijd kan naar een andere positie wijzen, afhankelijk van of het mediabestand begint met een tijdstempel van nul of niet.

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.

AttributeFilter

Het type AttributeFilter dat moet worden toegepast op de TrackAttribute om de sporen te selecteren.

Audio

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

AudioTrackDescriptor

Een TrackSelection om audiosporen te selecteren.

BlurType

Type vervagen

BuiltInStandardEncoderPreset

Beschrijft een ingebouwde voorinstelling voor het coderen van de invoervideo met de Standard Encoder.

ChannelMapping

Optionele aanduiding voor audionummers met één kanaal. Kan worden gebruikt om de nummers te combineren in stereo- of meerkanaals audiosporen.

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 codec-vlag, waarmee de encoder de bitstream van de invoeraudio moet kopiëren.

CopyVideo

Een codec-vlag, 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); Frequentie van audiosampling bij: 32K/44,1K/48K Hz; Audiobitrate-waarden 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 deinterlacing-modus. De standaardinstelling is AutoPixelAdaptive.

DeinterlaceParity

De veldpariteit voor het de-interliniëren 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

Hierin worden alle instellingen beschreven 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 effect Vervagen dat wordt toegepast op de invoermedia.

Filters

Hierin worden alle filterbewerkingen beschreven, zoals de interlacing, rotatie, enzovoort die moeten worden toegepast op de invoermedia voordat ze worden gecodeerd.

FromAllInputFile

Een InputDefinition die alle bestanden bekijkt die zijn opgegeven voor het selecteren van nummers die zijn opgegeven door de eigenschap IncludedTracks. Over het algemeen gebruikt met AudioTrackByAttribute en VideoTrackByAttribute om selectie van één nummer in een set invoerbestanden mogelijk te maken.

FromEachInputFile

Een InputDefinition die elk invoerbestand bekijkt dat wordt geleverd om nummers te selecteren die zijn opgegeven door de eigenschap IncludedTracks. Over het algemeen gebruikt met de AudioTrackByAttribute en VideoTrackByAttribute om nummers uit elk gegeven bestand te selecteren.

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 videofrequentieregelingsmodus

H264Video

Beschrijft alle eigenschappen 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 bitratelaag voor uitvoer 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.

InputFile

Een InputDefinition voor één bestand. TrackSelections zijn gericht op het opgegeven bestand.

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.

Job

Een taakresourcetype. De voortgang en status kunnen worden verkregen door een taak te peilen of u te abonneren op gebeurtenissen met behulp van EventGrid.

JobError

Details van JobOutput-fouten.

JobErrorCategory

Helpt bij het categoriseren van fouten.

JobErrorCode

Foutcode waarin de fout wordt beschreven.

JobErrorDetail

Details van JobOutput-fouten.

JobInputAsset

Vertegenwoordigt een asset voor invoer in een taak.

JobInputClip

Vertegenwoordigt invoerbestanden voor een taak.

JobInputHttp

Vertegenwoordigt HTTPS-taakinvoer.

JobInputs

Beschrijft een lijst met invoergegevens voor een taak.

JobInputSequence

Een reeks bevat een geordende lijst met clips waarbij elke clip een JobInput is. De volgorde wordt behandeld als één invoer.

JobOutputAsset

Vertegenwoordigt een asset die wordt gebruikt als een JobOutput.

JobRetry

Geeft aan dat het mogelijk is om de taak opnieuw uit te voeren. Als het opnieuw proberen mislukt, neemt u contact op met ondersteuning voor Azure via Azure Portal.

JobState

Beschrijft de status van de JobOutput.

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's wordt gesmuild. De exacte uitvoerbestanden die worden geproduceerd, kunnen worden beheerd door de verzameling outputFiles op te geven.

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 in. Hiermee stelt u de prioriteit in die de service gebruikt voor het verwerken van TransformOutputs. De standaardprioriteit is Normaal.

Rectangle

Beschrijft de eigenschappen van een rechthoekig venster dat wordt toegepast op de invoermedia voordat het wordt verwerkt.

Rotation

De draaiing, indien aanwezig, die moet worden toegepast op de invoervideo, voordat deze wordt gecodeerd. De standaardwaarde is Automatisch

SelectAudioTrackByAttribute

Selecteer audiosporen uit de invoer door een kenmerk en een kenmerkfilter op te geven.

SelectAudioTrackById

Selecteer audiosporen uit de invoer door een nummer-id op te geven.

SelectVideoTrackByAttribute

Selecteer videosporen uit de invoer door een kenmerk en een kenmerkfilter op te geven.

SelectVideoTrackById

Selecteer videosporen uit de invoer door een track-id op te geven.

StandardEncoderPreset

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

StretchMode

De formaatmodus: hoe het formaat van 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.

TrackAttribute

De TrackAttribute om de nummers op te filteren.

TransportStreamFormat

Beschrijft de eigenschappen voor het genereren van een MPEG-2 Transport Stream(ISO/IEC 13818-1) uitvoervideobestand(en).

UtcClipTime

Hiermee geeft u de cliptijd op als utc-tijdpositie in het mediabestand. De UTC-tijd kan naar een andere positie wijzen, afhankelijk van of het mediabestand begint met een tijdstempel van nul of niet.

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

VideoTrackDescriptor

Een TrackSelection om videosporen te selecteren.

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 bitrate, in bits per seconde, van de gecodeerde uitvoeraudio.

channels

integer

Het aantal kanalen in de audio.

label

string

Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te beheren.

profile

AacAudioProfile

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

samplingRate

integer

De steekproeffrequentie 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.

AbsoluteClipTime

Hiermee geeft u de cliptijd op als een absolute tijdpositie in het mediabestand. De absolute tijd kan naar een andere positie wijzen, afhankelijk van of het mediabestand begint met een tijdstempel van nul of niet.

Name Type Description
@odata.type string:

#Microsoft.Media.AbsoluteClipTime

De discriminator voor afgeleide typen.

time

string

De tijdpositie op de tijdlijn van de invoermedia. Dit wordt meestal opgegeven als een ISO8601 periode. bijvoorbeeld PT30S gedurende 30 seconden.

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

AttributeFilter

Het type AttributeFilter dat moet worden toegepast op de TrackAttribute om de sporen te selecteren.

Name Type Description
All

string

Alle nummers worden opgenomen.

Bottom

string

Het eerste spoor wordt opgenomen wanneer het kenmerk in oplopende volgorde wordt gesorteerd. Over het algemeen gebruikt om de kleinste bitrate te selecteren.

Top

string

Het eerste spoor wordt opgenomen wanneer het kenmerk in aflopende volgorde wordt gesorteerd. Over het algemeen gebruikt om de grootste bitrate te selecteren.

ValueEquals

string

Alle sporen die een kenmerk hebben dat gelijk is aan de opgegeven waarde, worden opgenomen.

Audio

Definieert de algemene eigenschappen voor alle audiocodecs.

Name Type Description
@odata.type string:

#Microsoft.Media.Audio

De discriminator voor afgeleide typen.

bitrate

integer

De bitrate, in bits per seconde, van de gecodeerde uitvoeraudio.

channels

integer

Het aantal kanalen in de audio.

label

string

Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te beheren.

samplingRate

integer

De steekproeffrequentie 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 ISO 8601-indeling 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 langer is dan de duur van de invoervideo, anders gaat de overlay net zo lang mee als de duur van de overlaymedia.

fadeInDuration

string

De duur waarover de overlay vervaagt in de invoervideo. De waarde moet de iso 8601-duurindeling hebben. Als dit niet is opgegeven, is het standaardgedrag geen infade (hetzelfde als PT0S).

fadeOutDuration

string

De duur waarin de overlay uit de invoervideo vervaagt. De waarde moet de iso 8601-duurindeling 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 ISO 8601-indeling 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.

AudioTrackDescriptor

Een TrackSelection om audiosporen te selecteren.

Name Type Description
@odata.type string:

#Microsoft.Media.AudioTrackDescriptor

De discriminator voor afgeleide typen.

channelMapping

ChannelMapping

Optionele aanduiding voor audionummers met één kanaal. Kan worden gebruikt om de nummers te combineren in stereo- of meerkanaals audiosporen.

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.

ChannelMapping

Optionele aanduiding voor audionummers met één kanaal. Kan worden gebruikt om de nummers te combineren in stereo- of meerkanaals audiosporen.

Name Type Description
BackLeft

string

Het kanaal linksachter. Soms ook wel het linker surroundkanaal genoemd.

BackRight

string

Het kanaal rechtsachter. Ook wel het rechter surroundkanaal genoemd.

Center

string

Het middelste kanaal.

FrontLeft

string

Het kanaal linksvoor.

FrontRight

string

Het kanaal rechtsvoor.

LowFrequencyEffects

string

Laagfrequente effectenkanaal. Ook wel de subwoofer genoemd.

StereoLeft

string

Het linker stereokanaal. Soms aangeduid als Down Mix Left.

StereoRight

string

Het rechter stereokanaal. Ook wel Down Mix Right genoemd.

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 codec-vlag, 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 beheren.

CopyVideo

Een codec-vlag, 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 beheren.

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); Frequentie van audiosampling bij: 32K/44,1K/48K Hz; Audiobitrate-waarden 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 bitrate, in bits per seconde, van de gecodeerde uitvoeraudio.

channels

integer

Het aantal kanalen in de audio.

label

string

Een optioneel label voor de codec. Het label kan worden gebruikt om muxinggedrag te beheren.

samplingRate

integer

De steekproeffrequentie 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 deinterlacing-modus. De standaardinstelling 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 de-interliniëren 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 met een waarde van 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 GOP-uitgelijnde 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 bitrate en resolutie-instellingen te bepalen voor levering door adaptieve streaming. De onderliggende algoritmen blijven zich in de loop van de tijd 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 audiobestanden. Deze voorinstelling kan worden gebruikt voor het knippen van een bestaande asset of het converteren van een groep met op GOP's afgestemde MP4-bestanden (Key Frame) als een asset die kan worden gestreamd.

DDGoodQualityAudio

string

Produceert één MP4-bestand met alleen DD(Digital Dolby) stereoaudio gecodeerd met 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 oplossing 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. Genereert automatisch een bitrate ladder 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 GOP-uitgelijnde 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 van 3500 kbps en een afbeeldingshoogte van 1080 pixels, en de stereoaudio is gecodeerd met AAC-LC-codec van 128 kbps.

H265SingleBitrate4K

string

Produceert een MP4-bestand waarbij de video is gecodeerd met H.265-codec van 9500 kbps en een afbeeldingshoogte van 2160 pixels, en de stereoaudio is gecodeerd met AAC-LC-codec van 128 kbps.

H265SingleBitrate720p

string

Produceert een MP4-bestand waarbij de video is gecodeerd met H.265-codec van 1800 kbps en een afbeeldingshoogte van 720 pixels, en de stereoaudio is gecodeerd met AAC-LC-codec van 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[]

Aanvullende informatie over de fout.

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

Hierin worden alle instellingen beschreven 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 bij analyse de oorspronkelijke resolutie behoudt. Als u 'StandardDefinition' gebruikt, wordt het formaat 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 vóór verwerking geschaald naar 640x360. Als u overschakelt naar StandardDefinition, wordt de tijd die nodig is om video met hoge resolutie te verwerken verkorten. 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 effect Vervagen 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 het in-/uitfaden. 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 van waaruit moet worden gestart, vervaagt. De waarde kan de ISO 8601-indeling 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 stroom (bijvoorbeeld 10% om te beginnen bij 10% van de duur van de stream). De standaardwaarde is 0

Filters

Hierin worden alle filterbewerkingen beschreven, zoals de interlacing, rotatie, enzovoort die moeten worden toegepast op de invoermedia voordat ze worden gecodeerd.

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 de interlacing.

fadeIn

Fade

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

fadeOut

Fade

Beschrijft de eigenschappen van een fade-effect 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

FromAllInputFile

Een InputDefinition die alle bestanden bekijkt die zijn opgegeven voor het selecteren van nummers die zijn opgegeven door de eigenschap IncludedTracks. Over het algemeen gebruikt met AudioTrackByAttribute en VideoTrackByAttribute om selectie van één nummer in een set invoerbestanden mogelijk te maken.

Name Type Description
@odata.type string:

#Microsoft.Media.FromAllInputFile

De discriminator voor afgeleide typen.

includedTracks TrackDescriptor[]:

De lijst met TrackDescriptors waarmee de metagegevens en selectie van sporen in de invoer worden gedefinieerd.

FromEachInputFile

Een InputDefinition die elk invoerbestand bekijkt dat wordt geleverd om nummers te selecteren die zijn opgegeven door de eigenschap IncludedTracks. Over het algemeen gebruikt met de AudioTrackByAttribute en VideoTrackByAttribute om nummers uit elk gegeven bestand te selecteren.

Name Type Description
@odata.type string:

#Microsoft.Media.FromEachInputFile

De discriminator voor afgeleide typen.

includedTracks TrackDescriptor[]:

De lijst met TrackDescriptors waarmee de metagegevens en selectie van sporen in de invoer worden gedefinieerd.

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, schakelt de encoder deze in wanneer het videoprofiel het gebruik ervan 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 bitrate 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 ISO 8601-indeling 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 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.

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, waardoor de encoder het niveau kan kiezen dat geschikt is voor deze laag.

maxBitrate

integer

De maximale bitrate (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, Main, High, High422, High444. De standaardwaarde is Automatisch.

referenceFrames

integer

Het aantal referentieframes dat moet worden gebruikt bij het coderen van deze laag. Als dit niet wordt opgegeven, bepaalt de encoder een geschikt getal op basis van de instelling voor de coderingscomplexiteit.

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 is als de invoer.

H264RateControlMode

De videofrequentieregelingsmodus

Name Type Description
ABR

string

ABR-modus (Average Bitrate) die de doel-bitrate bereikt: Standaardmodus.

CBR

string

De modus Constant Bitrate (CBR) waarmee bitratevariaties rond de doelbitsnelheid worden verscherpt.

CRF

string

Crf-modus (Constant Rate Factor) die gericht is op constante subjectieve kwaliteit.

H264Video

Beschrijft alle eigenschappen 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 beheren.

layers

H264Layer[]

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

rateControlMode

H264RateControlMode

De videofrequentieregelingsmodus

sceneChangeDetection

boolean

Of de encoder sleutelframes bij scènewijzigingen moet invoegen. Als dit niet is opgegeven, is de standaardwaarde false. Deze vlag moet alleen worden ingesteld op true wanneer de encoder wordt geconfigureerd voor het produceren van één uitvoervideo.

stretchMode

StretchMode

De formaatmodus: hoe het formaat van 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 bitratelaag voor uitvoer 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, schakelt de encoder deze in wanneer het videoprofiel het gebruik ervan 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 bitrate 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 3000000 moet zijn. Dit is een verplicht veld.

bufferWindow

string

De lengte van het VBV-buffervenster. De waarde moet de ISO 8601-indeling 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 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.

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, waardoor de encoder het niveau kan kiezen dat geschikt is voor deze laag.

maxBitrate

integer

De maximale bitrate (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 wordt opgegeven, bepaalt de encoder een geschikt getal op basis van de instelling voor de coderingscomplexiteit.

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 is 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 beheren.

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 wijzigingen in de scène. Als dit niet is opgegeven, is de standaardwaarde false. Deze vlag moet alleen worden ingesteld op true wanneer de encoder wordt geconfigureerd voor het produceren van één uitvoervideo.

stretchMode

StretchMode

De formaatmodus: hoe het formaat van 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 beheren.

range

string

De positie ten opzichte van de vooraf ingestelde begintijd van de transformatie in de invoervideo waarop het genereren van miniaturen moet worden gestopt. De waarde kan de 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 stream (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 ISO 8601-indeling 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 stroom (bijvoorbeeld 10% om te beginnen bij 10% van de duur van de stream). Ondersteunt ook een macro {Best}, waarmee de encoder de beste miniatuur van de eerste paar seconden van de video moet selecteren 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 elke 30 frames) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% voor één afbeelding elke 10% van de stroomduur). Opmerking: de stapwaarde is van invloed op de eerste gegenereerde miniatuur, die mogelijk niet precies de miniatuur is die is opgegeven bij de voorinstelling begintijd van de transformatie. Dit komt door de encoder, die de beste miniatuur probeert te selecteren tussen de begintijd en de stappositie van 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. Selecteer een redelijke waarde 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 bij het begintijd.

stretchMode

StretchMode

De formaatmodus: hoe het formaat van 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 achtervoegsel van het bestand 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 (beginnend bij 1). {Bitrate} - De audio-/video-bitsnelheid in kbps. Niet van toepassing op miniaturen. {Codec} - Het type van de audio-/videocodec. {Resolution} - De videoresolutie. Alle macro's zonder substitutie worden samengevouwen en uit de bestandsnaam verwijderd.

InputFile

Een InputDefinition voor één bestand. TrackSelections zijn gericht op het opgegeven bestand.

Name Type Description
@odata.type string:

#Microsoft.Media.InputFile

De discriminator voor afgeleide typen.

filename

string

Naam van het bestand waarop deze invoerdefinitie van toepassing is.

includedTracks TrackDescriptor[]:

De lijst met TrackDescriptors waarmee de metagegevens en selectie van sporen in de invoer worden gedefinieerd.

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.

Job

Een taakresourcetype. De voortgang en status kunnen worden verkregen door een taak te peilen of u te abonneren op gebeurtenissen met behulp van EventGrid.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

De naam van de resource

properties.correlationData

object

De klant heeft sleutel, waardeparen opgegeven die worden geretourneerd in de statusgebeurtenissen Job en JobOutput.

properties.created

string

De UTC-datum en -tijd waarop de klant de taak heeft gemaakt, in de indeling 'JJJJ-MM-DDThh:mm:ssZ'.

properties.description

string

Optioneel heeft de klant een beschrijving van de taak opgegeven.

properties.endTime

string

De UTC-datum en -tijd waarop de verwerking van deze taak is voltooid.

properties.input JobInput:

De invoer voor de taak.

properties.lastModified

string

De UTC-datum en -tijd waarop de klant de taak voor het laatst heeft bijgewerkt, in de indeling 'JJJJ-MM-DDThh:mm:ssZ'.

properties.outputs JobOutput[]:

JobOutputAsset[]

De uitvoer voor de taak.

properties.priority

Priority

Prioriteit waarmee de taak moet worden verwerkt. Taken met een hogere prioriteit worden verwerkt vóór taken met een lagere prioriteit. Als dit niet is ingesteld, is de standaardwaarde normaal.

properties.startTime

string

De UTC-datum en -tijd waarop de verwerking van deze taak is begonnen.

properties.state

JobState

De huidige status van de taak.

systemData

systemData

De systeemmetagegevens met betrekking tot deze resource.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

JobError

Details van JobOutput-fouten.

Name Type Description
category

JobErrorCategory

Helpt bij het categoriseren van fouten.

code

JobErrorCode

Foutcode waarin de fout wordt beschreven.

details

JobErrorDetail[]

Een matrix met details over specifieke fouten die tot deze gerapporteerde fout hebben geleid.

message

string

Een door mensen leesbare taalafhankelijke weergave van de fout.

retry

JobRetry

Geeft aan dat het mogelijk is om de taak opnieuw uit te voeren. Als het opnieuw proberen mislukt, neemt u contact op met ondersteuning voor Azure via Azure Portal.

JobErrorCategory

Helpt bij het categoriseren van fouten.

Name Type Description
Account

string

De fout heeft betrekking op accountgegevens.

Configuration

string

De fout heeft betrekking op de configuratie.

Content

string

De fout is gerelateerd aan gegevens in de invoerbestanden.

Download

string

De fout is gerelateerd aan downloaden.

Service

string

De fout is gerelateerd aan de service.

Upload

string

De fout is gerelateerd aan uploaden.

JobErrorCode

Foutcode waarin de fout wordt beschreven.

Name Type Description
ConfigurationUnsupported

string

Er is een probleem opgetreden met de combinatie van invoerbestanden en de toegepaste configuratie-instellingen, het herstellen van de configuratie-instellingen en het opnieuw proberen met dezelfde invoer of het wijzigen van de invoer zodat deze overeenkomt met de configuratie.

ContentMalformed

string

Er is een probleem opgetreden met de invoerinhoud (bijvoorbeeld: nul bytebestanden of beschadigde/niet-decoderbare bestanden), controleer de invoerbestanden.

ContentUnsupported

string

Er is een probleem opgetreden met de indeling van de invoer (geen geldig mediabestand of een niet-ondersteund bestand/codec), controleer de geldigheid van de invoerbestanden.

DownloadNotAccessible

string

Tijdens het downloaden van de invoerbestanden waren de bestanden niet toegankelijk. Controleer de beschikbaarheid van de bron.

DownloadTransientError

string

Tijdens het downloaden van de invoerbestanden is er een probleem opgetreden tijdens de overdracht (opslagservice, netwerkfouten), bekijk de details en controleer de bron.

IdentityUnsupported

string

Er is een fout opgetreden bij het verifiëren van de accountidentiteit. Controleer en herstel de identiteitsconfiguraties en probeer het opnieuw. Als dit niet lukt, neemt u contact op met de ondersteuning.

ServiceError

string

Onherstelbare servicefout. Neem contact op met de ondersteuning.

ServiceTransientError

string

Tijdelijke fout. Probeer het opnieuw. Als het opnieuw proberen mislukt, neemt u contact op met de ondersteuning.

UploadNotAccessible

string

Tijdens het uploaden van de uitvoerbestanden was de bestemming niet bereikbaar. Controleer de beschikbaarheid van de bestemming.

UploadTransientError

string

Tijdens het uploaden van de uitvoerbestanden is er een probleem opgetreden tijdens de overdracht (opslagservice, netwerkfouten), bekijk de details en controleer uw bestemming.

JobErrorDetail

Details van JobOutput-fouten.

Name Type Description
code

string

Code die de foutdetails beschrijft.

message

string

Een door mensen leesbare weergave van de fout.

JobInputAsset

Vertegenwoordigt een asset voor invoer in een taak.

Name Type Description
@odata.type string:

#Microsoft.Media.JobInputAsset

De discriminator voor afgeleide typen.

assetName

string

De naam van de invoerasset.

end ClipTime:

Hiermee definieert u een punt op de tijdlijn van de invoermedia waarop de verwerking wordt beëindigd. Wordt standaard ingesteld op het einde van het invoermedium.

files

string[]

Lijst met bestanden. Vereist voor JobInputHttp. Maximaal 4000 tekens per stuk. Queryreeksen worden niet geretourneerd in servicereacties om blootstelling van gevoelige gegevens te voorkomen.

inputDefinitions InputDefinition[]:

Hiermee definieert u een lijst met InputDefinitions. Voor elke InputDefinition definieert het een lijst met trackselecties en gerelateerde metagegevens.

label

string

Een label dat is toegewezen aan een JobInputClip, dat wordt gebruikt om te voldoen aan een verwijzing die wordt gebruikt in de transformatie. Een transformatie kan bijvoorbeeld worden gemaakt om een afbeeldingsbestand met het label 'xyz' te maken en dit als een overlay toe te passen op de invoervideo voordat het wordt gecodeerd. Wanneer u een taak verzendt, moet precies een van de JobInputs het afbeeldingsbestand zijn en het label 'xyz' hebben.

start ClipTime:

Hiermee definieert u een punt op de tijdlijn van de invoermedia waarop de verwerking wordt gestart. Standaard ingesteld op het begin van het invoermedium.

JobInputClip

Vertegenwoordigt invoerbestanden voor een taak.

Name Type Description
@odata.type string:

#Microsoft.Media.JobInputClip

De discriminator voor afgeleide typen.

end ClipTime:

Hiermee definieert u een punt op de tijdlijn van de invoermedia waarop de verwerking wordt beëindigd. Wordt standaard ingesteld op het einde van het invoermedium.

files

string[]

Lijst met bestanden. Vereist voor JobInputHttp. Maximaal 4000 tekens per stuk. Queryreeksen worden niet geretourneerd in servicereacties om blootstelling van gevoelige gegevens te voorkomen.

inputDefinitions InputDefinition[]:

Hiermee definieert u een lijst met InputDefinitions. Voor elke InputDefinition definieert het een lijst met trackselecties en gerelateerde metagegevens.

label

string

Een label dat is toegewezen aan een JobInputClip, dat wordt gebruikt om te voldoen aan een verwijzing die wordt gebruikt in de transformatie. Een transformatie kan bijvoorbeeld worden gemaakt om een afbeeldingsbestand met het label 'xyz' te maken en dit als een overlay toe te passen op de invoervideo voordat het wordt gecodeerd. Wanneer u een taak verzendt, moet precies een van de JobInputs het afbeeldingsbestand zijn en het label 'xyz' hebben.

start ClipTime:

Hiermee definieert u een punt op de tijdlijn van de invoermedia waarop de verwerking wordt gestart. Standaard ingesteld op het begin van het invoermedium.

JobInputHttp

Vertegenwoordigt HTTPS-taakinvoer.

Name Type Description
@odata.type string:

#Microsoft.Media.JobInputHttp

De discriminator voor afgeleide typen.

baseUri

string

Basis-URI voor HTTPS-taakinvoer. Deze wordt samengevoegd met de opgegeven bestandsnamen. Als er geen basis-URI wordt opgegeven, wordt ervan uitgegaan dat de opgegeven bestandslijst volledig gekwalificeerde uris is. Maximale lengte van 4000 tekens. De queryreeksen worden niet geretourneerd in servicereacties om blootstelling van gevoelige gegevens te voorkomen.

end ClipTime:

Hiermee definieert u een punt op de tijdlijn van de invoermedia waarop de verwerking wordt beëindigd. Wordt standaard ingesteld op het einde van het invoermedium.

files

string[]

Lijst met bestanden. Vereist voor JobInputHttp. Maximaal 4000 tekens per stuk. Queryreeksen worden niet geretourneerd in servicereacties om blootstelling van gevoelige gegevens te voorkomen.

inputDefinitions InputDefinition[]:

Hiermee definieert u een lijst met InputDefinitions. Voor elke InputDefinition definieert het een lijst met trackselecties en gerelateerde metagegevens.

label

string

Een label dat is toegewezen aan een JobInputClip, dat wordt gebruikt om te voldoen aan een verwijzing die wordt gebruikt in de transformatie. Een transformatie kan bijvoorbeeld worden gemaakt om een afbeeldingsbestand met het label 'xyz' te maken en dit als een overlay toe te passen op de invoervideo voordat het wordt gecodeerd. Wanneer u een taak verzendt, moet precies een van de JobInputs het afbeeldingsbestand zijn en het label 'xyz' hebben.

start ClipTime:

Hiermee definieert u een punt op de tijdlijn van de invoermedia waarop de verwerking wordt gestart. Standaard ingesteld op het begin van het invoermedium.

JobInputs

Beschrijft een lijst met invoergegevens voor een taak.

Name Type Description
@odata.type string:

#Microsoft.Media.JobInputs

De discriminator voor afgeleide typen.

inputs JobInput[]:

Lijst met invoergegevens voor een taak.

JobInputSequence

Een reeks bevat een geordende lijst met clips waarbij elke clip een JobInput is. De volgorde wordt behandeld als één invoer.

Name Type Description
@odata.type string:

#Microsoft.Media.JobInputSequence

De discriminator voor afgeleide typen.

inputs JobInputClip[]:

JobInputs waaruit de tijdlijn bestaat.

JobOutputAsset

Vertegenwoordigt een asset die wordt gebruikt als een JobOutput.

Name Type Description
@odata.type string:

#Microsoft.Media.JobOutputAsset

De discriminator voor afgeleide typen.

assetName

string

De naam van de uitvoerasset.

endTime

string

De UTC-datum en -tijd waarop de verwerking van deze taakuitvoer is voltooid.

error

JobError

Als de JobOutput de status Fout heeft, bevat deze de details van de fout.

label

string

Een label dat is toegewezen aan een JobOutput om het op unieke wijze te identificeren. Dit is handig wanneer uw Transformatie meer dan één TransformOutput heeft, waarbij uw taak meer dan één JobOutput heeft. In dergelijke gevallen voegt u, wanneer u de taak indient, twee of meer JobOutputs toe, in dezelfde volgorde als TransformOutputs in de Transformatie. Wanneer u vervolgens de taak ophaalt, hetzij via gebeurtenissen of op een GET-aanvraag, kunt u het label gebruiken om de JobOutput eenvoudig te identificeren. Als er geen label wordt opgegeven, wordt de standaardwaarde {presetName}_{outputIndex} gebruikt, waarbij de vooraf ingestelde naam de naam is van de voorinstelling in de bijbehorende TransformOutput en de uitvoerindex de relatieve index is van deze JobOutput binnen de taak. Houd er rekening mee dat deze index hetzelfde is als de relatieve index van de bijbehorende TransformOutput binnen de transformatie.

presetOverride Preset:

Een voorinstelling die wordt gebruikt om de voorinstelling in de bijbehorende transformatie-uitvoer te overschrijven.

progress

integer

Als de JobOutput de status Processing heeft, bevat deze het voltooiingspercentage van de taak. De waarde is een schatting en is niet bedoeld om te worden gebruikt om de voltooiingstijden van de taak te voorspellen. Gebruik de eigenschap State om te bepalen of de JobOutput is voltooid.

startTime

string

De UTC-datum en -tijd waarop de verwerking van deze taakuitvoer is begonnen.

state

JobState

Beschrijft de status van de JobOutput.

JobRetry

Geeft aan dat het mogelijk is om de taak opnieuw uit te voeren. Als het opnieuw proberen mislukt, neemt u contact op met ondersteuning voor Azure via Azure Portal.

Name Type Description
DoNotRetry

string

Probleem moet worden onderzocht en vervolgens wordt de taak opnieuw ingediend met correcties of opnieuw geprobeerd zodra het onderliggende probleem is opgelost.

MayRetry

string

Het probleem kan worden opgelost nadat u een bepaalde tijd hebt gewacht en dezelfde taak opnieuw hebt verzonden.

JobState

Beschrijft de status van de JobOutput.

Name Type Description
Canceled

string

De taak is geannuleerd. Dit is een definitieve status voor de taak.

Canceling

string

De taak wordt momenteel geannuleerd. Dit is een tijdelijke status voor de taak.

Error

string

Er is een fout opgetreden in de taak. Dit is een definitieve status voor de taak.

Finished

string

De taak is voltooid. Dit is een definitieve status voor de taak.

Processing

string

De taak wordt verwerkt. Dit is een tijdelijke status voor de taak.

Queued

string

De taak bevindt zich in de wachtrij en wacht totdat er resources beschikbaar zijn. Dit is een tijdelijke toestand.

Scheduled

string

De taak wordt gepland om te worden uitgevoerd op een beschikbare resource. Dit is een tijdelijke status, tussen de status in de wachtrij en de verwerkingsstatus.

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

layers

JpgLayer[]

Een verzameling JPEG-uitvoerafbeeldingslagen die moeten worden geproduceerd door de encoder.

range

string

De positie ten opzichte van de vooraf ingestelde begintijd van de transformatie in de invoervideo waarop het genereren van miniaturen moet worden gestopt. De waarde kan de 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 stream (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 een sprite-miniatuurafbeelding. 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 resolutie van de uitvoerafbeelding niet verder gaat dan de jpeg-maximale pixelresolutielimiet 65535x65535.

start

string

De positie in de invoervideo van waaruit miniaturen moeten worden gegenereerd. De waarde kan de ISO 8601-indeling 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 stroom (bijvoorbeeld 10% om te beginnen bij 10% van de duur van de stream). Ondersteunt ook een macro {Best}, waarmee de encoder de beste miniatuur van de eerste paar seconden van de video moet selecteren 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 elke 30 frames) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% voor één afbeelding elke 10% van de stroomduur). Opmerking: de stapwaarde is van invloed op de eerste gegenereerde miniatuur, die mogelijk niet precies de miniatuur is die is opgegeven bij de voorinstelling begintijd van de transformatie. Dit komt door de encoder, die de beste miniatuur probeert te selecteren tussen de begintijd en de stappositie van 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. Selecteer een redelijke waarde 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 bij het begintijd.

stretchMode

StretchMode

De formaatmodus: hoe het formaat van 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 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.

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 is 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's wordt gesmuild. 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. Elk item in de lijst is een set audio- en videolaaglabels die moeten worden samengevoegd.

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

layers

PngLayer[]

Een verzameling uitvoer-PNG-afbeeldingslagen die moeten worden geproduceerd door de encoder.

range

string

De positie ten opzichte van de vooraf ingestelde begintijd van de transformatie in de invoervideo waarop het genereren van miniaturen moet worden gestopt. De waarde kan de 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 stream (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 ISO 8601-indeling 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 stroom (bijvoorbeeld 10% om te beginnen bij 10% van de duur van de stream). Ondersteunt ook een macro {Best}, waarmee de encoder de beste miniatuur van de eerste paar seconden van de video moet selecteren 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 elke 30 frames) of een relatieve waarde voor de duur van de stream (bijvoorbeeld 10% voor één afbeelding elke 10% van de stroomduur). Opmerking: de stapwaarde is van invloed op de eerste gegenereerde miniatuur, die mogelijk niet precies de miniatuur is die is opgegeven bij de voorinstelling begintijd van de transformatie. Dit komt door de encoder, die de beste miniatuur probeert te selecteren tussen de begintijd en de stappositie van 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. Selecteer een redelijke waarde 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 bij het begintijd.

stretchMode

StretchMode

De formaatmodus: hoe het formaat van 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 in. Hiermee stelt u de prioriteit in 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 wordt toegepast op de invoermedia 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 rechtsom.

Rotate270

string

Draai 270 graden rechtsom.

Rotate90

string

Draai 90 graden rechtsom.

SelectAudioTrackByAttribute

Selecteer audiosporen uit de invoer door een kenmerk en een kenmerkfilter op te geven.

Name Type Description
@odata.type string:

#Microsoft.Media.SelectAudioTrackByAttribute

De discriminator voor afgeleide typen.

attribute

TrackAttribute

De TrackAttribute om de nummers op te filteren.

channelMapping

ChannelMapping

Optionele aanduiding voor audionummers met één kanaal. Kan worden gebruikt om de nummers te combineren in stereo- of meerkanaals audiosporen.

filter

AttributeFilter

Het type AttributeFilter dat moet worden toegepast op trackattribute om de nummers te selecteren.

filterValue

string

De waarde om de nummers op te filteren. Alleen gebruikt wanneer AttributeFilter.ValueEquals is opgegeven voor de eigenschap Filter.

SelectAudioTrackById

Selecteer audiosporen uit de invoer door een nummer-id op te geven.

Name Type Description
@odata.type string:

#Microsoft.Media.SelectAudioTrackById

De discriminator voor afgeleide typen.

channelMapping

ChannelMapping

Optionele aanduiding voor audionummers met één kanaal. Kan worden gebruikt om de nummers te combineren in stereo- of meerkanaals audiosporen.

trackId

integer

Te selecteren id bijhouden

SelectVideoTrackByAttribute

Selecteer videosporen uit de invoer door een kenmerk en een kenmerkfilter op te geven.

Name Type Description
@odata.type string:

#Microsoft.Media.SelectVideoTrackByAttribute

De discriminator voor afgeleide typen.

attribute

TrackAttribute

De TrackAttribute om de nummers op te filteren.

filter

AttributeFilter

Het type AttributeFilter dat moet worden toegepast op trackattribute om de nummers te selecteren.

filterValue

string

De waarde om de nummers op te filteren. Alleen gebruikt wanneer AttributeFilter.ValueEquals is opgegeven voor de eigenschap Filter. Voor TrackAttribute.Bitrate moet dit een geheel getal in bits per seconde zijn (bijvoorbeeld '1500000'). TrackAttribute.Language wordt niet ondersteund voor videotracks.

SelectVideoTrackById

Selecteer videosporen uit de invoer door een track-id op te geven.

Name Type Description
@odata.type string:

#Microsoft.Media.SelectVideoTrackById

De discriminator voor afgeleide typen.

trackId

integer

Te selecteren id bijhouden

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 het formaat van de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is AutoSize

Name Type Description
AutoFit

string

Plaats de uitvoer (met letterbox of pillar box) om de uitvoerresolutie te respecteren, 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 voorinstelling voor codering vraagt om 1280x1280, is de uitvoer 1280x1280, die een binnenste rechthoek van 1280x720 met een hoogte-breedteverhouding van 16:9 en een kolomvak van 280 pixels breed links en rechts van 280 pixels bevat.

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 voor invoer 16:9 behouden blijft.

None

string

Respecteer de uitvoerresolutie zonder rekening te houden met de pixel-hoogte-breedteverhouding of weergave-hoogte-breedteverhouding van de invoervideo.

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name Type Description
createdAt

string

Het tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string

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

TrackAttribute

De TrackAttribute om de nummers op te filteren.

Name Type Description
Bitrate

string

De bitrate van het spoor.

Language

string

De taal van het nummer.

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.

UtcClipTime

Hiermee geeft u de cliptijd op als utc-tijdpositie in het mediabestand. De UTC-tijd kan naar een andere positie wijzen, afhankelijk van of het mediabestand begint met een tijdstempel van nul of niet.

Name Type Description
@odata.type string:

#Microsoft.Media.UtcClipTime

De discriminator voor afgeleide typen.

time

string

De tijdpositie op de tijdlijn van de invoermedia op basis van utc-tijd.

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

stretchMode

StretchMode

De formaatmodus: hoe het formaat van 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 ISO 8601-indeling 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 langer is dan de duur van de invoervideo, anders gaat de overlay net zo lang mee als de duur van de overlaymedia.

fadeInDuration

string

De duur waarover de overlay vervaagt in de invoervideo. De waarde moet de iso 8601-duurindeling hebben. Als dit niet is opgegeven, is het standaardgedrag geen infade (hetzelfde als PT0S).

fadeOutDuration

string

De duur waarin de overlay uit de invoervideo vervaagt. De waarde moet de iso 8601-duurindeling 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 ondoorzichtigheid 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 ISO 8601-indeling 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 indien 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 heeft 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 voor het berekenen van een metrische kwaliteitswaarde, zoals PSNR, op basis van de invoer

VideoTrackDescriptor

Een TrackSelection om videosporen te selecteren.

Name Type Description
@odata.type string:

#Microsoft.Media.VideoTrackDescriptor

De discriminator voor afgeleide typen.