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 |
---|---|---|---|---|
account
|
path | True |
string |
Nazwa konta usługi Media Services. |
job
|
path | True |
string |
Nazwa zadania. |
resource
|
path | True |
string |
Nazwa grupy zasobów w ramach subskrypcji platformy Azure. |
subscription
|
path | True |
string |
Unikatowy identyfikator subskrypcji platformy Microsoft Azure. |
transform
|
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 |
OK |
|
Other Status Codes |
Szczegółowe informacje o błędzie. |
Przykłady
Get a Job by name
Przykładowe żądanie
Przykładowa odpowiedź
{
"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 |
---|---|
Aac |
Opisuje ustawienia kodowania audio Advanced Audio Codec (AAC). |
Aac |
Profil kodowania, który ma być używany podczas kodowania dźwięku za pomocą funkcji AAC. |
Absolute |
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. |
Analysis |
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. |
Attribute |
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. |
Audio |
Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określona, zostanie wybrana opcja Standard AudioAnalysisMode. |
Audio |
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. |
Audio |
Opisuje właściwości nakładki audio. |
Audio |
Element TrackSelection do wybierania utworów audio. |
Blur |
Typ rozmycia |
Built |
Opisuje wbudowane ustawienie wstępne kodowania wejściowego wideo za pomocą kodera standardowego. |
Channel |
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. |
Copy |
Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego audio. |
Copy |
Flaga kodera, która nakazuje koderowi skopiowanie wejściowego strumienia bitowego wideo bez ponownego kodowania. |
created |
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. |
Deinterlace |
Tryb deinterlacingu. Wartość domyślna to AutoPixelAdaptive. |
Deinterlace |
Parzystość pól dla de-interlacing, domyślnie jest ustawiona na Auto. |
Encoder |
Wbudowane ustawienie wstępne, które ma być używane do kodowania filmów wideo. |
Entropy |
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. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Face |
Opisuje wszystkie ustawienia, które mają być używane podczas analizowania wideo w celu wykrycia (i opcjonalnie redagowania) wszystkich obecnych twarzy. |
Face |
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. |
From |
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. |
From |
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. |
H264Rate |
Tryb sterowania szybkością wideo |
H264Video |
Opisuje wszystkie właściwości kodowania wideo za pomocą kodera H.264. |
H264Video |
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. |
H265Video |
Obecnie obsługujemy główną. Wartość domyślna to Auto. |
Image |
Opisuje podstawowe właściwości generowania miniatur z wejściowego wideo |
Image |
Opisuje właściwości pliku obrazu wyjściowego. |
Input |
Element InputDefinition dla pojedynczego pliku. Zakres śledzenia wyborów jest określony w pliku. |
Insights |
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ę. |
Interleave |
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. |
Job |
Szczegóły błędów JobOutput. |
Job |
Pomaga w kategoryzacji błędów. |
Job |
Kod błędu opisujący błąd. |
Job |
Szczegóły błędów JobOutput. |
Job |
Reprezentuje zasób dla danych wejściowych w zadaniu. |
Job |
Reprezentuje pliki wejściowe zadania. |
Job |
Reprezentuje dane wejściowe zadania HTTPS. |
Job |
Opisuje listę danych wejściowych zadania. |
Job |
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. |
Job |
Reprezentuje zasób używany jako element JobOutput. |
Job |
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. |
Job |
Opisuje stan elementu JobOutput. |
Jpg |
Opisuje ustawienia tworzenia miniatur JPEG. |
Jpg |
Opisuje właściwości tworzenia serii obrazów JPEG z wejściowego wideo. |
Jpg |
Opisuje ustawienia służące do tworzenia obrazu JPEG z wejściowego wideo. |
Mp4Format |
Opisuje właściwości wyjściowego pliku ISO MP4. |
Multi |
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. |
Output |
Reprezentuje utworzony plik wyjściowy. |
Png |
Opisuje ustawienia tworzenia miniatur PNG. |
Png |
Opisuje właściwości tworzenia serii obrazów PNG z wejściowego wideo. |
Png |
Opisuje ustawienia służące do tworzenia obrazu PNG z wejściowego wideo. |
Preset |
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 |
Select |
Wybierz ścieżki audio z danych wejściowych, określając atrybut i filtr atrybutu. |
Select |
Wybierz ścieżki audio z danych wejściowych, określając identyfikator śledzenia. |
Select |
Wybierz ścieżki wideo z danych wejściowych, określając atrybut i filtr atrybutu. |
Select |
Wybierz ścieżki wideo z danych wejściowych, określając identyfikator śledzenia. |
Standard |
Opisuje wszystkie ustawienia, które mają być używane podczas kodowania wejściowego wideo za pomocą kodera standardowego. |
Stretch |
Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
Track |
Element TrackAttribute do filtrowania ścieżek według. |
Transport |
Opisuje właściwości generowania strumienia transportowego MPEG-2 (ISO/IEC 13818-1) wyjściowych plików wideo. |
Utc |
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. |
Video |
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. |
Video |
Opisuje właściwości nakładki wideo. |
Video |
Tryb synchronizacji wideo |
Video |
Element TrackSelection do wybierania ścieżek wideo. |
AacAudio
Opisuje ustawienia kodowania audio Advanced Audio Codec (AAC).
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
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 |
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. |
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. |
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. |
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 |
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. |
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. |
Dyskryminujący dla typów pochodnych. |
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. |
Dyskryminator typów pochodnych. |
configurations |
Opcjonalne ustawienia konfiguracji kodera. Konfiguracje są obsługiwane tylko w przypadku elementów ContentAwareEncoding i H265ContentAwareEncoding BuiltInStandardEncoderPreset. |
|
presetName |
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. |
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. |
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. |
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 |
Tryb deinterlacingu. Wartość domyślna to AutoPixelAdaptive. |
|
parity |
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 |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
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 |
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. |
Dyskryminator typów pochodnych. |
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 |
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 |
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 |
Parametry okna prostokątnego, z którym mają być przycinane wejściowe wideo. |
|
deinterlace |
Ustawienia usuwania przeplatania. |
|
fadeIn |
Opisuje właściwości efektu Zanikania zastosowanego do nośnika wejściowego. |
|
fadeOut |
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 |
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. |
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. |
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 |
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 |
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. |
Dyskryminujący dla typów pochodnych. |
complexity |
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 |
Kolekcja wyjściowych warstw H.264 do produkcji przez koder. |
|
rateControlMode |
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 |
Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize |
|
syncMode |
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 |
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. |
Dyskryminujący dla typów pochodnych. |
complexity |
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 |
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 |
Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize |
|
syncMode |
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. |
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 |
Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize |
|
syncMode |
Tryb synchronizacji wideo |
ImageFormat
Opisuje właściwości pliku obrazu wyjściowego.
Nazwa | Typ | Opis |
---|---|---|
@odata.type |
string:
#Microsoft. |
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. |
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[]: |
Dane wyjściowe zadania. |
properties.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 |
Bieżący stan zadania. |
|
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 |
Pomaga w kategoryzacji błędów. |
|
code |
Kod błędu opisujący błąd. |
|
details |
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 |
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. |
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. |
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. |
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. |
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. |
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. |
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 |
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 |
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. |
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. |
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 |
Jpg |
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 |
Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize |
|
syncMode |
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. |
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 |
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. |
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 |
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. |
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. |
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 |
Png |
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 |
Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize |
|
syncMode |
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 |
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 |
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. |
Dyskryminujący dla typów pochodnych. |
attribute |
Element TrackAttribute do filtrowania ścieżek według. |
|
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 |
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. |
Dyskryminujący dla typów pochodnych. |
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. |
Dyskryminujący dla typów pochodnych. |
attribute |
Element TrackAttribute do filtrowania ścieżek według. |
|
filter |
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. |
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. |
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 |
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 |
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 |
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. |
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 |
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. |
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. |
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 |
Tryb zmiany rozmiaru — zmiana rozmiaru wejściowego wideo w celu dopasowania do żądanych rozdzielczości wyjściowych. Wartość domyślna to AutoSize |
|
syncMode |
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. |
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 |
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 |
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. |
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 |
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 |
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. |
Dyskryminujący dla typów pochodnych. |