Jobs - Get

Pobieranie zadania
Pobiera zadanie.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
accountName
path True

string

Nazwa konta usługi Media Services.

jobName
path True

string

Nazwa zadania.

resourceGroupName
path True

string

Nazwa grupy zasobów w ramach subskrypcji platformy Azure.

subscriptionId
path True

string

Unikatowy identyfikator subskrypcji platformy Microsoft Azure.

transformName
path True

string

Nazwa przekształcenia.

api-version
query True

string

Wersja interfejsu API, która ma być używana z żądaniem klienta.

Odpowiedzi

Nazwa Typ Opis
200 OK

Job

OK

Other Status Codes

ErrorResponse

Szczegółowe informacje o błędzie.

Przykłady

Get a Job by name

Sample Request

GET 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

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": "2021-06-01T00:00:00Z",
    "state": "Queued",
    "input": {
      "@odata.type": "#Microsoft.Media.JobInputs",
      "inputs": [
        {
          "@odata.type": "#Microsoft.Media.JobInputAsset",
          "files": [],
          "inputDefinitions": [],
          "assetName": "job1-InputAsset"
        }
      ]
    },
    "lastModified": "2021-06-01T00:00:00Z",
    "outputs": [
      {
        "@odata.type": "#Microsoft.Media.JobOutputAsset",
        "state": "Queued",
        "progress": 0,
        "label": "example-custom-label",
        "assetName": "job1-OutputAsset"
      }
    ],
    "priority": "Low",
    "correlationData": {}
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2021-06-01T00:00:00Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-06-01T00:00:00Z"
  }
}

Definicje

Nazwa Opis
AacAudio

Opisuje ustawienia kodowania audio Advanced Audio Codec (AAC).

AacAudioProfile

Profil kodowania, który ma być używany podczas kodowania dźwięku za pomocą funkcji AAC.

AbsoluteClipTime

Określa czas klipu jako bezwzględną pozycję czasu w pliku multimedialnym. Bezwzględny czas może wskazywać inną pozycję w zależności od tego, czy plik multimedialny rozpoczyna się od znacznika czasu zera, czy nie.

AnalysisResolution

Określa maksymalną rozdzielczość, w której jest analizowane wideo. Domyślnym zachowaniem jest "SourceResolution", który zachowa wejściowy film wideo w oryginalnej rozdzielczości podczas analizowania. Użycie opcji "StandardDefinition" spowoduje zmianę rozmiaru wejściowych filmów wideo na standardową definicję przy zachowaniu odpowiedniego współczynnika proporcji. Zmiana rozmiaru będzie zmieniana tylko wtedy, gdy wideo ma wyższą rozdzielczość. Na przykład dane wejściowe 1920x1080 zostaną przeskalowane do 640x360 przed przetworzeniem. Przełączenie na "StandardDefinition" skróci czas przetwarzania wideo o wysokiej rozdzielczości. Może również zmniejszyć koszt korzystania z tego składnika (zobacz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics szczegółowe informacje). Jednak twarze, które są zbyt małe w zmienionym rozmiarze wideo, mogą nie zostać wykryte.

AttributeFilter

Typ AtrybutFilter, który ma być stosowany do elementu TrackAttribute, aby wybrać ścieżki.

Audio

Definiuje wspólne właściwości wszystkich koderów audio.

AudioAnalysisMode

Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrana opcja Standard AudioAnalysisMode.

AudioAnalyzerPreset

Ustawienie wstępne analizatora audio stosuje wstępnie zdefiniowany zestaw operacji analizy opartych na sztucznej inteligencji, w tym transkrypcję mowy. Obecnie ustawienie wstępne obsługuje przetwarzanie zawartości za pomocą pojedynczej ścieżki audio.

AudioOverlay

Opisuje właściwości nakładki audio.

AudioTrackDescriptor

Element TrackSelection do wybierania utworów audio.

BlurType

Typ rozmycia

BuiltInStandardEncoderPreset

Opisuje wbudowane ustawienie wstępne kodowania wejściowego wideo za pomocą kodera standardowego.

ChannelMapping

Opcjonalne oznaczenie dla utworów audio z jednym kanałem. Można używać do łączenia utworów w utwory stereo lub wielokanałowe audio.

Complexity

Umożliwia skonfigurowanie ustawień kodera w celu kontrolowania równowagi między szybkością a jakością. Przykład: ustaw wartość Złożoność jako Szybkość, aby przyspieszyć kodowanie, ale zmniejszyć wydajność kompresji.

CopyAudio

Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego audio.

CopyVideo

Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego wideo bez ponownego kodowania.

createdByType

Typ tożsamości, która utworzyła zasób.

DDAudio

Opisuje ustawienia kodowania dźwięku dolby Digital Audio Codec (AC3). Bieżąca implementacja obsługi dźwięku cyfrowego dolby to: numery kanałów audio na 1((mono), 2(stereo), 6(5.1side); Częstotliwość próbkowania audio na poziomie: 32K/44,1K/48K Hz; Wartości szybkości transmisji bitów audio jako specyfikacja AC3 obsługują: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 64000 bps.

Deinterlace

Opisuje ustawienia usuwania przeplatania.

DeinterlaceMode

Tryb deinterlacingu. Wartość domyślna to AutoPixelAdaptive.

DeinterlaceParity

Parzystość pól dla de-interlacing, domyślnie jest ustawiona na Auto.

EncoderNamedPreset

Wbudowane ustawienie wstępne, które ma być używane do kodowania filmów wideo.

EntropyMode

Tryb entropii, który ma być używany dla tej warstwy. Jeśli nie zostanie określony, koder wybiera tryb odpowiedni dla profilu i poziomu.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

FaceDetectorPreset

Opisuje wszystkie ustawienia, które mają być używane podczas analizowania wideo w celu wykrycia (i opcjonalnie redagowania) wszystkich obecnych twarzy.

FaceRedactorMode

Ten tryb umożliwia wybór między następującymi ustawieniami: 1) Analizowanie — tylko do wykrywania. Ten tryb generuje metadanych wyglądy plików JSON twarzy w całym filmie wideo. Tam, gdzie to możliwe, do tej samej osoby przypisano ten sam identyfikator. 2) Połączone — dodatkowo wykrywane twarze są redacts (rozmycia). 3) Redact — umożliwia to proces 2-przekazywania, co umożliwia selektywne redagowanie podzestawu wykrytych twarzy. Pobiera on plik metadanych z poprzedniego przebiegu analizy wraz ze źródłowym filmem wideo oraz podzbiorem identyfikatorów wybranych przez użytkownika, które wymagają ponownego przeprowadzenia analizy.

Fade

Opisuje właściwości efektu Zanikania zastosowanego do nośnika wejściowego.

Filters

Opisuje wszystkie operacje filtrowania, takie jak de-interlacing, rotacja itp., które mają być stosowane do nośnika wejściowego przed kodowaniem.

FromAllInputFile

Element InputDefinition, który wyszukuje wszystkie udostępnione pliki w celu wybrania ścieżek określonych przez właściwość IncludedTracks. Ogólnie używany z elementami AudioTrackByAttribute i VideoTrackByAttribute w celu umożliwienia wyboru pojedynczej ścieżki w zestawie plików wejściowych.

FromEachInputFile

Element InputDefinition, który sprawdza każdy plik wejściowy w celu wybrania ścieżek określonych przez właściwość IncludedTracks. Ogólnie używane z audioTrackByAttribute i VideoTrackByAttribute do wybierania ścieżek z każdego pliku podanego.

H264Complexity

Informuje koder, jak wybrać jego ustawienia kodowania. Wartość domyślna to Zrównoważony.

H264Layer

Opisuje ustawienia, które mają być używane podczas kodowania wejściowego wideo do żądanej warstwy szybkości transmisji bitów danych wyjściowych za pomocą kodera wideo H.264.

H264RateControlMode

Tryb sterowania szybkością wideo

H264Video

Opisuje wszystkie właściwości kodowania wideo za pomocą kodera H.264.

H264VideoProfile

Obecnie obsługujemy linię bazową, Main, High, High422, High444. Wartość domyślna to Auto.

H265Complexity

Informuje koder, jak wybrać jego ustawienia kodowania. Jakość zapewni wyższy współczynnik kompresji, ale przy wyższym koszcie i dłuższym czasie obliczeniowym. Szybkość będzie produkować stosunkowo większy plik, ale jest szybszy i bardziej ekonomiczny. Wartość domyślna to Zrównoważony.

H265Layer

Opisuje ustawienia, które mają być używane podczas kodowania wejściowego wideo do żądanej warstwy szybkości transmisji bitów danych wyjściowych za pomocą kodera wideo H.265.

H265Video

Opisuje wszystkie właściwości kodowania wideo za pomocą kodera H.265.

H265VideoProfile

Obecnie obsługujemy główną. Wartość domyślna to Auto.

Image

Opisuje podstawowe właściwości generowania miniatur z wejściowego wideo

ImageFormat

Opisuje właściwości pliku obrazu wyjściowego.

InputFile

Element InputDefinition dla pojedynczego pliku. Zakres śledzenia wyborów jest określony w pliku.

InsightsType

Definiuje typ szczegółowych informacji, które mają zostać wygenerowane przez usługę. Dozwolone wartości to "AudioInsightsOnly", "VideoInsightsOnly" i "AllInsights". Wartość domyślna to AllInsights. Jeśli ustawisz tę wartość na Wartość AllInsights, a dane wejściowe są tylko audio, generowane są tylko szczegółowe informacje audio. Podobnie jeśli dane wejściowe są tylko wideo, generowane są tylko szczegółowe informacje wideo. Zaleca się, aby nie używać elementu AudioInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko wideo; lub użyj usługi VideoInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko audio. Zadania w takich warunkach wymykałyby się.

InterleaveOutput

Ustawia tryb przeplatania danych wyjściowych, aby kontrolować sposób przechowywania dźwięku i wideo w formacie kontenera. Przykład: ustaw wartość InterleavedOutput jako NonInterleavedOutput, aby wygenerować dane wyjściowe tylko audio i wideo w oddzielnych plikach MP4.

Job

Typ zasobu zadania. Postęp i stan można uzyskać, sondując zadanie lub subskrybując zdarzenia przy użyciu usługi EventGrid.

JobError

Szczegóły błędów JobOutput.

JobErrorCategory

Pomaga w kategoryzacji błędów.

JobErrorCode

Kod błędu opisujący błąd.

JobErrorDetail

Szczegóły błędów JobOutput.

JobInputAsset

Reprezentuje zasób dla danych wejściowych w zadaniu.

JobInputClip

Reprezentuje pliki wejściowe zadania.

JobInputHttp

Reprezentuje dane wejściowe zadania HTTPS.

JobInputs

Opisuje listę danych wejściowych zadania.

JobInputSequence

Sekwencja zawiera uporządkowaną listę klipów, w których każdy klip jest obiektem JobInput. Sekwencja będzie traktowana jako pojedyncze dane wejściowe.

JobOutputAsset

Reprezentuje zasób używany jako element JobOutput.

JobRetry

Wskazuje, że można ponowić próbę wykonania zadania. Jeśli ponowna próba nie powiedzie się, skontaktuj się z pomoc techniczna platformy Azure za pośrednictwem witryny Azure Portal.

JobState

Opisuje stan elementu JobOutput.

JpgFormat

Opisuje ustawienia tworzenia miniatur JPEG.

JpgImage

Opisuje właściwości tworzenia serii obrazów JPEG z wejściowego wideo.

JpgLayer

Opisuje ustawienia służące do tworzenia obrazu JPEG z wejściowego wideo.

Mp4Format

Opisuje właściwości wyjściowego pliku ISO MP4.

MultiBitrateFormat

Opisuje właściwości tworzenia kolekcji plików o wielu szybkościach transmisji bitów wyrównywane przez usługę GOP. Domyślnym zachowaniem jest wygenerowanie jednego pliku wyjściowego dla każdej warstwy wideo, która jest muxed razem ze wszystkimi dźwiękami. Dokładne utworzone pliki wyjściowe można kontrolować, określając kolekcję outputFiles.

OutputFile

Reprezentuje utworzony plik wyjściowy.

PngFormat

Opisuje ustawienia tworzenia miniatur PNG.

PngImage

Opisuje właściwości tworzenia serii obrazów PNG z wejściowego wideo.

PngLayer

Opisuje ustawienia służące do tworzenia obrazu PNG z wejściowego wideo.

PresetConfigurations

Obiekt opcjonalnych ustawień konfiguracji kodera.

Priority

Ustawia względny priorytet transformOutputs w ramach przekształcenia. Określa priorytet używany przez usługę do przetwarzania funkcji TransformOutputs. Domyślny priorytet to Normal.

Rectangle

Opisuje właściwości okna prostokątnego zastosowanego do nośnika wejściowego przed jego przetworzeniem.

Rotation

Rotacja, jeśli istnieje, do stosowania do wejściowego wideo, zanim zostanie zakodowana. Wartość domyślna to Auto

SelectAudioTrackByAttribute

Wybierz ścieżki audio z danych wejściowych, określając atrybut i filtr atrybutu.

SelectAudioTrackById

Wybierz ścieżki audio z danych wejściowych, określając identyfikator śledzenia.

SelectVideoTrackByAttribute

Wybierz ścieżki wideo z danych wejściowych, określając atrybut i filtr atrybutu.

SelectVideoTrackById

Wybierz ścieżki wideo z danych wejściowych, określając identyfikator śledzenia.

StandardEncoderPreset

Opisuje wszystkie ustawienia, które mają być używane podczas kodowania wejściowego wideo za pomocą kodera standardowego.

StretchMode

Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

TrackAttribute

Element TrackAttribute do filtrowania ścieżek według.

TransportStreamFormat

Opisuje właściwości generowania strumienia transportowego MPEG-2 (ISO/IEC 13818-1) wyjściowych plików wideo.

UtcClipTime

Określa godzinę klipu jako pozycję czasu UTC w pliku multimedialnym. Czas UTC może wskazywać inną pozycję w zależności od tego, czy plik multimedialny rozpoczyna się od znacznika czasu zera, czy nie.

Video

Opisuje podstawowe właściwości kodowania wejściowego wideo.

VideoAnalyzerPreset

Ustawienie wstępne analizatora wideo, które wyodrębnia szczegółowe informacje (rozbudowane metadane) zarówno z audio, jak i wideo, i generuje plik formatu JSON.

VideoOverlay

Opisuje właściwości nakładki wideo.

VideoSyncMode

Tryb synchronizacji wideo

VideoTrackDescriptor

Element TrackSelection do wybierania ścieżek wideo.

AacAudio

Opisuje ustawienia kodowania audio Advanced Audio Codec (AAC).

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.AacAudio

Dyskryminujący dla typów pochodnych.

bitrate

integer

Szybkość transmisji bitów w bitach na sekundę w danych wyjściowych zakodowanych audio.

channels

integer

Liczba kanałów w dźwięku.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

profile

AacAudioProfile

Profil kodowania, który ma być używany podczas kodowania dźwięku za pomocą usługi AAC.

samplingRate

integer

Częstotliwość próbkowania do użycia do kodowania w hertz.

AacAudioProfile

Profil kodowania, który ma być używany podczas kodowania dźwięku za pomocą funkcji AAC.

Nazwa Typ Opis
AacLc

string

Określa, że dźwięk wyjściowy ma być zakodowany w profilu AAC Low Complexity (AAC-LC).

HeAacV1

string

Określa, że dźwięk wyjściowy ma być zakodowany w profilu HE-AAC w wersji 1.

HeAacV2

string

Określa, że dźwięk wyjściowy ma być zakodowany w profilu HE-AAC v2.

AbsoluteClipTime

Określa czas klipu jako bezwzględną pozycję czasu w pliku multimedialnym. Bezwzględny czas może wskazywać inną pozycję w zależności od tego, czy plik multimedialny rozpoczyna się od znacznika czasu zera, czy nie.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.AbsoluteClipTime

Dyskryminator typów pochodnych.

time

string

Położenie czasu na osi czasu nośnika wejściowego. Zwykle jest on określany jako okres ISO8601. np. PT30S przez 30 sekund.

AnalysisResolution

Określa maksymalną rozdzielczość, w której jest analizowane wideo. Domyślnym zachowaniem jest "SourceResolution", który zachowa wejściowy film wideo w oryginalnej rozdzielczości podczas analizowania. Użycie opcji "StandardDefinition" spowoduje zmianę rozmiaru wejściowych filmów wideo na standardową definicję przy zachowaniu odpowiedniego współczynnika proporcji. Zmiana rozmiaru będzie zmieniana tylko wtedy, gdy wideo ma wyższą rozdzielczość. Na przykład dane wejściowe 1920x1080 zostaną przeskalowane do 640x360 przed przetworzeniem. Przełączenie na "StandardDefinition" skróci czas przetwarzania wideo o wysokiej rozdzielczości. Może również zmniejszyć koszt korzystania z tego składnika (zobacz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics szczegółowe informacje). Jednak twarze, które są zbyt małe w zmienionym rozmiarze wideo, mogą nie zostać wykryte.

Nazwa Typ Opis
SourceResolution

string

StandardDefinition

string

AttributeFilter

Typ AtrybutFilter, który ma być stosowany do elementu TrackAttribute, aby wybrać ścieżki.

Nazwa Typ Opis
All

string

Wszystkie utwory zostaną uwzględnione.

Bottom

string

Pierwszy utwór zostanie uwzględniony po posortowaniu atrybutu w kolejności rosnącej. Zazwyczaj używane do wybierania najmniejszej szybkości transmisji bitów.

Top

string

Pierwsza ścieżka zostanie uwzględniona po posortowaniu atrybutu w kolejności malejącej. Zazwyczaj służy do wybierania największej szybkości transmisji bitów.

ValueEquals

string

Wszystkie ścieżki, które mają atrybut równy podanej wartości, zostaną uwzględnione.

Audio

Definiuje wspólne właściwości wszystkich koderów audio.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.Audio

Dyskryminujący dla typów pochodnych.

bitrate

integer

Szybkość transmisji bitów w bitach na sekundę w danych wyjściowych zakodowanych audio.

channels

integer

Liczba kanałów w dźwięku.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

samplingRate

integer

Częstotliwość próbkowania do użycia do kodowania w hertz.

AudioAnalysisMode

Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrana opcja Standard AudioAnalysisMode.

Nazwa Typ Opis
Basic

string

Ten tryb wykonuje transkrypcję zamiany mowy na tekst i generowanie pliku podtytułu/podpis VTT. Dane wyjściowe tego trybu obejmują plik JSON szczegółowych informacji, w tym tylko słowa kluczowe, transkrypcję i informacje o chronometrażu. Automatyczne wykrywanie języka i diaryzacja osoby mówiącej nie są uwzględniane w tym trybie.

Standard

string

Wykonuje wszystkie operacje zawarte w trybie Podstawowym, dodatkowo wykonując wykrywanie języka i diaryzacja osoby mówiącej.

AudioAnalyzerPreset

Ustawienie wstępne analizatora audio stosuje wstępnie zdefiniowany zestaw operacji analizy opartych na sztucznej inteligencji, w tym transkrypcję mowy. Obecnie ustawienie wstępne obsługuje przetwarzanie zawartości za pomocą pojedynczej ścieżki audio.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.AudioAnalyzerPreset

Dyskryminator typów pochodnych.

audioLanguage

string

Język ładunku audio w danych wejściowych przy użyciu formatu BCP-47 "language tag-region" (np. "en-US"). Jeśli znasz język zawartości, zaleca się jej określenie. Język musi być określony jawnie dla AudioAnalysisMode::Basic, ponieważ automatyczne wykrywanie języka nie jest uwzględniane w trybie podstawowym. Jeśli język nie jest określony lub ustawiony na wartość null, automatyczne wykrywanie języka wybierze pierwszy wykryty język i przetworzy go przy użyciu wybranego języka na czas trwania pliku. Obecnie nie obsługuje dynamicznego przełączania między językami po wykryciu pierwszego języka. Automatyczne wykrywanie działa najlepiej w przypadku nagrań audio z wyraźnie rozpoznawalną mową. Jeśli automatyczne wykrywanie nie znajdzie języka, transkrypcja wróci do "en-US". Lista obsługiwanych języków jest dostępna tutaj: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

Słownik zawierający pary wartości klucza dla parametrów, które nie są widoczne w samym ustawieniu wstępnym

mode

AudioAnalysisMode

Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrana opcja Standard AudioAnalysisMode.

AudioOverlay

Opisuje właściwości nakładki audio.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.AudioOverlay

Dyskryminujący dla typów pochodnych.

audioGainLevel

number

Poziom zysku dźwięku w nakładce. Wartość powinna znajdować się w zakresie [0, 1.0]. Wartość domyślna to 1.0.

end

string

Położenie końcowe, z odwołaniem do wejściowego wideo, na którym kończy się nakładka. Wartość powinna być w formacie ISO 8601. Na przykład PT30S, aby zakończyć nakładkę o 30 sekund do wejściowego wideo. Jeśli nie określono wartości lub wartość jest większa niż czas trwania wejściowego wideo, nakładka zostanie zastosowana do końca wejściowego wideo, jeśli czas trwania nośników nakładki jest większy niż czas trwania wejściowego wideo, a w przeciwnym razie nakładka będzie trwać tak długo, jak nakładka czasu trwania nośnika nakładki.

fadeInDuration

string

Czas trwania, w którym nakładka zanika na wejściowym filmie wideo. Wartość powinna być w formacie czasu trwania ISO 8601. Jeśli nie określono domyślnego zachowania, nie ma zanikania (tak samo jak PT0S).

fadeOutDuration

string

Czas trwania, przez który nakładka zanika z wejściowego wideo. Wartość powinna być w formacie czasu trwania ISO 8601. Jeśli nie określono domyślnego zachowania, nie ma wynikania (tak samo jak PT0S).

inputLabel

string

Etykieta danych wejściowych zadania, które ma być używane jako nakładka. Dane wejściowe muszą określać dokładnie jeden plik. Możesz określić plik obrazu w formacie JPG, PNG, GIF lub BMP albo plik audio (taki jak plik WAV, MP3, WMA lub M4A) lub plik wideo. Zobacz https://aka.ms/mesformats pełną listę obsługiwanych formatów plików audio i wideo.

start

string

Pozycja początkowa z odwołaniem do wejściowego wideo, na którym rozpoczyna się nakładka. Wartość powinna być w formacie ISO 8601. Na przykład PT05S, aby uruchomić nakładkę o 5 sekundach w wejściowym filmie wideo. Jeśli nie określono nakładki, rozpoczyna się od początku wejściowego wideo.

AudioTrackDescriptor

Element TrackSelection do wybierania utworów audio.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.AudioTrackDescriptor

Dyskryminujący dla typów pochodnych.

channelMapping

ChannelMapping

Opcjonalne oznaczenie dla utworów audio z jednym kanałem. Można używać do łączenia utworów w utwory stereo lub wielokanałowe audio.

BlurType

Typ rozmycia

Nazwa Typ Opis
Black

string

Czarny: Filtr zaciemniania

Box

string

Pole: filtr debugowania, tylko pole ograniczenia

High

string

Wysoki: mylące filtr rozmycia

Low

string

Niski: filtr rozmycia samochodu pudełkowego

Med

string

Med: Filtr rozmycia Gaussian

BuiltInStandardEncoderPreset

Opisuje wbudowane ustawienie wstępne kodowania wejściowego wideo za pomocą kodera standardowego.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.BuiltInStandardEncoderPreset

Dyskryminator typów pochodnych.

configurations

PresetConfigurations

Opcjonalne ustawienia konfiguracji kodera. Konfiguracje są obsługiwane tylko w przypadku elementów ContentAwareEncoding i H265ContentAwareEncoding BuiltInStandardEncoderPreset.

presetName

EncoderNamedPreset

Wbudowane ustawienie wstępne, które ma być używane do kodowania filmów wideo.

ChannelMapping

Opcjonalne oznaczenie dla utworów audio z jednym kanałem. Można używać do łączenia utworów w utwory stereo lub wielokanałowe audio.

Nazwa Typ Opis
BackLeft

string

Lewy kanał z tyłu. Czasami nazywany kanałem lewego otaczania.

BackRight

string

Prawy kanał z tyłu. Czasami nazywany kanałem Prawej Tulejki.

Center

string

Kanał środkowy.

FrontLeft

string

Kanał z przodu po lewej stronie.

FrontRight

string

Prawy kanał z przodu.

LowFrequencyEffects

string

Kanał efektów o niskiej częstotliwości. Czasami nazywa się to również błędem

StereoLeft

string

Lewy kanał stereo. Czasami określane jako Down Mix Left.

StereoRight

string

Prawy kanał stereo. Czasami określane jako Down Mix Right.

Complexity

Umożliwia skonfigurowanie ustawień kodera w celu kontrolowania równowagi między szybkością a jakością. Przykład: ustaw wartość Złożoność jako Szybkość, aby przyspieszyć kodowanie, ale zmniejszyć wydajność kompresji.

Nazwa Typ Opis
Balanced

string

Konfiguruje koder do używania ustawień, które zapewniają równowagę między szybkością a jakością.

Quality

string

Konfiguruje koder do używania ustawień zoptymalizowanych pod kątem generowania danych wyjściowych o wyższej jakości kosztem wolniejszego ogólnego czasu kodowania.

Speed

string

Konfiguruje koder do używania ustawień zoptymalizowanych pod kątem szybszego kodowania. Jakość jest poświęcana w celu zmniejszenia czasu kodowania.

CopyAudio

Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego audio.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.CopyAudio

Dyskryminujący dla typów pochodnych.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

CopyVideo

Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego wideo bez ponownego kodowania.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.CopyVideo

Dyskryminujący dla typów pochodnych.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

DDAudio

Opisuje ustawienia kodowania dźwięku dolby Digital Audio Codec (AC3). Bieżąca implementacja obsługi dźwięku cyfrowego dolby to: numery kanałów audio na 1((mono), 2(stereo), 6(5.1side); Częstotliwość próbkowania audio na poziomie: 32K/44,1K/48K Hz; Wartości szybkości transmisji bitów audio jako specyfikacja AC3 obsługują: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 64000 bps.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.DDAudio

Dyskryminujący dla typów pochodnych.

bitrate

integer

Szybkość transmisji bitów w bitach na sekundę w danych wyjściowych zakodowanych audio.

channels

integer

Liczba kanałów w dźwięku.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

samplingRate

integer

Częstotliwość próbkowania do użycia do kodowania w hertz.

Deinterlace

Opisuje ustawienia usuwania przeplatania.

Nazwa Typ Opis
mode

DeinterlaceMode

Tryb deinterlacingu. Wartość domyślna to AutoPixelAdaptive.

parity

DeinterlaceParity

Parzystość pól dla de-interlacing, domyślnie jest ustawiona na Auto.

DeinterlaceMode

Tryb deinterlacingu. Wartość domyślna to AutoPixelAdaptive.

Nazwa Typ Opis
AutoPixelAdaptive

string

Zastosuj automatyczne de-interlacing adaptacyjnego piksela na każdej ramce w wejściowym filmie wideo.

Off

string

Wyłącza odplatanie źródłowego klipu wideo.

DeinterlaceParity

Parzystość pól dla de-interlacing, domyślnie jest ustawiona na Auto.

Nazwa Typ Opis
Auto

string

Automatyczne wykrywanie kolejności pól

BottomFieldFirst

string

Zastosuj pierwsze przetwarzanie danych wejściowych wideo w polu dolnym.

TopFieldFirst

string

Zastosuj pierwsze przetwarzanie danych wejściowych wideo w polu górnym.

EncoderNamedPreset

Wbudowane ustawienie wstępne, które ma być używane do kodowania filmów wideo.

Nazwa Typ Opis
AACGoodQualityAudio

string

Tworzy pojedynczy plik MP4 zawierający tylko dźwięk stereo AAC zakodowany na 192 kb/s.

AdaptiveStreaming

string

Tworzy zestaw plików MP4 wyrównanych GOP z wideo H.264 i dźwięk stereo AAC. Automatycznie generuje drabinę szybkości transmisji bitów w oparciu o rozdzielczość danych wejściowych, szybkość transmisji bitów i szybkość klatek. Automatycznie generowane ustawienie wstępne nigdy nie przekroczy rozdzielczości danych wejściowych. Jeśli na przykład dane wejściowe to 720p, dane wyjściowe pozostaną w najlepszym stanie 720p.

ContentAwareEncoding

string

Tworzy zestaw plików MP4 dopasowanych do protokołu GOP przy użyciu kodowania obsługującego zawartość. Biorąc pod uwagę dowolną zawartość wejściową, usługa wykonuje początkową lekką analizę zawartości wejściowej i używa wyników do określenia optymalnej liczby warstw, odpowiednich ustawień szybkości transmisji bitów i rozdzielczości do dostarczania przez adaptacyjne przesyłanie strumieniowe. To ustawienie wstępne jest szczególnie skuteczne w przypadku filmów wideo o niskiej i średniej złożoności, gdzie pliki wyjściowe będą w niższych szybkościach bitów, ale w jakości, która nadal zapewnia dobre środowisko dla widzów. Dane wyjściowe będą zawierać pliki MP4 z przeplatane wideo i audio.

ContentAwareEncodingExperimental

string

Uwidacznia eksperymentalne ustawienie wstępne kodowania obsługującego zawartość. Biorąc pod uwagę dowolną zawartość wejściową, usługa próbuje automatycznie określić optymalną liczbę warstw, odpowiednią szybkość transmisji bitów i ustawienia rozdzielczości do dostarczania przez adaptacyjne przesyłanie strumieniowe. Podstawowe algorytmy będą nadal ewoluować wraz z upływem czasu. Dane wyjściowe będą zawierać pliki MP4 z przeplatane wideo i audio.

CopyAllBitrateNonInterleaved

string

Skopiuj wszystkie strumienie wideo i audio z elementu zawartości wejściowej jako nieprzeplatane pliki wyjściowe wideo i audio. To ustawienie wstępne może służyć do przycinania istniejącego elementu zawartości lub konwertowania grupy plików MP4 wyrównanych do grupy klawiszy (GOP) jako elementu zawartości, który można przesyłać strumieniowo.

DDGoodQualityAudio

string

Tworzy pojedynczy plik MP4 zawierający tylko dźwięk stereo DD(Digital Dolby) zakodowany na 192 kb/s.

H264MultipleBitrate1080p

string

Tworzy zestaw plików MP4 dopasowanych do 8 gop, począwszy od 6000 kb/s do 400 kb/s i dźwięk stereo AAC. Rozwiązanie zaczyna się od 1080p i spada do 180p.

H264MultipleBitrate720p

string

Tworzy zestaw plików MP4 dopasowanych do 6 GOP, począwszy od 3400 kb/s do 400 kb/s i dźwięk stereo AAC. Rozwiązanie zaczyna się od 720p i spada do 180p.

H264MultipleBitrateSD

string

Tworzy zestaw plików MP4 dopasowanych do 5 GOP, począwszy od 1900 kb/s do 400 kb/s i dźwięk stereo AAC. Rozdzielczość zaczyna się od 480p i spada do 240p.

H264SingleBitrate1080p

string

Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera-dekodera H.264 o rozmiarze 6750 kb/s i wysokości obrazu 1080 pikseli, a dźwięk stereo jest kodowany za pomocą kodera kodera AAC-LC o rozmiarze 128 kb/s.

H264SingleBitrate720p

string

Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera-dekodera H.264 o rozmiarze 4500 kb/s i wysokości obrazu 720 pikseli, a dźwięk stereo jest kodowany za pomocą kodera-dekodera AAC-LC o rozmiarze 128 kb/s.

H264SingleBitrateSD

string

Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera-dekodera H.264 o rozmiarze 2200 kb/s i wysokości obrazu 480 pikseli, a dźwięk stereo jest kodowany za pomocą kodera-dekodera AAC-LC o rozmiarze 128 kb/s.

H265AdaptiveStreaming

string

Tworzy zestaw plików MP4 wyrównanych do zestawu plików MP4 z wideo H.265 i stereo AAC audio. Automatycznie generuje drabinę szybkości transmisji bitów na podstawie rozdzielczości danych wejściowych, szybkości transmisji bitów i szybkości klatek. Ustawienie wstępne wygenerowane automatycznie nigdy nie przekroczy rozdzielczości wejściowej. Jeśli na przykład dane wejściowe to 720p, dane wyjściowe pozostaną w najlepszym stanie 720p.

H265ContentAwareEncoding

string

Tworzy zestaw plików MP4 dopasowanych do protokołu GOP przy użyciu kodowania obsługującego zawartość. Biorąc pod uwagę dowolną zawartość wejściową, usługa wykonuje początkową lekką analizę zawartości wejściowej i używa wyników do określenia optymalnej liczby warstw, odpowiednich ustawień szybkości transmisji bitów i rozdzielczości do dostarczania przez adaptacyjne przesyłanie strumieniowe. To ustawienie wstępne jest szczególnie skuteczne w przypadku filmów wideo o niskiej i średniej złożoności, gdzie pliki wyjściowe będą w niższych szybkościach bitów, ale w jakości, która nadal zapewnia dobre środowisko dla widzów. Dane wyjściowe będą zawierać pliki MP4 z przeplatane wideo i audio.

H265SingleBitrate1080p

string

Tworzy plik MP4, w którym wideo jest zakodowane przy użyciu kodera kodera H.265 na poziomie 3500 kb/s i wysokości obrazu 1080 pikseli, a dźwięk stereo jest kodowany za pomocą koderaka AAC-LC o rozmiarze 128 kb/s.

H265SingleBitrate4K

string

Tworzy plik MP4, w którym wideo jest zakodowane przy użyciu kodera kodera H.265 o rozmiarze 9500 kb/s i wysokości obrazu 2160 pikseli, a dźwięk stereo jest kodowany za pomocą koderaka AAC-LC o rozmiarze 128 kb/s.

H265SingleBitrate720p

string

Tworzy plik MP4, w którym wideo jest kodowane za pomocą kodera H.265 o rozmiarze 1800 kb/s i wysokości obrazu 720 pikseli, a dźwięk stereo jest kodowany za pomocą koderaka AAC-LC o rozmiarze 128 kb/s.

EntropyMode

Tryb entropii, który ma być używany dla tej warstwy. Jeśli nie zostanie określony, koder wybiera tryb odpowiedni dla profilu i poziomu.

Nazwa Typ Opis
Cabac

string

Kodowanie entropii entropii adaptacyjnej binarnej arytmetycznej (CABAC).

Cavlc

string

Koder entropii o zmiennej adaptacyjnej długości kontekstu (CAVLC).

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

FaceDetectorPreset

Opisuje wszystkie ustawienia, które mają być używane podczas analizowania wideo w celu wykrycia (i opcjonalnie redagowania) wszystkich obecnych twarzy.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.FaceDetectorPreset

Dyskryminator typów pochodnych.

blurType

BlurType

Typ rozmycia

experimentalOptions

object

Słownik zawierający pary wartości klucza dla parametrów, które nie są widoczne w samym ustawieniu wstępnym

mode

FaceRedactorMode

Ten tryb umożliwia wybór między następującymi ustawieniami: 1) Analizowanie — tylko do wykrywania. Ten tryb generuje metadanych wyglądy plików JSON twarzy w całym filmie wideo. Tam, gdzie to możliwe, do tej samej osoby przypisano ten sam identyfikator. 2) Połączone — dodatkowo wykrywane twarze są redacts (rozmycia). 3) Redact — umożliwia to proces 2-przekazywania, co umożliwia selektywne redagowanie podzestawu wykrytych twarzy. Pobiera on plik metadanych z poprzedniego przebiegu analizy wraz ze źródłowym filmem wideo oraz podzbiorem identyfikatorów wybranych przez użytkownika, które wymagają ponownego przeprowadzenia analizy.

resolution

AnalysisResolution

Określa maksymalną rozdzielczość, w której jest analizowane wideo. Domyślnym zachowaniem jest "SourceResolution", który zachowa wejściowy film wideo w oryginalnej rozdzielczości podczas analizowania. Użycie opcji "StandardDefinition" spowoduje zmianę rozmiaru wejściowych filmów wideo na standardową definicję przy zachowaniu odpowiedniego współczynnika proporcji. Zmiana rozmiaru będzie zmieniana tylko wtedy, gdy wideo ma wyższą rozdzielczość. Na przykład dane wejściowe 1920x1080 zostaną przeskalowane do 640x360 przed przetworzeniem. Przełączenie na "StandardDefinition" skróci czas przetwarzania wideo o wysokiej rozdzielczości. Może również zmniejszyć koszt korzystania z tego składnika (zobacz https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics szczegółowe informacje). Jednak twarze, które są zbyt małe w zmienionym rozmiarze wideo, mogą nie zostać wykryte.

FaceRedactorMode

Ten tryb umożliwia wybór między następującymi ustawieniami: 1) Analizowanie — tylko do wykrywania. Ten tryb generuje metadanych wyglądy plików JSON twarzy w całym filmie wideo. Tam, gdzie to możliwe, do tej samej osoby przypisano ten sam identyfikator. 2) Połączone — dodatkowo wykrywane twarze są redacts (rozmycia). 3) Redact — umożliwia to proces 2-przekazywania, co umożliwia selektywne redagowanie podzestawu wykrytych twarzy. Pobiera on plik metadanych z poprzedniego przebiegu analizy wraz ze źródłowym filmem wideo oraz podzbiorem identyfikatorów wybranych przez użytkownika, które wymagają ponownego przeprowadzenia analizy.

Nazwa Typ Opis
Analyze

string

Tryb analizy wykrywa twarze i generuje plik metadanych z wynikami. Umożliwia edytowanie pliku metadanych przed rozmyciem twarzy w trybie redact.

Combined

string

Tryb połączony wykonuje kroki Analizy i Redact w jednym przebiegu podczas edytowania przeanalizowanych twarzy nie jest pożądane.

Redact

string

Tryb redact używa pliku metadanych z trybu analizy i redaguje znalezione twarze.

Fade

Opisuje właściwości efektu Zanikania zastosowanego do nośnika wejściowego.

Nazwa Typ Opis
duration

string

Czas trwania efektu zanikania w filmie wideo. Wartość może być w formacie ISO 8601 (na przykład PT05S w celu zanikania koloru w ciągu 5 sekund) lub liczby ramek (na przykład 10 do zanikania 10 ramek od czasu rozpoczęcia) lub względnej wartości czasu trwania strumienia (na przykład 10% do zanikania 10% czasu trwania strumienia)

fadeColor

string

Kolor zanikania/wył. może to być w kolorach https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords CSS Level1 lub wartości szesnastkowej RGB: np. rgb(255,0,0), 0xFF0000 lub #FF0000

start

string

Pozycja w wejściowym filmie wideo, z którego chcesz rozpocząć zanikanie. Wartość może być w formacie ISO 8601 (na przykład PT05S do rozpoczęcia od 5 sekund) lub liczby ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względnej wartości czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Wartość domyślna to 0

Filters

Opisuje wszystkie operacje filtrowania, takie jak de-interlacing, rotacja itp., które mają być stosowane do nośnika wejściowego przed kodowaniem.

Nazwa Typ Opis
crop

Rectangle

Parametry okna prostokątnego, z którym mają być przycinane wejściowe wideo.

deinterlace

Deinterlace

Ustawienia usuwania przeplatania.

fadeIn

Fade

Opisuje właściwości efektu Zanikania zastosowanego do nośnika wejściowego.

fadeOut

Fade

Opisuje właściwości efektu Zanikania zastosowanego do nośnika wejściowego.

overlays Overlay[]:

Właściwości nakładek, które mają być stosowane do wejściowego wideo. Mogą to być nakładki audio, obrazu lub wideo.

rotation

Rotation

Rotacja, jeśli istnieje, do stosowania do wejściowego wideo, zanim zostanie zakodowana. Wartość domyślna to Auto

FromAllInputFile

Element InputDefinition, który wyszukuje wszystkie udostępnione pliki w celu wybrania ścieżek określonych przez właściwość IncludedTracks. Ogólnie używany z elementami AudioTrackByAttribute i VideoTrackByAttribute w celu umożliwienia wyboru pojedynczej ścieżki w zestawie plików wejściowych.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.FromAllInputFile

Dyskryminator typów pochodnych.

includedTracks TrackDescriptor[]:

Lista klas TrackDescriptor definiujących metadane i wybór ścieżek w danych wejściowych.

FromEachInputFile

Element InputDefinition, który sprawdza każdy plik wejściowy w celu wybrania ścieżek określonych przez właściwość IncludedTracks. Ogólnie używane z audioTrackByAttribute i VideoTrackByAttribute do wybierania ścieżek z każdego pliku podanego.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.FromEachInputFile

Dyskryminator typów pochodnych.

includedTracks TrackDescriptor[]:

Lista klas TrackDescriptor definiujących metadane i wybór ścieżek w danych wejściowych.

H264Complexity

Informuje koder, jak wybrać jego ustawienia kodowania. Wartość domyślna to Zrównoważony.

Nazwa Typ Opis
Balanced

string

Informuje koder o użyciu ustawień, które zapewniają równowagę między szybkością a jakością.

Quality

string

Informuje koder o użyciu ustawień zoptymalizowanych pod kątem generowania danych wyjściowych o wyższej jakości kosztem wolniejszego ogólnego czasu kodowania.

Speed

string

Informuje koder o użyciu ustawień zoptymalizowanych pod kątem szybszego kodowania. Jakość jest poświęcana w celu zmniejszenia czasu kodowania.

H264Layer

Opisuje ustawienia, które mają być używane podczas kodowania wejściowego wideo do żądanej warstwy szybkości transmisji bitów danych wyjściowych za pomocą kodera wideo H.264.

Nazwa Typ Opis
adaptiveBFrame

boolean

Niezależnie od tego, czy należy używać adaptacyjnych ramek B podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder włączy go za każdym razem, gdy profil wideo zezwoli na jego użycie.

bFrames

integer

Liczba ramek B do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder wybierze odpowiednią liczbę na podstawie profilu i poziomu wideo.

bitrate

integer

Średnia szybkość transmisji bitów w bitach na sekundę, w której kodowanie wejściowego wideo podczas generowania tej warstwy. To pole jest wymagane.

bufferWindow

string

Długość okna buforu VBV. Wartość powinna być w formacie ISO 8601. Wartość powinna znajdować się w zakresie [0,1–100] sekund. Wartość domyślna to 5 sekund (na przykład PT5S).

crf

number

Wartość CRF, która ma być używana podczas kodowania tej warstwy. To ustawienie ma zastosowanie, gdy funkcja RateControlMode kodera wideo jest ustawiana w trybie CRF. Zakres wartości CRF wynosi od 0 do 51, gdzie niższe wartości spowodują lepszą jakość, kosztem wyższych rozmiarów plików. Wyższe wartości oznaczają większą kompresję, ale w pewnym momencie zostanie zauważona degradacja jakości. Wartość domyślna to 23.

entropyMode

EntropyMode

Tryb entropii, który ma być używany dla tej warstwy. Jeśli nie zostanie określony, koder wybierze tryb odpowiedni dla profilu i poziomu.

frameRate

string

Szybkość klatek (w ramkach na sekundę), przy której należy zakodować tę warstwę. Wartość może być w postaci M/N, gdzie M i N są liczbami całkowitymi (na przykład 30000/1001) lub w postaci liczby (na przykład 30 lub 29,97). Koder wymusza ograniczenia dozwolonej szybkości klatek na podstawie profilu i poziomu. Jeśli nie zostanie określony, koder będzie używać tej samej szybkości klatek co wejściowy film wideo.

height

string

Wysokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę więcej pikseli wysokości jako danych wejściowych.

label

string

Etykieta alfanumeryczna dla tej warstwy, która może być używana w multipleksowaniu różnych warstw wideo i audio lub nazewnictwa pliku wyjściowego.

level

string

Obecnie obsługujemy poziom do 6,2. Wartość może być automatyczna lub liczba zgodna z profilem H.264. Jeśli nie zostanie określony, wartość domyślna to Auto, co pozwala koderowi wybrać poziom odpowiedni dla tej warstwy.

maxBitrate

integer

Maksymalna szybkość transmisji bitów (w bitach na sekundę), przy której należy założyć ponowne wypełnienie buforu VBV. Jeśli nie zostanie określony, wartość domyślna to ta sama wartość co szybkość transmisji bitów.

profile

H264VideoProfile

Obecnie obsługujemy plan bazowy, main, high, high422, High444. Wartość domyślna to Auto.

referenceFrames

integer

Liczba ramek referencyjnych do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder określa odpowiednią liczbę na podstawie ustawienia złożoności kodera.

slices

integer

Liczba wycinków do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, wartość domyślna to zero, co oznacza, że koder będzie używać pojedynczego wycinka dla każdej ramki.

width

string

Szerokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę tylu pikseli szerokości, jak dane wejściowe.

H264RateControlMode

Tryb sterowania szybkością wideo

Nazwa Typ Opis
ABR

string

Średni tryb szybkości transmisji bitów (ABR), który osiąga docelową szybkość transmisji bitów: tryb domyślny.

CBR

string

Tryb stałej szybkości transmisji bitów (CBR), który zaostrza różnice szybkości transmisji bitów wokół docelowej szybkości transmisji bitów.

CRF

string

Tryb współczynnika stałej szybkości (CRF), który jest przeznaczony dla stałej subiektywnej jakości.

H264Video

Opisuje wszystkie właściwości kodowania wideo za pomocą kodera H.264.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.H264Video

Dyskryminujący dla typów pochodnych.

complexity

H264Complexity

Informuje koder, jak wybrać jego ustawienia kodowania. Wartość domyślna to Zrównoważony.

keyFrameInterval

string

Odległość między dwiema ramkami klawiszy. Wartość powinna być niezerowa w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

layers

H264Layer[]

Kolekcja wyjściowych warstw H.264 do produkcji przez koder.

rateControlMode

H264RateControlMode

Tryb sterowania szybkością wideo

sceneChangeDetection

boolean

Niezależnie od tego, czy koder powinien wstawić kluczowe ramki w scenie zmienia się. Jeśli nie zostanie określony, wartość domyślna to false. Ta flaga powinna być ustawiona na wartość true tylko wtedy, gdy koder jest skonfigurowany do tworzenia pojedynczego wyjściowego wideo.

stretchMode

StretchMode

Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize

syncMode

VideoSyncMode

Tryb synchronizacji wideo

H264VideoProfile

Obecnie obsługujemy linię bazową, Main, High, High422, High444. Wartość domyślna to Auto.

Nazwa Typ Opis
Auto

string

Nakazuje koderowi automatyczne określenie odpowiedniego profilu H.264.

Baseline

string

Profil punktu odniesienia

High

string

Wysoki profil.

High422

string

Wysoki profil 4:2:2.

High444

string

Wysoki profil predykcyjny 4:4:4.

Main

string

Profil główny

H265Complexity

Informuje koder, jak wybrać jego ustawienia kodowania. Jakość zapewni wyższy współczynnik kompresji, ale przy wyższym koszcie i dłuższym czasie obliczeniowym. Szybkość będzie produkować stosunkowo większy plik, ale jest szybszy i bardziej ekonomiczny. Wartość domyślna to Zrównoważony.

Nazwa Typ Opis
Balanced

string

Informuje koder o użyciu ustawień, które zapewniają równowagę między szybkością a jakością.

Quality

string

Informuje koder o użyciu ustawień zoptymalizowanych pod kątem generowania danych wyjściowych o wyższej jakości kosztem wolniejszego ogólnego czasu kodowania.

Speed

string

Informuje koder o użyciu ustawień zoptymalizowanych pod kątem szybszego kodowania. Jakość jest poświęcana w celu zmniejszenia czasu kodowania.

H265Layer

Opisuje ustawienia, które mają być używane podczas kodowania wejściowego wideo do żądanej warstwy szybkości transmisji bitów danych wyjściowych za pomocą kodera wideo H.265.

Nazwa Typ Opis
adaptiveBFrame

boolean

Określa, czy podczas kodowania tej warstwy mają być używane adaptacyjne ramki B. Jeśli nie zostanie określony, koder włączy go za każdym razem, gdy profil wideo zezwoli na jego użycie.

bFrames

integer

Liczba ramek B do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder wybierze odpowiednią liczbę na podstawie profilu i poziomu wideo.

bitrate

integer

Średnia szybkość transmisji bitów w bitach na sekundę, w której kodowanie wejściowego wideo podczas generowania tej warstwy. Na przykład: docelowa szybkość transmisji bitów 3000 Kb/s lub 3 Mb/s oznacza, że ta wartość powinna wynosić 30000000. Jest to wymagane pole.

bufferWindow

string

Długość okna buforu VBV. Wartość powinna być w formacie ISO 8601. Wartość powinna znajdować się w zakresie [0,1–100] sekund. Wartość domyślna to 5 sekund (na przykład PT5S).

crf

number

Wartość CRF, która ma być używana podczas kodowania tej warstwy. To ustawienie ma zastosowanie, gdy funkcja RateControlMode kodera wideo jest ustawiana w trybie CRF. Zakres wartości CRF wynosi od 0 do 51, gdzie niższe wartości spowodują lepszą jakość, kosztem wyższych rozmiarów plików. Wyższe wartości oznaczają większą kompresję, ale w pewnym momencie zostanie zauważona degradacja jakości. Wartość domyślna to 28.

frameRate

string

Szybkość klatek (w ramkach na sekundę), przy której należy zakodować tę warstwę. Wartość może być w postaci M/N, gdzie M i N są liczbami całkowitymi (na przykład 30000/1001) lub w postaci liczby (na przykład 30 lub 29,97). Koder wymusza ograniczenia dozwolonej szybkości klatek na podstawie profilu i poziomu. Jeśli nie zostanie określony, koder będzie używać tej samej szybkości klatek co wejściowy film wideo.

height

string

Wysokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę więcej pikseli wysokości jako danych wejściowych.

label

string

Etykieta alfanumeryczna dla tej warstwy, która może być używana w multipleksowaniu różnych warstw wideo i audio lub nazewnictwa pliku wyjściowego.

level

string

Obecnie obsługujemy poziom do 6,2. Wartość może być automatyczna lub liczba zgodna z profilem H.265. Jeśli nie zostanie określony, wartość domyślna to Auto, co pozwala koderowi wybrać poziom odpowiedni dla tej warstwy.

maxBitrate

integer

Maksymalna szybkość transmisji bitów (w bitach na sekundę), przy której należy założyć ponowne wypełnienie buforu VBV. Jeśli nie zostanie określony, wartość domyślna to ta sama wartość co szybkość transmisji bitów.

profile

H265VideoProfile

Obecnie obsługujemy program Main. Wartość domyślna to Auto.

referenceFrames

integer

Liczba ramek referencyjnych do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, koder określa odpowiednią liczbę na podstawie ustawienia złożoności kodera.

slices

integer

Liczba wycinków do użycia podczas kodowania tej warstwy. Jeśli nie zostanie określony, wartość domyślna to zero, co oznacza, że koder będzie używać pojedynczego wycinka dla każdej ramki.

width

string

Szerokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę tylu pikseli szerokości, jak dane wejściowe.

H265Video

Opisuje wszystkie właściwości kodowania wideo za pomocą kodera H.265.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.H265Video

Dyskryminujący dla typów pochodnych.

complexity

H265Complexity

Informuje koder, jak wybrać jego ustawienia kodowania. Jakość zapewni wyższy współczynnik kompresji, ale przy wyższym koszcie i dłuższym czasie obliczeniowym. Szybkość będzie produkować stosunkowo większy plik, ale jest szybszy i bardziej ekonomiczny. Wartość domyślna to Zrównoważony.

keyFrameInterval

string

Odległość między dwiema ramkami klawiszy. Wartość powinna być niezerowa w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

layers

H265Layer[]

Kolekcja wyjściowych warstw H.265, które mają być tworzone przez koder.

sceneChangeDetection

boolean

Określa, czy koder powinien wstawić kluczowe ramki w scenie zmiany. Jeśli nie zostanie określony, wartość domyślna to false. Ta flaga powinna być ustawiona na wartość true tylko wtedy, gdy koder jest skonfigurowany do tworzenia pojedynczego wyjściowego wideo.

stretchMode

StretchMode

Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize

syncMode

VideoSyncMode

Tryb synchronizacji wideo

H265VideoProfile

Obecnie obsługujemy główną. Wartość domyślna to Auto.

Nazwa Typ Opis
Auto

string

Nakazuje koderowi automatyczne określenie odpowiedniego profilu H.265.

Main

string

Profil główny (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier)

Main10

string

Główny profil 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10)

Image

Opisuje podstawowe właściwości generowania miniatur z wejściowego wideo

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.Image

Dyskryminujący dla typów pochodnych.

keyFrameInterval

string

Odległość między dwiema ramkami klawiszy. Wartość powinna być niezerowa w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

range

string

Pozycja względem przekształcenia wstępnie ustawionego czasu rozpoczęcia w wejściowym filmie wideo, na którym zatrzymaj generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT5M30S zatrzymać się o 5 minutach i 30 sekund od czasu rozpoczęcia) lub liczbę ramek (na przykład 300, aby zatrzymać się na 300 ramce od ramki w czasie rozpoczęcia. Jeśli ta wartość to 1, oznacza to tylko utworzenie jednej miniatury w czasie rozpoczęcia) lub względną wartość czasu trwania strumienia (na przykład 50%, aby zatrzymać się w połowie czasu trwania strumienia od czasu rozpoczęcia). Wartość domyślna to 100%, co oznacza zatrzymanie na końcu strumienia.

start

string

Pozycja w wejściowym filmie wideo, z którego chcesz rozpocząć generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT05S do rozpoczęcia od 5 sekund) lub liczby ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względnej wartości czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Obsługuje również makro {Best}, które informuje koder o wybraniu najlepszej miniatury z pierwszych kilku sekund filmu wideo i utworzy tylko jedną miniaturę, bez względu na to, jakie są inne ustawienia dla kroku i zakresu. Wartość domyślna to makro {Best}.

step

string

Interwały, w których są generowane miniatury. Wartość może mieć format ISO 8601 (na przykład PT05S dla jednego obrazu co 5 sekund) lub liczbę ramek (na przykład 30 dla jednego obrazu co 30 ramek) lub względną wartość czasu trwania strumienia (na przykład 10% dla jednego obrazu co 10% czasu trwania strumienia). Uwaga: wartość kroku będzie mieć wpływ na pierwszą wygenerowaną miniaturę, która może nie być dokładnie określona w czasie rozpoczęcia wstępnego przekształcania. Jest to spowodowane koderem, który próbuje wybrać najlepszą miniaturę między godziną rozpoczęcia a pozycją Krok od momentu rozpoczęcia jako pierwsze dane wyjściowe. Ponieważ wartość domyślna to 10%, oznacza to, że jeśli strumień ma długi czas trwania, pierwsza wygenerowana miniatura może być daleko od tej określonej w czasie rozpoczęcia. Spróbuj wybrać rozsądną wartość kroku, jeśli pierwsza miniatura jest oczekiwana blisko czasu rozpoczęcia, lub ustaw wartość Zakres na 1, jeśli tylko jedna miniatura jest potrzebna w czasie rozpoczęcia.

stretchMode

StretchMode

Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize

syncMode

VideoSyncMode

Tryb synchronizacji wideo

ImageFormat

Opisuje właściwości pliku obrazu wyjściowego.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.ImageFormat

Dyskryminujący dla typów pochodnych.

filenamePattern

string

Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.

InputFile

Element InputDefinition dla pojedynczego pliku. Zakres śledzenia wyborów jest określony w pliku.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.InputFile

Dyskryminator typów pochodnych.

filename

string

Nazwa pliku, do którego ma zastosowanie ta definicja wejściowa.

includedTracks TrackDescriptor[]:

Lista klas TrackDescriptor definiujących metadane i wybór ścieżek w danych wejściowych.

InsightsType

Definiuje typ szczegółowych informacji, które mają zostać wygenerowane przez usługę. Dozwolone wartości to "AudioInsightsOnly", "VideoInsightsOnly" i "AllInsights". Wartość domyślna to AllInsights. Jeśli ustawisz tę wartość na Wartość AllInsights, a dane wejściowe są tylko audio, generowane są tylko szczegółowe informacje audio. Podobnie jeśli dane wejściowe są tylko wideo, generowane są tylko szczegółowe informacje wideo. Zaleca się, aby nie używać elementu AudioInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko wideo; lub użyj usługi VideoInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko audio. Zadania w takich warunkach wymykałyby się.

Nazwa Typ Opis
AllInsights

string

Generowanie zarówno szczegółowych informacji audio, jak i wideo. Nie powiedzie się, jeśli usługa Audio lub Wideo Insights zakończy się niepowodzeniem.

AudioInsightsOnly

string

Generowanie szczegółowych informacji tylko o dźwiękach. Ignoruj wideo, nawet jeśli istnieje. Kończy się niepowodzeniem, jeśli nie ma żadnego dźwięku.

VideoInsightsOnly

string

Generowanie tylko szczegółowych informacji dotyczących wideo. Ignoruj dźwięk, jeśli jest obecny. Nie powiedzie się, jeśli wideo nie jest obecne.

InterleaveOutput

Ustawia tryb przeplatania danych wyjściowych, aby kontrolować sposób przechowywania dźwięku i wideo w formacie kontenera. Przykład: ustaw wartość InterleavedOutput jako NonInterleavedOutput, aby wygenerować dane wyjściowe tylko audio i wideo w oddzielnych plikach MP4.

Nazwa Typ Opis
InterleavedOutput

string

Dane wyjściowe obejmują zarówno audio, jak i wideo.

NonInterleavedOutput

string

Dane wyjściowe są tylko wideo lub tylko audio.

Job

Typ zasobu zadania. Postęp i stan można uzyskać, sondując zadanie lub subskrybując zdarzenia przy użyciu usługi EventGrid.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nazwa zasobu

properties.correlationData

object

Klucz podany przez klienta, pary wartości, które zostaną zwrócone w zdarzeniach stanu Job i JobOutput.

properties.created

string

Data i godzina UTC utworzenia zadania przez klienta w formacie "RRRR-MM-DDThh:mm:ssZ".

properties.description

string

Opcjonalny klient podał opis zadania.

properties.endTime

string

Data i godzina UTC, o której to zadanie zakończyło przetwarzanie.

properties.input JobInput:

Dane wejściowe zadania.

properties.lastModified

string

Data i godzina UTC ostatniej aktualizacji zadania przez klienta w formacie "RRRR-MM-DDThh:mm:ssZ".

properties.outputs JobOutput[]:

JobOutputAsset[]

Dane wyjściowe zadania.

properties.priority

Priority

Priorytet, za pomocą którego zadanie powinno być przetwarzane. Zadania o wyższym priorytcie są przetwarzane przed zadaniami o niższym priorytcie. Jeśli nie zostanie ustawiona, wartość domyślna jest normalna.

properties.startTime

string

Data i godzina UTC, o której to zadanie rozpoczęło przetwarzanie.

properties.state

JobState

Bieżący stan zadania.

systemData

systemData

Metadane systemowe dotyczące tego zasobu.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

JobError

Szczegóły błędów JobOutput.

Nazwa Typ Opis
category

JobErrorCategory

Pomaga w kategoryzacji błędów.

code

JobErrorCode

Kod błędu opisujący błąd.

details

JobErrorDetail[]

Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.

message

string

Reprezentacja błędu zależna od języka czytelnego dla człowieka.

retry

JobRetry

Wskazuje, że można ponowić próbę wykonania zadania. Jeśli ponowna próba nie powiedzie się, skontaktuj się z pomoc techniczna platformy Azure za pośrednictwem witryny Azure Portal.

JobErrorCategory

Pomaga w kategoryzacji błędów.

Nazwa Typ Opis
Account

string

Błąd jest związany z informacjami o koncie.

Configuration

string

Błąd jest związany z konfiguracją.

Content

string

Błąd jest związany z danymi w plikach wejściowych.

Download

string

Błąd jest związany z pobieraniem.

Service

string

Błąd jest związany z usługą.

Upload

string

Błąd jest związany z przekazywaniem.

JobErrorCode

Kod błędu opisujący błąd.

Nazwa Typ Opis
ConfigurationUnsupported

string

Wystąpił problem z kombinacją plików wejściowych i zastosowanymi ustawieniami konfiguracji, napraw ustawienia konfiguracji i ponów próbę przy użyciu tych samych danych wejściowych lub zmień dane wejściowe, aby były zgodne z konfiguracją.

ContentMalformed

string

Wystąpił problem z zawartością wejściową (np. z zerowymi plikami bajtowymi lub uszkodzonymi/niedekodowalnymi plikami), sprawdź pliki wejściowe.

ContentUnsupported

string

Wystąpił problem z formatem danych wejściowych (nieprawidłowy plik multimedialny lub nieobsługiwany plik/koder-koder), sprawdź poprawność plików wejściowych.

DownloadNotAccessible

string

Podczas próby pobrania plików wejściowych pliki nie były dostępne, sprawdź dostępność źródła.

DownloadTransientError

string

Podczas próby pobrania plików wejściowych wystąpił problem podczas transferu (usługa magazynu, błędy sieci), zobacz szczegóły i sprawdź źródło.

IdentityUnsupported

string

Wystąpił błąd podczas weryfikowania tożsamości konta. Sprawdź i napraw konfiguracje tożsamości i spróbuj ponownie. Jeśli to nie powiedzie się, skontaktuj się z pomocą techniczną.

ServiceError

string

Błąd usługi krytycznej. Skontaktuj się z pomocą techniczną.

ServiceTransientError

string

Błąd przejściowy, ponów próbę, jeśli ponowienie próby nie powiedzie się, skontaktuj się z pomocą techniczną.

UploadNotAccessible

string

Podczas próby przekazania plików wyjściowych lokalizacja docelowa nie była osiągalna, sprawdź dostępność miejsca docelowego.

UploadTransientError

string

Podczas próby przekazania plików wyjściowych wystąpił problem podczas transferu (usługa magazynu, błędy sieci), zobacz szczegóły i sprawdź lokalizację docelową.

JobErrorDetail

Szczegóły błędów JobOutput.

Nazwa Typ Opis
code

string

Kod opisujący szczegóły błędu.

message

string

Czytelna dla człowieka reprezentacja błędu.

JobInputAsset

Reprezentuje zasób dla danych wejściowych w zadaniu.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.JobInputAsset

Dyskryminujący dla typów pochodnych.

assetName

string

Nazwa wejściowego elementu zawartości.

end ClipTime:

Definiuje punkt na osi czasu nośnika wejściowego, na którym zakończy się przetwarzanie. Domyślnie na końcu nośnika wejściowego.

files

string[]

Lista plików. Wymagane dla zadaniaInputHttp. Maksymalnie 4000 znaków każdy. Ciągi zapytań nie zostaną zwrócone w odpowiedziach usługi, aby zapobiec narażeniu poufnych danych.

inputDefinitions InputDefinition[]:

Definiuje listę parametrów InputDefinitions. Dla każdego elementu InputDefinition definiuje listę śledzenia wyborów i powiązanych metadanych.

label

string

Etykieta przypisana do elementu JobInputClip, która jest używana do spełnienia odwołania używanego w przekształceniu. Na przykład można utworzyć przekształcenie, aby utworzyć plik obrazu z etykietą "xyz" i zastosować ją jako nakładkę na wejściowy film wideo, zanim zostanie zakodowany. Podczas przesyłania zadania dokładnie jeden z elementów JobInputs powinien być plikiem obrazu i powinien mieć etykietę "xyz".

start ClipTime:

Definiuje punkt na osi czasu nośnika wejściowego, na którym rozpocznie się przetwarzanie. Wartość domyślna to początek nośnika wejściowego.

JobInputClip

Reprezentuje pliki wejściowe zadania.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.JobInputClip

Dyskryminujący dla typów pochodnych.

end ClipTime:

Definiuje punkt na osi czasu nośnika wejściowego, na którym zakończy się przetwarzanie. Domyślnie na końcu nośnika wejściowego.

files

string[]

Lista plików. Wymagane dla zadaniaInputHttp. Maksymalnie 4000 znaków każdy. Ciągi zapytań nie zostaną zwrócone w odpowiedziach usługi, aby zapobiec narażeniu poufnych danych.

inputDefinitions InputDefinition[]:

Definiuje listę parametrów InputDefinitions. Dla każdego elementu InputDefinition definiuje listę śledzenia wyborów i powiązanych metadanych.

label

string

Etykieta przypisana do elementu JobInputClip, która jest używana do spełnienia odwołania używanego w przekształceniu. Na przykład można utworzyć przekształcenie, aby utworzyć plik obrazu z etykietą "xyz" i zastosować ją jako nakładkę na wejściowy film wideo, zanim zostanie zakodowany. Podczas przesyłania zadania dokładnie jeden z elementów JobInputs powinien być plikiem obrazu i powinien mieć etykietę "xyz".

start ClipTime:

Definiuje punkt na osi czasu nośnika wejściowego, na którym rozpocznie się przetwarzanie. Wartość domyślna to początek nośnika wejściowego.

JobInputHttp

Reprezentuje dane wejściowe zadania HTTPS.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.JobInputHttp

Dyskryminator typów pochodnych.

baseUri

string

Podstawowy identyfikator URI dla danych wejściowych zadania HTTPS. Zostanie ona połączona z podanymi nazwami plików. Jeśli nie podano podstawowego identyfikatora URI, zakłada się, że podana lista plików jest w pełni kwalifikowana. Maksymalna długość 4000 znaków. Ciągi zapytania nie zostaną zwrócone w odpowiedziach usługi, aby zapobiec narażeniu poufnych danych.

end ClipTime:

Definiuje punkt na osi czasu nośnika wejściowego, na którym zakończy się przetwarzanie. Wartość domyślna to koniec nośnika wejściowego.

files

string[]

Lista plików. Wymagane dla funkcji JobInputHttp. Maksymalna liczba znaków: 4000 znaków. Ciągi zapytań nie będą zwracane w odpowiedziach usługi, aby zapobiec narażeniu poufnych danych.

inputDefinitions InputDefinition[]:

Definiuje listę elementów InputDefinitions. Dla każdego elementu InputDefinition definiuje listę śledzenia wyborów i powiązanych metadanych.

label

string

Etykieta przypisana do elementu JobInputClip, która jest używana do spełnienia odwołania używanego w transformacji. Na przykład można utworzyć przekształcenie, aby pobrać plik obrazu z etykietą "xyz" i zastosować go jako nakładkę na wejściowe wideo przed jego zakodowaniem. Podczas przesyłania zadania dokładnie jeden z elementów JobInputs powinien być plikiem obrazu i powinien mieć etykietę "xyz".

start ClipTime:

Definiuje punkt na osi czasu nośnika wejściowego, w którym rozpocznie się przetwarzanie. Wartość domyślna to początek nośnika wejściowego.

JobInputs

Opisuje listę danych wejściowych zadania.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.JobInputs

Dyskryminujący dla typów pochodnych.

inputs JobInput[]:

Lista danych wejściowych zadania.

JobInputSequence

Sekwencja zawiera uporządkowaną listę klipów, w których każdy klip jest obiektem JobInput. Sekwencja będzie traktowana jako pojedyncze dane wejściowe.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.JobInputSequence

Dyskryminujący dla typów pochodnych.

inputs JobInputClip[]:

JobInputs, które tworzą oś czasu.

JobOutputAsset

Reprezentuje zasób używany jako element JobOutput.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.JobOutputAsset

Dyskryminator typów pochodnych.

assetName

string

Nazwa wyjściowego elementu zawartości.

endTime

string

Data i godzina UTC, o której dane wyjściowe zadania zakończyły przetwarzanie.

error

JobError

Jeśli wartość JobOutput jest w stanie Błąd, zawiera szczegóły błędu.

label

string

Etykieta przypisana do elementu JobOutput w celu ułatwienia jego unikatowego identyfikowania. Jest to przydatne, gdy funkcja Transform ma więcej niż jeden element TransformOutput, w którym zadanie ma więcej niż jedną wartość JobOutput. W takich przypadkach po przesłaniu zadania dodasz co najmniej dwa elementy JobOutputs w tej samej kolejności co transformOutputs w przekształceniu. Następnie podczas pobierania zadania za pośrednictwem zdarzeń lub żądania GET można użyć etykiety , aby łatwo zidentyfikować wartość JobOutput. Jeśli etykieta nie zostanie podana, zostanie użyta domyślna wartość "{presetName}_{outputIndex}", gdzie wstępnie ustawiona nazwa to nazwa ustawienia wstępnego w odpowiednim elemencie TransformOutput, a indeks wyjściowy jest względnym indeksem tego obiektu JobOutput w zadaniu. Należy pamiętać, że ten indeks jest taki sam jak względny indeks odpowiadającego funkcji TransformOutput w ramach funkcji Transform.

presetOverride Preset:

Ustawienie wstępne używane do zastępowania ustawień w odpowiednich danych wyjściowych transformacji.

progress

integer

Jeśli wartość JobOutput jest w stanie Przetwarzanie, zawiera wartość procentową ukończenia zadania. Wartość jest oszacowaniem i nie jest przeznaczona do przewidywania czasów ukończenia zadania. Aby określić, czy element JobOutput został ukończony, użyj właściwości State.

startTime

string

Data i godzina UTC, o której dane wyjściowe zadania zaczęły przetwarzać.

state

JobState

Opisuje stan elementu JobOutput.

JobRetry

Wskazuje, że można ponowić próbę wykonania zadania. Jeśli ponowna próba nie powiedzie się, skontaktuj się z pomoc techniczna platformy Azure za pośrednictwem witryny Azure Portal.

Nazwa Typ Opis
DoNotRetry

string

Należy zbadać problem, a następnie ponownie przesłać zadanie z poprawkami lub ponowić próbę po skorygowaniu problemu podstawowego.

MayRetry

string

Problem można rozwiązać po odczekaniu przez pewien czas i ponownym przekazaniu tego samego zadania.

JobState

Opisuje stan elementu JobOutput.

Nazwa Typ Opis
Canceled

string

Zadanie zostało anulowane. Jest to ostateczny stan zadania.

Canceling

string

Zadanie jest w trakcie anulowania. Jest to stan przejściowy dla zadania.

Error

string

Zadanie napotkało błąd. Jest to ostateczny stan zadania.

Finished

string

Zadanie zostało zakończone. Jest to ostateczny stan zadania.

Processing

string

Zadanie jest przetwarzane. Jest to stan przejściowy dla zadania.

Queued

string

Zadanie jest w stanie w kolejce, czekając na udostępnienie zasobów. Jest to stan przejściowy.

Scheduled

string

Zadanie jest zaplanowane do uruchomienia w dostępnym zasobie. Jest to stan przejściowy między stanem w kolejce i stanem przetwarzania.

JpgFormat

Opisuje ustawienia tworzenia miniatur JPEG.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.JpgFormat

Dyskryminujący dla typów pochodnych.

filenamePattern

string

Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.

JpgImage

Opisuje właściwości tworzenia serii obrazów JPEG z wejściowego wideo.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.JpgImage

Dyskryminujący dla typów pochodnych.

keyFrameInterval

string

Odległość między dwiema ramkami klawiszy. Wartość powinna być niezerowa w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

layers

JpgLayer[]

Kolekcja wyjściowych warstw obrazów JPEG, które mają być tworzone przez koder.

range

string

Pozycja względem przekształcenia wstępnie ustawionego czasu rozpoczęcia w wejściowym filmie wideo, na którym zatrzymaj generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT5M30S zatrzymać się o 5 minutach i 30 sekund od czasu rozpoczęcia) lub liczbę ramek (na przykład 300, aby zatrzymać się na 300 ramce od ramki w czasie rozpoczęcia. Jeśli ta wartość to 1, oznacza to tylko utworzenie jednej miniatury w czasie rozpoczęcia) lub względną wartość czasu trwania strumienia (na przykład 50%, aby zatrzymać się w połowie czasu trwania strumienia od czasu rozpoczęcia). Wartość domyślna to 100%, co oznacza zatrzymanie na końcu strumienia.

spriteColumn

integer

Ustawia liczbę kolumn używanych na obrazie sprite miniatury. Liczba wierszy jest obliczana automatycznie, a plik VTT jest generowany przy użyciu mapowań współrzędnych dla każdej miniatury w sprite. Uwaga: ta wartość powinna być dodatnią liczbą całkowitą, a zalecana jest właściwa wartość, aby rozdzielczość obrazu wyjściowego nie przekraczała maksymalnego limitu rozdzielczości pikseli JPEG 65535x65535.

start

string

Pozycja w wejściowym filmie wideo, z którego chcesz rozpocząć generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT05S do rozpoczęcia od 5 sekund) lub liczby ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względnej wartości czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Obsługuje również makro {Best}, które informuje koder o wybraniu najlepszej miniatury z pierwszych kilku sekund filmu wideo i utworzy tylko jedną miniaturę, bez względu na to, jakie są inne ustawienia dla kroku i zakresu. Wartość domyślna to makro {Best}.

step

string

Interwały, w których są generowane miniatury. Wartość może mieć format ISO 8601 (na przykład PT05S dla jednego obrazu co 5 sekund) lub liczbę ramek (na przykład 30 dla jednego obrazu co 30 ramek) lub względną wartość czasu trwania strumienia (na przykład 10% dla jednego obrazu co 10% czasu trwania strumienia). Uwaga: wartość kroku będzie mieć wpływ na pierwszą wygenerowaną miniaturę, która może nie być dokładnie określona w czasie rozpoczęcia wstępnego przekształcania. Jest to spowodowane koderem, który próbuje wybrać najlepszą miniaturę między godziną rozpoczęcia a pozycją Krok od momentu rozpoczęcia jako pierwsze dane wyjściowe. Ponieważ wartość domyślna to 10%, oznacza to, że jeśli strumień ma długi czas trwania, pierwsza wygenerowana miniatura może być daleko od tej określonej w czasie rozpoczęcia. Spróbuj wybrać rozsądną wartość kroku, jeśli pierwsza miniatura jest oczekiwana blisko czasu rozpoczęcia, lub ustaw wartość Zakres na 1, jeśli tylko jedna miniatura jest potrzebna w czasie rozpoczęcia.

stretchMode

StretchMode

Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize

syncMode

VideoSyncMode

Tryb synchronizacji wideo

JpgLayer

Opisuje ustawienia służące do tworzenia obrazu JPEG z wejściowego wideo.

Nazwa Typ Opis
height

string

Wysokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę więcej pikseli wysokości jako danych wejściowych.

label

string

Etykieta alfanumeryczna dla tej warstwy, która może być używana w multipleksowaniu różnych warstw wideo i audio lub nazewnictwa pliku wyjściowego.

quality

integer

Jakość kompresji danych wyjściowych JPEG. Zakres wynosi od 0 do 100, a wartość domyślna to 70.

width

string

Szerokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę tylu pikseli szerokości, jak dane wejściowe.

Mp4Format

Opisuje właściwości wyjściowego pliku ISO MP4.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.Mp4Format

Dyskryminujący dla typów pochodnych.

filenamePattern

string

Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.

outputFiles

OutputFile[]

Lista plików wyjściowych do utworzenia. Każdy wpis na liście jest zestawem etykiet warstw audio i wideo, które mają być połączone ze sobą.

MultiBitrateFormat

Opisuje właściwości tworzenia kolekcji plików o wielu szybkościach transmisji bitów wyrównywane przez usługę GOP. Domyślnym zachowaniem jest wygenerowanie jednego pliku wyjściowego dla każdej warstwy wideo, która jest muxed razem ze wszystkimi dźwiękami. Dokładne utworzone pliki wyjściowe można kontrolować, określając kolekcję outputFiles.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.MultiBitrateFormat

Dyskryminujący dla typów pochodnych.

filenamePattern

string

Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.

outputFiles

OutputFile[]

Lista plików wyjściowych do utworzenia. Każdy wpis na liście jest zestawem etykiet warstw audio i wideo, które mają być połączone ze sobą.

OutputFile

Reprezentuje utworzony plik wyjściowy.

Nazwa Typ Opis
labels

string[]

Lista etykiet opisujących, jak koder powinien multipleksować wideo i audio do pliku wyjściowego. Jeśli na przykład koder tworzy dwie warstwy wideo z etykietami w wersji 1 i v2, a jedna warstwa audio z etykietą a1, tablica podobna do "[v1, a1]" nakazuje koderowi wygenerowanie pliku wyjściowego ze ścieżką wideo reprezentowaną przez 1 i ścieżkę dźwiękową reprezentowaną przez element a1.

PngFormat

Opisuje ustawienia tworzenia miniatur PNG.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.PngFormat

Dyskryminujący dla typów pochodnych.

filenamePattern

string

Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.

PngImage

Opisuje właściwości tworzenia serii obrazów PNG z wejściowego wideo.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.PngImage

Dyskryminujący dla typów pochodnych.

keyFrameInterval

string

Odległość między dwiema ramkami klawiszy. Wartość powinna być niezerowa w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

layers

PngLayer[]

Kolekcja wyjściowych warstw obrazów PNG, które mają być tworzone przez koder.

range

string

Pozycja względem przekształcenia wstępnie ustawionego czasu rozpoczęcia w wejściowym filmie wideo, na którym zatrzymaj generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT5M30S zatrzymać się o 5 minutach i 30 sekund od czasu rozpoczęcia) lub liczbę ramek (na przykład 300, aby zatrzymać się na 300 ramce od ramki w czasie rozpoczęcia. Jeśli ta wartość to 1, oznacza to tylko utworzenie jednej miniatury w czasie rozpoczęcia) lub względną wartość czasu trwania strumienia (na przykład 50%, aby zatrzymać się w połowie czasu trwania strumienia od czasu rozpoczęcia). Wartość domyślna to 100%, co oznacza zatrzymanie na końcu strumienia.

start

string

Pozycja w wejściowym filmie wideo, z którego chcesz rozpocząć generowanie miniatur. Wartość może być w formacie ISO 8601 (na przykład PT05S do rozpoczęcia od 5 sekund) lub liczby ramek (na przykład 10, aby rozpocząć od 10 ramki) lub względnej wartości czasu trwania strumienia (na przykład 10% do rozpoczęcia od 10% czasu trwania strumienia). Obsługuje również makro {Best}, które informuje koder o wybraniu najlepszej miniatury z pierwszych kilku sekund filmu wideo i utworzy tylko jedną miniaturę, bez względu na to, jakie są inne ustawienia dla kroku i zakresu. Wartość domyślna to makro {Best}.

step

string

Interwały, w których są generowane miniatury. Wartość może mieć format ISO 8601 (na przykład PT05S dla jednego obrazu co 5 sekund) lub liczbę ramek (na przykład 30 dla jednego obrazu co 30 ramek) lub względną wartość czasu trwania strumienia (na przykład 10% dla jednego obrazu co 10% czasu trwania strumienia). Uwaga: wartość kroku będzie mieć wpływ na pierwszą wygenerowaną miniaturę, która może nie być dokładnie określona w czasie rozpoczęcia wstępnego przekształcania. Jest to spowodowane koderem, który próbuje wybrać najlepszą miniaturę między godziną rozpoczęcia a pozycją Krok od momentu rozpoczęcia jako pierwsze dane wyjściowe. Ponieważ wartość domyślna to 10%, oznacza to, że jeśli strumień ma długi czas trwania, pierwsza wygenerowana miniatura może być daleko od tej określonej w czasie rozpoczęcia. Spróbuj wybrać rozsądną wartość kroku, jeśli pierwsza miniatura jest oczekiwana blisko czasu rozpoczęcia, lub ustaw wartość Zakres na 1, jeśli tylko jedna miniatura jest potrzebna w czasie rozpoczęcia.

stretchMode

StretchMode

Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize

syncMode

VideoSyncMode

Tryb synchronizacji wideo

PngLayer

Opisuje ustawienia służące do tworzenia obrazu PNG z wejściowego wideo.

Nazwa Typ Opis
height

string

Wysokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę więcej pikseli wysokości jako danych wejściowych.

label

string

Etykieta alfanumeryczna dla tej warstwy, która może być używana w multipleksowaniu różnych warstw wideo i audio lub nazewnictwa pliku wyjściowego.

width

string

Szerokość wyjściowego wideo dla tej warstwy. Wartość może być bezwzględna (w pikselach) lub względna (w procentach). Na przykład 50% oznacza, że wyjściowy film wideo ma połowę tylu pikseli szerokości, jak dane wejściowe.

PresetConfigurations

Obiekt opcjonalnych ustawień konfiguracji kodera.

Nazwa Typ Opis
complexity

Complexity

Umożliwia skonfigurowanie ustawień kodera w celu kontrolowania równowagi między szybkością a jakością. Przykład: ustaw wartość Złożoność jako Szybkość, aby przyspieszyć kodowanie, ale zmniejszyć wydajność kompresji.

interleaveOutput

InterleaveOutput

Ustawia tryb przeplotu danych wyjściowych, aby kontrolować sposób przechowywania dźwięku i wideo w formacie kontenera. Przykład: ustaw wartość InterleavedOutput jako NonInterleavedOutput, aby wygenerować dane wyjściowe tylko do audio i wideo w oddzielnych plikach MP4.

keyFrameIntervalInSeconds

number

Interwał klatek kluczowych w sekundach. Przykład: ustaw wartość KeyFrameIntervalInSeconds na 2, aby zmniejszyć buforowanie odtwarzania dla niektórych graczy.

maxBitrateBps

integer

Maksymalna szybkość transmisji bitów w bitach na sekundę (próg dla górnej warstwy wideo). Przykład: ustaw parametr MaxBitrateBps na wartość 60000000, aby uniknąć tworzenia bardzo wysokich danych wyjściowych o szybkości transmisji bitów dla zawartości o wysokiej złożoności.

maxHeight

integer

Maksymalna wysokość wyjściowych warstw wideo. Przykład: ustaw wartość MaxHeight jako 720, aby wygenerować warstwy wyjściowe do 720P, nawet jeśli wartość wejściowa to 4K.

maxLayers

integer

Maksymalna liczba wyjściowych warstw wideo. Przykład: ustaw wartość MaxLayers jako 4, aby upewnić się, że co najwyżej 4 warstwy wyjściowe są tworzone w celu kontrolowania ogólnego kosztu zadania kodowania.

minBitrateBps

integer

Minimalna szybkość transmisji bitów w bitach na sekundę (próg dla dolnej warstwy wideo). Przykład: ustaw wartość MinBitrateBps jako 200000, aby mieć dolną warstwę, która obejmuje użytkowników o niskiej przepustowości sieci.

minHeight

integer

Minimalna wysokość wyjściowych warstw wideo. Przykład: ustaw wartość MinHeight jako 360, aby uniknąć warstw wyjściowych mniejszych rozdzielczości, takich jak 180P.

Priority

Ustawia względny priorytet transformOutputs w ramach przekształcenia. Określa priorytet używany przez usługę do przetwarzania funkcji TransformOutputs. Domyślny priorytet to Normal.

Nazwa Typ Opis
High

string

Służy do przekształcaniaOutputs, które powinny mieć pierwszeństwo przed innymi.

Low

string

Służy do przekształcaniaOutputs, które można wygenerować po normalnych i wysokich priorytetach TransformOutputs.

Normal

string

Służy do przekształcaniaOutputs, które można wygenerować przy normalnym priorytetyzowanym.

Rectangle

Opisuje właściwości okna prostokątnego zastosowanego do nośnika wejściowego przed jego przetworzeniem.

Nazwa Typ Opis
height

string

Wysokość prostokątnego regionu w pikselach. Może to być wartość bezwzględna pikseli (np. 100) lub względem rozmiaru wideo (na przykład 50%).

left

string

Liczba pikseli z lewego marginesu. Może to być wartość bezwzględna pikseli (np. 100) lub względem rozmiaru wideo (na przykład 50%).

top

string

Liczba pikseli z górnego marginesu. Może to być wartość bezwzględna pikseli (np. 100) lub względem rozmiaru wideo (na przykład 50%).

width

string

Szerokość prostokątnego regionu w pikselach. Może to być wartość bezwzględna pikseli (np. 100) lub względem rozmiaru wideo (na przykład 50%).

Rotation

Rotacja, jeśli istnieje, do stosowania do wejściowego wideo, zanim zostanie zakodowana. Wartość domyślna to Auto

Nazwa Typ Opis
Auto

string

Automatycznie wykrywaj i obracaj je zgodnie z potrzebami.

None

string

Nie obracaj wideo. Jeśli format danych wyjściowych go obsługuje, wszelkie metadane dotyczące rotacji są nienaruszone.

Rotate0

string

Nie obracaj filmu wideo, ale usuwaj metadane dotyczące rotacji.

Rotate180

string

Obróć 180 stopni zgodnie z ruchem wskazówek zegara.

Rotate270

string

Obróć 270 stopni zgodnie z ruchem wskazówek zegara.

Rotate90

string

Obróć 90 stopni zgodnie z ruchem wskazówek zegara.

SelectAudioTrackByAttribute

Wybierz ścieżki audio z danych wejściowych, określając atrybut i filtr atrybutu.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.SelectAudioTrackByAttribute

Dyskryminujący dla typów pochodnych.

attribute

TrackAttribute

Element TrackAttribute do filtrowania ścieżek według.

channelMapping

ChannelMapping

Opcjonalne oznaczenie dla utworów audio z jednym kanałem. Można używać do łączenia utworów w utwory stereo lub wielokanałowe audio.

filter

AttributeFilter

Typ AtrybutFilter, który ma być stosowany do elementu TrackAttribute, aby wybrać ścieżki.

filterValue

string

Wartość do filtrowania ścieżek według. Używane tylko wtedy, gdy atrybutFilter.ValueEquals jest określony dla właściwości Filter.

SelectAudioTrackById

Wybierz ścieżki audio z danych wejściowych, określając identyfikator śledzenia.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.SelectAudioTrackById

Dyskryminujący dla typów pochodnych.

channelMapping

ChannelMapping

Opcjonalne oznaczenie dla utworów audio z jednym kanałem. Można używać do łączenia utworów w utwory stereo lub wielokanałowe audio.

trackId

integer

Śledzenie identyfikatora do wybrania

SelectVideoTrackByAttribute

Wybierz ścieżki wideo z danych wejściowych, określając atrybut i filtr atrybutu.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.SelectVideoTrackByAttribute

Dyskryminujący dla typów pochodnych.

attribute

TrackAttribute

Element TrackAttribute do filtrowania ścieżek według.

filter

AttributeFilter

Typ AtrybutFilter, który ma być stosowany do elementu TrackAttribute, aby wybrać ścieżki.

filterValue

string

Wartość do filtrowania ścieżek według. Używane tylko wtedy, gdy atrybutFilter.ValueEquals jest określony dla właściwości Filter. W przypadku parametru TrackAttribute.Bitrate powinna to być wartość całkowita w bitach na sekundę (np. "1500000"). Język TrackAttribute.Language nie jest obsługiwany w przypadku ścieżek wideo.

SelectVideoTrackById

Wybierz ścieżki wideo z danych wejściowych, określając identyfikator śledzenia.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.SelectVideoTrackById

Dyskryminujący dla typów pochodnych.

trackId

integer

Śledzenie identyfikatora do wybrania

StandardEncoderPreset

Opisuje wszystkie ustawienia, które mają być używane podczas kodowania wejściowego wideo za pomocą kodera standardowego.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.StandardEncoderPreset

Dyskryminator typów pochodnych.

codecs Codec[]:

Lista koderów koderów do użycia podczas kodowania wejściowego wideo.

experimentalOptions

object

Słownik zawierający pary wartości klucza dla parametrów, które nie są widoczne w samym ustawieniu wstępnym

filters

Filters

Co najmniej jedna operacja filtrowania, która jest stosowana do nośnika wejściowego przed kodowaniem.

formats Format[]:

Lista danych wyjściowych, które mają być generowane przez koder.

StretchMode

Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize

Nazwa Typ Opis
AutoFit

string

Zapełnij dane wyjściowe (z polem litera lub kolumną), aby uhonorować rozdzielczość danych wyjściowych, zapewniając jednocześnie, że aktywny region wideo w danych wyjściowych ma taki sam współczynnik proporcji jak dane wejściowe. Jeśli na przykład dane wejściowe to 1920x1080, a ustawienie wstępne kodowania prosi o 1280x1280, dane wyjściowe będą mieć rozmiar 1280x1280, który zawiera wewnętrzny prostokąt wynoszący 1280x720 w stosunku proporcji 16:9, a regiony pola filarowego o szerokości 280 pikseli w lewo i po prawej stronie.

AutoSize

string

Przesłoń rozdzielczość danych wyjściowych i zmień ją tak, aby była zgodna z współczynnikiem proporcji wyświetlania danych wejściowych bez dopełniania. Jeśli na przykład dane wejściowe to 1920x1080, a ustawienie wstępne kodowania pyta o 1280x1280, wartość wstępnie ustawiona jest przesłonięta, a dane wyjściowe będą na poziomie 1280x720, co utrzymuje współczynnik proporcji wejściowej 16:9.

None

string

Ściśle przestrzegaj rozdzielczości danych wyjściowych bez uwzględniania współczynnika proporcji pikseli lub współczynnika proporcji ekranu wejściowego wideo.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

TrackAttribute

Element TrackAttribute do filtrowania ścieżek według.

Nazwa Typ Opis
Bitrate

string

Szybkość transmisji bitów ścieżki.

Language

string

Język ścieżki.

TransportStreamFormat

Opisuje właściwości generowania strumienia transportowego MPEG-2 (ISO/IEC 13818-1) wyjściowych plików wideo.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.TransportStreamFormat

Dyskryminujący dla typów pochodnych.

filenamePattern

string

Wzorzec nazewnictwa plików używany do tworzenia plików wyjściowych. Następujące makra są obsługiwane w nazwie pliku: {Basename} — makro rozszerzenia, które będzie używać nazwy wejściowego pliku wideo. Jeśli nazwa podstawowa (sufiks pliku nie jest uwzględniona) wejściowego pliku wideo jest mniejsza niż 32 znaki, zostanie użyta podstawowa nazwa wejściowych plików wideo. Jeśli długość podstawowej nazwy wejściowego pliku wideo przekracza 32 znaki, nazwa podstawowa jest obcięta do pierwszych 32 znaków w łącznej długości. {Extension} — odpowiednie rozszerzenie dla tego formatu. {Label} — etykieta przypisana do kodera/warstwy. {Index} — unikatowy indeks miniatur. Dotyczy tylko miniatur. {AudioStream} — ciąg "Audio" plus numer strumienia audio (początek od 1). {Szybkość transmisji bitów} — szybkość transmisji bitów audio/wideo w kb/s. Nie dotyczy miniatur. {Codec} — typ koderaka audio/wideo. {Resolution} — rozdzielczość wideo. Wszystkie niepodtytucyjne makra zostaną zwinięte i usunięte z nazwy pliku.

outputFiles

OutputFile[]

Lista plików wyjściowych do utworzenia. Każdy wpis na liście jest zestawem etykiet warstw audio i wideo, które mają być połączone ze sobą.

UtcClipTime

Określa godzinę klipu jako pozycję czasu UTC w pliku multimedialnym. Czas UTC może wskazywać inną pozycję w zależności od tego, czy plik multimedialny rozpoczyna się od znacznika czasu zera, czy nie.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.UtcClipTime

Dyskryminator typów pochodnych.

time

string

Położenie czasu na osi czasu nośnika wejściowego na podstawie czasu UTC.

Video

Opisuje podstawowe właściwości kodowania wejściowego wideo.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.Video

Dyskryminujący dla typów pochodnych.

keyFrameInterval

string

Odległość między dwiema ramkami klawiszy. Wartość powinna być niezerowa w zakresie [0,5, 20] sekund, określona w formacie ISO 8601. Wartość domyślna to 2 sekundy (PT2S). Należy pamiętać, że to ustawienie jest ignorowane, jeśli parametr VideoSyncMode.Passthrough jest ustawiony, gdzie wartość KeyFrameInterval będzie podążać za ustawieniem źródła danych wejściowych.

label

string

Opcjonalna etykieta koderacy. Etykieta może służyć do kontrolowania zachowania muxing.

stretchMode

StretchMode

Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize

syncMode

VideoSyncMode

Tryb synchronizacji wideo

VideoAnalyzerPreset

Ustawienie wstępne analizatora wideo, które wyodrębnia szczegółowe informacje (rozbudowane metadane) zarówno z audio, jak i wideo, i generuje plik formatu JSON.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.VideoAnalyzerPreset

Dyskryminator typów pochodnych.

audioLanguage

string

Język ładunku audio w danych wejściowych przy użyciu formatu BCP-47 "language tag-region" (np. "en-US"). Jeśli znasz język zawartości, zaleca się jej określenie. Język musi być określony jawnie dla AudioAnalysisMode::Basic, ponieważ automatyczne wykrywanie języka nie jest uwzględniane w trybie podstawowym. Jeśli język nie jest określony lub ustawiony na wartość null, automatyczne wykrywanie języka wybierze pierwszy wykryty język i przetworzy go przy użyciu wybranego języka na czas trwania pliku. Obecnie nie obsługuje dynamicznego przełączania między językami po wykryciu pierwszego języka. Automatyczne wykrywanie działa najlepiej w przypadku nagrań audio z wyraźnie rozpoznawalną mową. Jeśli automatyczne wykrywanie nie znajdzie języka, transkrypcja wróci do "en-US". Lista obsługiwanych języków jest dostępna tutaj: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

Słownik zawierający pary wartości klucza dla parametrów, które nie są widoczne w samym ustawieniu wstępnym

insightsToExtract

InsightsType

Definiuje typ szczegółowych informacji, które mają być generowane przez usługę. Dozwolone wartości to "AudioInsightsOnly", "VideoInsightsOnly" i "AllInsights". Wartość domyślna to AllInsights. Jeśli ustawisz tę opcję na wartość AllInsights, a dane wejściowe są tylko audio, generowane są tylko szczegółowe informacje o dźwięku. Podobnie, jeśli dane wejściowe są tylko wideo, generowane są tylko szczegółowe informacje wideo. Zaleca się, aby nie używać elementu AudioInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko wideo; lub użyj usługi VideoInsightsOnly, jeśli oczekujesz, że niektóre dane wejściowe będą tylko audio. Twoje zadania w takich warunkach spowodują błąd.

mode

AudioAnalysisMode

Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrana opcja Standard AudioAnalysisMode.

VideoOverlay

Opisuje właściwości nakładki wideo.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.VideoOverlay

Dyskryminujący dla typów pochodnych.

audioGainLevel

number

Poziom zysku dźwięku w nakładce. Wartość powinna znajdować się w zakresie [0, 1.0]. Wartość domyślna to 1.0.

cropRectangle

Rectangle

Opcjonalne okno prostokątne używane do przycinania obrazu nakładki lub wideo.

end

string

Położenie końcowe, z odwołaniem do wejściowego wideo, na którym kończy się nakładka. Wartość powinna być w formacie ISO 8601. Na przykład PT30S, aby zakończyć nakładkę o 30 sekund do wejściowego wideo. Jeśli nie określono wartości lub wartość jest większa niż czas trwania wejściowego wideo, nakładka zostanie zastosowana do końca wejściowego wideo, jeśli czas trwania nośników nakładki jest większy niż czas trwania wejściowego wideo, a w przeciwnym razie nakładka będzie trwać tak długo, jak nakładka czasu trwania nośnika nakładki.

fadeInDuration

string

Czas trwania, w którym nakładka zanika na wejściowym filmie wideo. Wartość powinna być w formacie czasu trwania ISO 8601. Jeśli nie określono domyślnego zachowania, nie ma zanikania (tak samo jak PT0S).

fadeOutDuration

string

Czas trwania, przez który nakładka zanika z wejściowego wideo. Wartość powinna być w formacie czasu trwania ISO 8601. Jeśli nie określono domyślnego zachowania, nie ma wynikania (tak samo jak PT0S).

inputLabel

string

Etykieta danych wejściowych zadania, które ma być używane jako nakładka. Dane wejściowe muszą określać dokładnie jeden plik. Możesz określić plik obrazu w formacie JPG, PNG, GIF lub BMP albo plik audio (taki jak plik WAV, MP3, WMA lub M4A) lub plik wideo. Zobacz https://aka.ms/mesformats pełną listę obsługiwanych formatów plików audio i wideo.

opacity

number

Nieprzezroczystość nakładki. Jest to wartość w zakresie [0 – 1.0]. Wartość domyślna to 1.0, co oznacza, że nakładka jest nieprzezroczysta.

position

Rectangle

Lokalizacja w wejściowym filmie wideo, w którym zastosowano nakładkę.

start

string

Pozycja początkowa z odwołaniem do wejściowego wideo, na którym rozpoczyna się nakładka. Wartość powinna być w formacie ISO 8601. Na przykład PT05S, aby uruchomić nakładkę o 5 sekundach w wejściowym filmie wideo. Jeśli nie określono nakładki, rozpoczyna się od początku wejściowego wideo.

VideoSyncMode

Tryb synchronizacji wideo

Nazwa Typ Opis
Auto

string

Jest to metoda domyślna. Wybiera między cfr i Vfr w zależności od możliwości muxer. W przypadku formatu danych wyjściowych MP4 tryb domyślny to Cfr.

Cfr

string

Ramki wejściowe będą powtarzane i/lub porzucane zgodnie z potrzebami, aby osiągnąć dokładnie żądaną stałą szybkość ramki. Zalecane, gdy szybkość klatek wyjściowych jest jawnie ustawiona na określoną wartość

Passthrough

string

Znaczniki czasowe prezentacji na ramkach są przekazywane z pliku wejściowego do modułu zapisywania plików wyjściowych. Zalecane, gdy źródło wejściowe ma zmienną szybkość klatek i próbuje utworzyć wiele warstw do adaptacyjnego przesyłania strumieniowego w danych wyjściowych, które mają wyrównane granice goP. Uwaga: jeśli dwie lub więcej ramek w danych wejściowych mają zduplikowane znaczniki czasu, dane wyjściowe również będą miały takie samo zachowanie

Vfr

string

Podobnie jak w trybie przekazywania, ale jeśli dane wejściowe mają zduplikowane znaczniki czasu, tylko jedna ramka zostanie przekazana do danych wyjściowych, a inne zostaną porzucone. Zalecane, gdy oczekuje się, że liczba ramek wyjściowych będzie równa liczbie ramek wejściowych. Na przykład dane wyjściowe są używane do obliczania metryki jakości, takiej jak PSNR względem danych wejściowych

VideoTrackDescriptor

Element TrackSelection do wybierania ścieżek wideo.

Nazwa Typ Opis
@odata.type string:

#Microsoft.Media.VideoTrackDescriptor

Dyskryminujący dla typów pochodnych.