Transforms - Create Or Update
Membuat atau Memperbarui Transformasi
Membuat atau memperbarui Transformasi baru.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}?api-version=2022-07-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
account
|
path | True |
string |
Nama akun Media Services. |
resource
|
path | True |
string |
Nama grup sumber daya dalam langganan Azure. |
subscription
|
path | True |
string |
Pengidentifikasi unik untuk langganan Microsoft Azure. |
transform
|
path | True |
string |
Nama Transformasi. |
api-version
|
query | True |
string |
Versi API yang akan digunakan dengan permintaan klien. |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
properties.outputs | True |
Array dari satu atau beberapa TransformOutput yang harus dihasilkan transformasi. |
|
properties.description |
string |
Deskripsi verbose opsional dari Transformasi. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK |
|
201 Created |
Dibuat |
|
Other Status Codes |
Informasi kesalahan terperinci. |
Contoh
Create or update a Transform
Permintaan sampel
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/createdTransform?api-version=2022-07-01
{
"properties": {
"description": "Example Transform to illustrate create and update.",
"outputs": [
{
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
}
}
Respon sampel
{
"name": "createdTransform",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:31.7664818Z",
"description": "Example Transform to illustrate create and update.",
"lastModified": "2022-10-17T23:14:31.7664818Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "Normal",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:31.7664818Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
}
}
{
"name": "createdTransform",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:31.7664818Z",
"description": "Example Transform to illustrate create and update.",
"lastModified": "2022-10-17T23:14:31.7664818Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "Normal",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:31.7664818Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
}
}
Definisi
Nama | Deskripsi |
---|---|
Aac |
Menjelaskan pengaturan pengodean audio Advanced Audio Codec (AAC). |
Aac |
Profil pengodean yang akan digunakan saat mengodekan audio dengan AAC. |
Analysis |
Menentukan resolusi maksimum di mana video Anda dianalisis. Perilaku default adalah "SourceResolution," yang akan menyimpan video input pada resolusi aslinya saat dianalisis. Menggunakan "StandardDefinition" akan mengubah ukuran video input ke definisi standar sambil mempertahankan rasio aspek yang sesuai. Ini hanya akan mengubah ukuran jika video memiliki resolusi yang lebih tinggi. Misalnya, input 1920x1080 akan diskalakan ke 640x360 sebelum diproses. Beralih ke "StandardDefinition" akan mengurangi waktu yang diperlukan untuk memproses video resolusi tinggi. Ini juga dapat mengurangi biaya penggunaan komponen ini (lihat https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics untuk detailnya). Namun, wajah yang akhirnya terlalu kecil dalam video yang diubah ukurannya mungkin tidak terdeteksi. |
Audio |
Menentukan properti umum untuk semua codec audio. |
Audio |
Menentukan serangkaian operasi analisis audio yang akan dilakukan. Jika tidak ditentukan, AudioAnalysisMode Standar akan dipilih. |
Audio |
Preset Audio Analyzer menerapkan serangkaian operasi analisis berbasis AI yang telah ditentukan sebelumnya, termasuk transkripsi ucapan. Saat ini, preset mendukung pemrosesan konten dengan satu trek audio. |
Audio |
Menjelaskan properti overlay audio. |
Blur |
Jenis kabur |
Built |
Menjelaskan preset bawaan untuk mengodekan video input dengan Encoder Standar. |
Complexity |
Memungkinkan Anda mengonfigurasi pengaturan encoder untuk mengontrol keseimbangan antara kecepatan dan kualitas. Contoh: atur Kompleksitas sebagai Kecepatan untuk pengodean yang lebih cepat tetapi efisiensi kompresi yang lebih sedikit. |
Copy |
Bendera codec, yang memberi tahu encoder untuk menyalin bitstream audio input. |
Copy |
Bendera codec, yang memberi tahu encoder untuk menyalin bitstream video input tanpa pengodean ulang. |
created |
Jenis identitas yang membuat sumber daya. |
DDAudio |
Menjelaskan pengaturan pengodean audio Dolby Digital Audio Codec (AC3). Implementasi saat ini untuk dukungan Dolby Digital Audio adalah: Nomor saluran audio pada 1((mono), 2(stereo), 6(5.1side); Laju frekuensi pengambilan sampel audio pada: 32K/44,1K/48K Hz; Nilai laju bit audio sebagai spesifikasi AC3 mendukung: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps. |
Deinterlace |
Menjelaskan pengaturan de-interlacing. |
Deinterlace |
Mode deinterlacing. Default ke AutoPixelAdaptive. |
Deinterlace |
Paritas bidang untuk de-interlacing, default ke Otomatis. |
Encoder |
Preset bawaan yang akan digunakan untuk mengodekan video. |
Entropy |
Mode entropi yang akan digunakan untuk lapisan ini. Jika tidak ditentukan, encoder memilih mode yang sesuai untuk profil dan tingkat. |
Error |
Info tambahan kesalahan manajemen sumber daya. |
Error |
Detail kesalahan. |
Error |
Respons kesalahan |
Face |
Menjelaskan semua pengaturan yang akan digunakan saat menganalisis video untuk mendeteksi (dan secara opsional meredaksi) semua wajah yang ada. |
Face |
Mode ini menyediakan kemampuan untuk memilih antara pengaturan berikut: 1) Analisis - Hanya untuk deteksi. Mode ini menghasilkan file JSON metadata yang menandai penampilan wajah di seluruh video. Jika memungkinkan, penampilan orang yang sama diberi ID yang sama. 2) Gabungan - Selain redaksi (kabur) wajah yang terdeteksi. 3) Redaksi - Ini memungkinkan proses 2-pass, memungkinkan redaksi selektif dari subset wajah yang terdeteksi. Dibutuhkan file metadata dari pass analisis sebelumnya, bersama dengan video sumber, dan subset ID yang dipilih pengguna yang memerlukan redaksi. |
Fade |
Menjelaskan properti efek Fade yang diterapkan ke media input. |
Filters |
Menjelaskan semua operasi pemfilteran, seperti de-interlacing, rotasi, dll. yang akan diterapkan ke media input sebelum pengodean. |
H264Complexity |
Memberi tahu encoder cara memilih pengaturan pengodeannya. Nilai defaultnya adalah Seimbang. |
H264Layer |
Menjelaskan pengaturan yang akan digunakan saat mengodekan video input ke dalam lapisan laju bit output yang diinginkan dengan codec video H.264. |
H264Rate |
Mode kontrol laju video |
H264Video |
Menjelaskan semua properti untuk mengodekan video dengan codec H.264. |
H264Video |
Saat ini kami mendukung Baseline, Main, High, High422, High444. Defaultnya adalah Otomatis. |
H265Complexity |
Memberi tahu encoder cara memilih pengaturan pengodeannya. Kualitas akan memberikan rasio kompresi yang lebih tinggi tetapi dengan biaya yang lebih tinggi dan waktu komputasi yang lebih lama. Kecepatan akan menghasilkan file yang relatif lebih besar tetapi lebih cepat dan lebih ekonomis. Nilai defaultnya adalah Seimbang. |
H265Layer |
Menjelaskan pengaturan yang akan digunakan saat mengodekan video input ke dalam lapisan laju bit output yang diinginkan dengan codec video H.265. |
H265Video |
Menjelaskan semua properti untuk mengodekan video dengan codec H.265. |
H265Video |
Saat ini kami mendukung Utama. Defaultnya adalah Otomatis. |
Image |
Menjelaskan properti dasar untuk menghasilkan gambar mini dari video input |
Image |
Menjelaskan properti untuk file gambar output. |
Insights |
Menentukan jenis wawasan yang Anda inginkan untuk dihasilkan oleh layanan. Nilai yang diizinkan adalah 'AudioInsightsOnly', 'VideoInsightsOnly', dan 'AllInsights'. Defaultnya adalah AllInsights. Jika Anda mengatur ini ke AllInsights dan input hanya audio, maka hanya wawasan audio yang dihasilkan. Demikian pula jika input hanya video, maka hanya wawasan video yang dihasilkan. Disarankan agar Anda tidak menggunakan AudioInsightsOnly jika Anda mengharapkan beberapa input Anda menjadi video saja; atau gunakan VideoInsightsOnly jika Anda mengharapkan beberapa input Anda menjadi audio saja. Pekerjaan Anda dalam kondisi seperti itu akan bermasalah. |
Interleave |
Mengatur mode interleave output untuk mengontrol bagaimana audio dan video disimpan dalam format kontainer. Contoh: atur InterleavedOutput sebagai NonInterleavedOutput untuk menghasilkan output audio saja dan video saja dalam file MP4 terpisah. |
Jpg |
Menjelaskan pengaturan untuk menghasilkan gambar mini JPEG. |
Jpg |
Menjelaskan properti untuk menghasilkan serangkaian gambar JPEG dari video input. |
Jpg |
Menjelaskan pengaturan untuk menghasilkan gambar JPEG dari video input. |
Mp4Format |
Menjelaskan properti untuk file ISO MP4 output. |
Multi |
Menjelaskan properti untuk menghasilkan koleksi file multi-laju bit yang selaras dengan GOP. Perilaku default adalah menghasilkan satu file output untuk setiap lapisan video yang di-mux bersama dengan semua audio. File output yang tepat yang dihasilkan dapat dikontrol dengan menentukan koleksi outputFiles. |
On |
Transformasi dapat menentukan lebih dari satu output. Properti ini menentukan apa yang harus dilakukan layanan ketika satu output gagal - baik terus menghasilkan output lain, atau, menghentikan output lainnya. Status Pekerjaan keseluruhan tidak akan mencerminkan kegagalan output yang ditentukan dengan 'ContinueJob'. Defaultnya adalah 'StopProcessingJob'. |
Output |
Mewakili file output yang dihasilkan. |
Png |
Menjelaskan pengaturan untuk menghasilkan gambar mini PNG. |
Png |
Menjelaskan properti untuk menghasilkan serangkaian gambar PNG dari video input. |
Png |
Menjelaskan pengaturan untuk menghasilkan gambar PNG dari video input. |
Preset |
Objek pengaturan konfigurasi opsional untuk encoder. |
Priority |
Mengatur prioritas relatif TransformOutputs dalam Transformasi. Ini menetapkan prioritas yang digunakan layanan untuk memproses TransformOutputs. Prioritas defaultnya adalah Normal. |
Rectangle |
Menjelaskan properti jendela persegi panjang yang diterapkan ke media input sebelum memprosesnya. |
Rotation |
Rotasi, jika ada, untuk diterapkan ke video input, sebelum dikodekan. Defaultnya adalah Otomatis |
Standard |
Menjelaskan semua pengaturan yang akan digunakan saat mengodekan video input dengan Encoder Standar. |
Stretch |
Mode pengubahan ukuran - bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah AutoSize |
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
Transform |
Transformasi merangkum aturan atau instruksi untuk menghasilkan output yang diinginkan dari media input, seperti dengan transcoding atau dengan mengekstrak wawasan. Setelah Transformasi dibuat, transformasi dapat diterapkan ke media input dengan membuat Pekerjaan. |
Transform |
Menjelaskan properti TransformOutput, yang merupakan aturan yang akan diterapkan sambil menghasilkan output yang diinginkan. |
Transport |
Menjelaskan properti untuk menghasilkan file video output MPEG-2 Transport Stream (ISO/IEC 13818-1). |
Video |
Menjelaskan properti dasar untuk mengodekan video input. |
Video |
Preset penganalisis video yang mengekstrak wawasan (metadata kaya) dari audio dan video, dan menghasilkan file format JSON. |
Video |
Menjelaskan properti overlay video. |
Video |
Mode Sinkronisasi Video |
AacAudio
Menjelaskan pengaturan pengodean audio Advanced Audio Codec (AAC).
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
bitrate |
integer |
Laju bit, dalam bit per detik, dari audio yang dikodekan output. |
channels |
integer |
Jumlah saluran dalam audio. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
profile |
Profil pengodean yang akan digunakan saat mengodekan audio dengan AAC. |
|
samplingRate |
integer |
Laju pengambilan sampel yang digunakan untuk pengodean di hertz. |
AacAudioProfile
Profil pengodean yang akan digunakan saat mengodekan audio dengan AAC.
Nama | Jenis | Deskripsi |
---|---|---|
AacLc |
string |
Menentukan bahwa audio output akan dikodekan ke dalam profil AAC Low Complexity (AAC-LC). |
HeAacV1 |
string |
Menentukan bahwa audio output akan dikodekan ke dalam profil HE-AAC v1. |
HeAacV2 |
string |
Menentukan bahwa audio output akan dikodekan ke dalam profil HE-AAC v2. |
AnalysisResolution
Menentukan resolusi maksimum di mana video Anda dianalisis. Perilaku default adalah "SourceResolution," yang akan menyimpan video input pada resolusi aslinya saat dianalisis. Menggunakan "StandardDefinition" akan mengubah ukuran video input ke definisi standar sambil mempertahankan rasio aspek yang sesuai. Ini hanya akan mengubah ukuran jika video memiliki resolusi yang lebih tinggi. Misalnya, input 1920x1080 akan diskalakan ke 640x360 sebelum diproses. Beralih ke "StandardDefinition" akan mengurangi waktu yang diperlukan untuk memproses video resolusi tinggi. Ini juga dapat mengurangi biaya penggunaan komponen ini (lihat https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics untuk detailnya). Namun, wajah yang akhirnya terlalu kecil dalam video yang diubah ukurannya mungkin tidak terdeteksi.
Nama | Jenis | Deskripsi |
---|---|---|
SourceResolution |
string |
|
StandardDefinition |
string |
Audio
Menentukan properti umum untuk semua codec audio.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
bitrate |
integer |
Laju bit, dalam bit per detik, dari audio yang dikodekan output. |
channels |
integer |
Jumlah saluran dalam audio. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
samplingRate |
integer |
Laju pengambilan sampel yang digunakan untuk pengodean di hertz. |
AudioAnalysisMode
Menentukan serangkaian operasi analisis audio yang akan dilakukan. Jika tidak ditentukan, AudioAnalysisMode Standar akan dipilih.
Nama | Jenis | Deskripsi |
---|---|---|
Basic |
string |
Mode ini melakukan transkripsi ucapan ke teks dan pembuatan file subtitel/keterangan tertutup VTT. Output mode ini mencakup file Insights JSON termasuk hanya kata kunci, transkripsi, dan informasi waktu. Deteksi bahasa otomatis dan diarisasi pengeras suara tidak disertakan dalam mode ini. |
Standard |
string |
Melakukan semua operasi yang disertakan dalam mode Dasar, selain melakukan deteksi bahasa dan diarisasi pembicara. |
AudioAnalyzerPreset
Preset Audio Analyzer menerapkan serangkaian operasi analisis berbasis AI yang telah ditentukan sebelumnya, termasuk transkripsi ucapan. Saat ini, preset mendukung pemrosesan konten dengan satu trek audio.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
audioLanguage |
string |
Bahasa untuk payload audio dalam input menggunakan format BCP-47 dari 'language tag-region' (misalnya: 'en-US'). Jika Anda mengetahui bahasa konten Anda, disarankan agar Anda menentukannya. Bahasa harus ditentukan secara eksplisit untuk AudioAnalysisMode::Basic, karena deteksi bahasa otomatis tidak disertakan dalam mode dasar. Jika bahasa tidak ditentukan atau diatur ke null, deteksi bahasa otomatis akan memilih bahasa pertama yang terdeteksi dan diproses dengan bahasa yang dipilih selama durasi file. Saat ini tidak mendukung peralihan dinamis antar bahasa setelah bahasa pertama terdeteksi. Deteksi otomatis bekerja paling baik dengan rekaman audio dengan ucapan yang jelas jelas. Jika deteksi otomatis gagal menemukan bahasa, transkripsi akan kembali ke 'en-US'." Daftar bahasa yang didukung tersedia di sini: https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
Kamus yang berisi pasangan nilai kunci untuk parameter yang tidak diekspos dalam preset itu sendiri |
mode |
Menentukan serangkaian operasi analisis audio yang akan dilakukan. Jika tidak ditentukan, AudioAnalysisMode Standar akan dipilih. |
AudioOverlay
Menjelaskan properti overlay audio.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
audioGainLevel |
number |
Tingkat perolehan audio dalam overlay. Nilai harus dalam rentang [0, 1.0]. Defaultnya adalah 1.0. |
end |
string |
Posisi akhir, dengan referensi ke video input, di mana overlay berakhir. Nilai harus dalam format ISO 8601. Misalnya, PT30S untuk mengakhiri overlay pada 30 detik ke dalam video input. Jika tidak ditentukan atau nilai lebih besar dari durasi video input, overlay akan diterapkan hingga akhir video input jika durasi media overlay lebih besar dari durasi video input, jika tidak, overlay akan berlangsung selama durasi media overlay. |
fadeInDuration |
string |
Durasi di mana overlay memudar ke video input. Nilai harus dalam format durasi ISO 8601. Jika tidak ditentukan, perilaku defaultnya adalah tidak memudar (sama seperti PT0S). |
fadeOutDuration |
string |
Durasi di mana overlay memudar dari video input. Nilai harus dalam format durasi ISO 8601. Jika tidak ditentukan, perilaku defaultnya adalah tidak akan memudar (sama seperti PT0S). |
inputLabel |
string |
Label input pekerjaan yang akan digunakan sebagai overlay. Input harus menentukan tepat satu file. Anda dapat menentukan file gambar dalam format JPG, PNG, GIF atau BMP, atau file audio (seperti WAV, MP3, WMA atau M4A), atau file video. Lihat https://aka.ms/mesformats untuk daftar lengkap format file audio dan video yang didukung. |
start |
string |
Posisi awal, dengan referensi ke video input, di mana overlay dimulai. Nilai harus dalam format ISO 8601. Misalnya, PT05S untuk memulai overlay pada 5 detik ke dalam video input. Jika tidak ditentukan, overlay dimulai dari awal video input. |
BlurType
Jenis kabur
Nama | Jenis | Deskripsi |
---|---|---|
Black |
string |
Hitam: Filter pingsan |
Box |
string |
Kotak: filter debug, kotak pembatas saja |
High |
string |
Tinggi: Membingungkan filter kabur |
Low |
string |
Rendah: filter kabur mobil kotak |
Med |
string |
Med: Filter kabur Gaussian |
BuiltInStandardEncoderPreset
Menjelaskan preset bawaan untuk mengodekan video input dengan Encoder Standar.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
configurations |
Pengaturan konfigurasi opsional untuk encoder. Konfigurasi hanya didukung untuk ContentAwareEncoding dan H265ContentAwareEncoding BuiltInStandardEncoderPreset. |
|
presetName |
Preset bawaan yang akan digunakan untuk mengodekan video. |
Complexity
Memungkinkan Anda mengonfigurasi pengaturan encoder untuk mengontrol keseimbangan antara kecepatan dan kualitas. Contoh: atur Kompleksitas sebagai Kecepatan untuk pengodean yang lebih cepat tetapi efisiensi kompresi yang lebih sedikit.
Nama | Jenis | Deskripsi |
---|---|---|
Balanced |
string |
Mengonfigurasi encoder untuk menggunakan pengaturan yang mencapai keseimbangan antara kecepatan dan kualitas. |
Quality |
string |
Mengonfigurasi encoder untuk menggunakan pengaturan yang dioptimalkan untuk menghasilkan output berkualitas lebih tinggi dengan mengorbankan waktu pengodean keseluruhan yang lebih lambat. |
Speed |
string |
Mengonfigurasi encoder untuk menggunakan pengaturan yang dioptimalkan untuk pengodean yang lebih cepat. Kualitas dikorbankan untuk mengurangi waktu pengodean. |
CopyAudio
Bendera codec, yang memberi tahu encoder untuk menyalin bitstream audio input.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
CopyVideo
Bendera codec, yang memberi tahu encoder untuk menyalin bitstream video input tanpa pengodean ulang.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
createdByType
Jenis identitas yang membuat sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DDAudio
Menjelaskan pengaturan pengodean audio Dolby Digital Audio Codec (AC3). Implementasi saat ini untuk dukungan Dolby Digital Audio adalah: Nomor saluran audio pada 1((mono), 2(stereo), 6(5.1side); Laju frekuensi pengambilan sampel audio pada: 32K/44,1K/48K Hz; Nilai laju bit audio sebagai spesifikasi AC3 mendukung: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
bitrate |
integer |
Laju bit, dalam bit per detik, dari audio yang dikodekan output. |
channels |
integer |
Jumlah saluran dalam audio. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
samplingRate |
integer |
Laju pengambilan sampel yang digunakan untuk pengodean di hertz. |
Deinterlace
Menjelaskan pengaturan de-interlacing.
Nama | Jenis | Deskripsi |
---|---|---|
mode |
Mode deinterlacing. Default ke AutoPixelAdaptive. |
|
parity |
Paritas bidang untuk de-interlacing, default ke Otomatis. |
DeinterlaceMode
Mode deinterlacing. Default ke AutoPixelAdaptive.
Nama | Jenis | Deskripsi |
---|---|---|
AutoPixelAdaptive |
string |
Terapkan de-interlacing adaptif piksel otomatis pada setiap bingkai dalam video input. |
Off |
string |
Menonaktifkan de-interlacing video sumber. |
DeinterlaceParity
Paritas bidang untuk de-interlacing, default ke Otomatis.
Nama | Jenis | Deskripsi |
---|---|---|
Auto |
string |
Mendeteksi urutan bidang secara otomatis |
BottomFieldFirst |
string |
Terapkan pemrosesan pertama bidang bawah video input. |
TopFieldFirst |
string |
Terapkan pemrosesan pertama bidang atas video input. |
EncoderNamedPreset
Preset bawaan yang akan digunakan untuk mengodekan video.
Nama | Jenis | Deskripsi |
---|---|---|
AACGoodQualityAudio |
string |
Menghasilkan satu file MP4 yang hanya berisi audio stereo AAC yang dikodekan pada 192 kbps. |
AdaptiveStreaming |
string |
Menghasilkan satu set file MP4 selaras GOP dengan video H.264 dan audio AAC stereo. Menghasilkan tangga laju bit secara otomatis berdasarkan resolusi input, laju bit, dan kecepatan bingkai. Preset yang dibuat secara otomatis tidak akan pernah melebihi resolusi input. Contohnya, jika input adalah 720p, output akan tetap 720p. |
ContentAwareEncoding |
string |
Menghasilkan satu set MP4 yang selaras dengan GOP dengan menggunakan pengkodean yang dasar akan konten. Mengingat konten input apa pun, layanan melakukan analisis ringan awal dari konten input, dan menggunakan hasil untuk menentukan jumlah lapisan yang optimal, laju bit yang sesuai dan pengaturan resolusi untuk pengiriman dengan streaming adaptif. Preset ini sangat efektif untuk video kompleksitas rendah dan menengah, di mana file output akan berada pada laju bit yang lebih rendah tetapi dengan kualitas yang masih menyampaikan pengalaman yang baik kepada pemirsa. Output akan berisi file MP4 dengan video dan audio yang saling terkait. |
ContentAwareEncodingExperimental |
string |
Mengekspos preset eksperimental untuk pengodean sadar konten. Mengingat konten input apa pun, layanan mencoba untuk secara otomatis menentukan jumlah lapisan yang optimal, pengaturan laju bit dan resolusi yang sesuai untuk pengiriman dengan streaming adaptif. Algoritma yang mendasarinya akan terus berkembang dari waktu ke waktu. Output akan berisi file MP4 dengan video dan audio yang saling terkait. |
CopyAllBitrateNonInterleaved |
string |
Salin semua aliran video dan audio dari aset input sebagai file output video dan audio yang tidak disisipkan. Preset ini dapat digunakan untuk memotong aset yang ada atau mengonversi sekelompok file MP4 yang selaras dengan bingkai kunci (GOP) sebagai aset yang dapat dialirkan. |
DDGoodQualityAudio |
string |
Menghasilkan satu file MP4 yang hanya berisi audio stereo DD(Digital Dolby) yang dikodekan pada 192 kbps. |
H264MultipleBitrate1080p |
string |
Menghasilkan satu set 8 file MP4 yang selaras dengan GOP, mulai dari 6000 kbps hingga 400 kbps, dan audio AAC stereo. Resolusi dimulai pada 1080p dan turun ke 180p. |
H264MultipleBitrate720p |
string |
Menghasilkan satu set 6 file MP4 yang selaras dengan GOP, mulai dari 3400 kbps hingga 400 kbps, dan audio AAC stereo. Resolusi dimulai pada 720p dan turun ke 180p. |
H264MultipleBitrateSD |
string |
Menghasilkan satu set 5 file MP4 yang selaras dengan GOP, mulai dari 1900kbps hingga 400 kbps, dan audio AAC stereo. Resolusi dimulai pada 480p dan turun ke 240p. |
H264SingleBitrate1080p |
string |
Menghasilkan file MP4 di mana video dikodekan dengan kodek H.264 pada 6750 kbps dan tinggi gambar 1080 piksel, dan audio stereo dikodekan dengan codec AAC-LC pada 128 kbps. |
H264SingleBitrate720p |
string |
Menghasilkan file MP4 di mana video dikodekan dengan codec H.264 pada 4500 kbps dan tinggi gambar 720 piksel, dan audio stereo dikodekan dengan codec AAC-LC pada 128 kbps. |
H264SingleBitrateSD |
string |
Menghasilkan file MP4 di mana video dikodekan dengan kodek H.264 pada 2200 kbps dan tinggi gambar 480 piksel, dan audio stereo dikodekan dengan codec AAC-LC pada 128 kbps. |
H265AdaptiveStreaming |
string |
Menghasilkan satu set file MP4 selaras GOP dengan video H.265 dan audio AAC stereo. Menghasilkan tangga laju bit secara otomatis berdasarkan resolusi input, laju bit, dan kecepatan bingkai. Preset yang dibuat secara otomatis tidak akan pernah melebihi resolusi input. Contohnya, jika input adalah 720p, output akan tetap 720p. |
H265ContentAwareEncoding |
string |
Menghasilkan satu set MP4 yang selaras dengan GOP dengan menggunakan pengkodean yang dasar akan konten. Mengingat konten input apa pun, layanan melakukan analisis ringan awal dari konten input, dan menggunakan hasil untuk menentukan jumlah lapisan yang optimal, laju bit yang sesuai dan pengaturan resolusi untuk pengiriman dengan streaming adaptif. Preset ini sangat efektif untuk video kompleksitas rendah dan menengah, di mana file output akan berada pada laju bit yang lebih rendah tetapi dengan kualitas yang masih menyampaikan pengalaman yang baik kepada pemirsa. Output akan berisi file MP4 dengan video dan audio yang saling terkait. |
H265SingleBitrate1080p |
string |
Menghasilkan file MP4 di mana video dikodekan dengan codec H.265 pada 3500 kbps dan tinggi gambar 1080 piksel, dan audio stereo dikodekan dengan codec AAC-LC pada 128 kbps. |
H265SingleBitrate4K |
string |
Menghasilkan file MP4 di mana video dikodekan dengan kodek H.265 pada 9500 kbps dan tinggi gambar 2160 piksel, dan audio stereo dikodekan dengan codec AAC-LC pada 128 kbps. |
H265SingleBitrate720p |
string |
Menghasilkan file MP4 di mana video dikodekan dengan codec H.265 pada 1800 kbps dan tinggi gambar 720 piksel, dan audio stereo dikodekan dengan codec AAC-LC pada 128 kbps. |
EntropyMode
Mode entropi yang akan digunakan untuk lapisan ini. Jika tidak ditentukan, encoder memilih mode yang sesuai untuk profil dan tingkat.
Nama | Jenis | Deskripsi |
---|---|---|
Cabac |
string |
Pengodean entropi Context Adaptive Binary Arithmetic Coder (CABAC). |
Cavlc |
string |
Pengodean entropi Context Adaptive Variable Length Coder (CAVLC). |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
info |
object |
Info tambahan. |
type |
string |
Jenis info tambahan. |
ErrorDetail
Detail kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
additionalInfo |
Info tambahan kesalahan. |
|
code |
string |
Kode kesalahan. |
details |
Detail kesalahan. |
|
message |
string |
Pesan kesalahan. |
target |
string |
Target kesalahan. |
ErrorResponse
Respons kesalahan
Nama | Jenis | Deskripsi |
---|---|---|
error |
Objek kesalahan. |
FaceDetectorPreset
Menjelaskan semua pengaturan yang akan digunakan saat menganalisis video untuk mendeteksi (dan secara opsional meredaksi) semua wajah yang ada.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
blurType |
Jenis kabur |
|
experimentalOptions |
object |
Kamus yang berisi pasangan nilai kunci untuk parameter yang tidak diekspos dalam preset itu sendiri |
mode |
Mode ini menyediakan kemampuan untuk memilih antara pengaturan berikut: 1) Analisis - Hanya untuk deteksi. Mode ini menghasilkan file JSON metadata yang menandai penampilan wajah di seluruh video. Jika memungkinkan, penampilan orang yang sama diberi ID yang sama. 2) Gabungan - Selain redaksi (kabur) wajah yang terdeteksi. 3) Redaksi - Ini memungkinkan proses 2-pass, memungkinkan redaksi selektif dari subset wajah yang terdeteksi. Dibutuhkan file metadata dari pass analisis sebelumnya, bersama dengan video sumber, dan subset ID yang dipilih pengguna yang memerlukan redaksi. |
|
resolution |
Menentukan resolusi maksimum di mana video Anda dianalisis. Perilaku default adalah "SourceResolution," yang akan menyimpan video input pada resolusi aslinya saat dianalisis. Menggunakan "StandardDefinition" akan mengubah ukuran video input ke definisi standar sambil mempertahankan rasio aspek yang sesuai. Ini hanya akan mengubah ukuran jika video memiliki resolusi yang lebih tinggi. Misalnya, input 1920x1080 akan diskalakan ke 640x360 sebelum diproses. Beralih ke "StandardDefinition" akan mengurangi waktu yang diperlukan untuk memproses video resolusi tinggi. Ini juga dapat mengurangi biaya penggunaan komponen ini (lihat https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics untuk detailnya). Namun, wajah yang akhirnya terlalu kecil dalam video yang diubah ukurannya mungkin tidak terdeteksi. |
FaceRedactorMode
Mode ini menyediakan kemampuan untuk memilih antara pengaturan berikut: 1) Analisis - Hanya untuk deteksi. Mode ini menghasilkan file JSON metadata yang menandai penampilan wajah di seluruh video. Jika memungkinkan, penampilan orang yang sama diberi ID yang sama. 2) Gabungan - Selain redaksi (kabur) wajah yang terdeteksi. 3) Redaksi - Ini memungkinkan proses 2-pass, memungkinkan redaksi selektif dari subset wajah yang terdeteksi. Dibutuhkan file metadata dari pass analisis sebelumnya, bersama dengan video sumber, dan subset ID yang dipilih pengguna yang memerlukan redaksi.
Nama | Jenis | Deskripsi |
---|---|---|
Analyze |
string |
Mode analisis mendeteksi wajah dan menghasilkan file metadata dengan hasilnya. Memungkinkan pengeditan file metadata sebelum wajah dikaburkan dengan mode Redaksi. |
Combined |
string |
Mode gabungan melakukan langkah Analisis dan Redaksi dalam satu pass saat mengedit wajah yang dianalisis tidak diinginkan. |
Redact |
string |
Mode redaksi menggunakan file metadata dari mode Analisis dan meredaksi wajah yang ditemukan. |
Fade
Menjelaskan properti efek Fade yang diterapkan ke media input.
Nama | Jenis | Deskripsi |
---|---|---|
duration |
string |
Durasi efek memudar dalam video. Nilainya dapat dalam format ISO 8601 (Misalnya, PT05S untuk memudarkan warna Masuk/Keluar selama 5 detik), atau jumlah bingkai (Misalnya, 10 untuk memudarkan 10 bingkai dari waktu mulai), atau nilai relatif terhadap durasi streaming (Misalnya, 10% untuk memudar 10% dari durasi streaming) |
fadeColor |
string |
Warna untuk Memudar Masuk/Keluar. bisa pada warna https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords CSS Level1 atau nilai RGB/hex: misalnya: rgb(255,0,0), 0xFF0000 atau #FF0000 |
start |
string |
Posisi dalam video input dari mana harus mulai memudar. Nilainya dapat dalam format ISO 8601 (Misalnya, PT05S untuk memulai pada 5 detik), atau jumlah bingkai (Misalnya, 10 untuk memulai pada bingkai ke-10), atau nilai relatif terhadap durasi stream (Misalnya, 10% untuk memulai 10% dari durasi stream). Defaultnya adalah 0 |
Filters
Menjelaskan semua operasi pemfilteran, seperti de-interlacing, rotasi, dll. yang akan diterapkan ke media input sebelum pengodean.
Nama | Jenis | Deskripsi |
---|---|---|
crop |
Parameter untuk jendela persegi panjang untuk memangkas video input. |
|
deinterlace |
Pengaturan de-interlacing. |
|
fadeIn |
Menjelaskan properti efek Pudar yang diterapkan ke media input. |
|
fadeOut |
Menjelaskan properti efek Pudar yang diterapkan ke media input. |
|
overlays | Overlay[]: |
Properti overlay yang akan diterapkan ke video input. Ini bisa berupa overlay audio, gambar, atau video. |
rotation |
Rotasi, jika ada, untuk diterapkan ke video input, sebelum dikodekan. Defaultnya adalah Otomatis |
H264Complexity
Memberi tahu encoder cara memilih pengaturan pengodeannya. Nilai defaultnya adalah Seimbang.
Nama | Jenis | Deskripsi |
---|---|---|
Balanced |
string |
Memberi tahu encoder untuk menggunakan pengaturan yang mencapai keseimbangan antara kecepatan dan kualitas. |
Quality |
string |
Memberi tahu encoder untuk menggunakan pengaturan yang dioptimalkan untuk menghasilkan output berkualitas lebih tinggi dengan mengorbankan waktu pengodean keseluruhan yang lebih lambat. |
Speed |
string |
Memberi tahu encoder untuk menggunakan pengaturan yang dioptimalkan untuk pengodean yang lebih cepat. Kualitas dikorbankan untuk mengurangi waktu pengodean. |
H264Layer
Menjelaskan pengaturan yang akan digunakan saat mengodekan video input ke dalam lapisan laju bit output yang diinginkan dengan codec video H.264.
Nama | Jenis | Deskripsi |
---|---|---|
adaptiveBFrame |
boolean |
Apakah bingkai B adaptif akan digunakan saat mengodekan lapisan ini atau tidak. Jika tidak ditentukan, encoder akan mengaktifkannya setiap kali profil video mengizinkan penggunaannya. |
bFrames |
integer |
Jumlah bingkai B yang akan digunakan saat mengodekan lapisan ini. Jika tidak ditentukan, encoder memilih nomor yang sesuai berdasarkan profil dan tingkat video. |
bitrate |
integer |
Laju bit rata-rata dalam bit per detik untuk mengodekan video input saat menghasilkan lapisan ini. Ini adalah bidang yang harus diisi. |
bufferWindow |
string |
Panjang jendela buffer VBV. Nilai harus dalam format ISO 8601. Nilai harus dalam rentang [0,1-100] detik. Defaultnya adalah 5 detik (misalnya, PT5S). |
crf |
number |
Nilai CRF yang akan digunakan saat mengodekan lapisan ini. Pengaturan ini berlaku ketika RateControlMode codec video diatur pada mode CRF. Rentang nilai CRF adalah antara 0 dan 51, di mana nilai yang lebih rendah akan menghasilkan kualitas yang lebih baik, dengan mengorbankan ukuran file yang lebih tinggi. Nilai yang lebih tinggi berarti lebih banyak kompresi, tetapi pada beberapa titik penurunan kualitas akan diperhatikan. Nilai defaultnya adalah 23. |
entropyMode |
Mode entropi yang akan digunakan untuk lapisan ini. Jika tidak ditentukan, encoder memilih mode yang sesuai untuk profil dan tingkat. |
|
frameRate |
string |
Kecepatan bingkai (dalam bingkai per detik) untuk mengodekan lapisan ini. Nilainya dapat dalam bentuk M/N di mana M dan N adalah bilangan bulat (Misalnya, 30000/1001), atau dalam bentuk angka (Misalnya, 30, atau 29,97). Encoder memberlakukan batasan pada kecepatan bingkai yang diizinkan berdasarkan profil dan tingkat. Jika tidak ditentukan, encoder akan menggunakan kecepatan bingkai yang sama dengan video input. |
height |
string |
Tinggi video output untuk lapisan ini. Nilainya bisa absolut (dalam piksel) atau relatif (dalam persentase). Misalnya 50% berarti video output memiliki tinggi setengah piksel sebanyak input. |
label |
string |
Label alfanumerik untuk lapisan ini, yang dapat digunakan dalam multipleks lapisan video dan audio yang berbeda, atau dalam penamaan file output. |
level |
string |
Saat ini kami mendukung Level hingga 6.2. Nilainya bisa Otomatis, atau angka yang cocok dengan profil H.264. Jika tidak ditentukan, defaultnya adalah Otomatis, yang memungkinkan encoder memilih Tingkat yang sesuai untuk lapisan ini. |
maxBitrate |
integer |
Laju bit maksimum (dalam bit per detik), di mana buffer VBV harus diasumsikan untuk mengisi ulang. Jika tidak ditentukan, default ke nilai yang sama dengan laju bit. |
profile |
Saat ini kami mendukung Baseline, Main, High, High422, High444. Defaultnya adalah Otomatis. |
|
referenceFrames |
integer |
Jumlah bingkai referensi yang akan digunakan saat mengodekan lapisan ini. Jika tidak ditentukan, encoder menentukan angka yang sesuai berdasarkan pengaturan kompleksitas encoder. |
slices |
integer |
Jumlah irisan yang akan digunakan saat mengodekan lapisan ini. Jika tidak ditentukan, defaultnya adalah nol, yang berarti bahwa encoder akan menggunakan satu ipotong untuk setiap bingkai. |
width |
string |
Lebar video output untuk lapisan ini. Nilainya bisa absolut (dalam piksel) atau relatif (dalam persentase). Misalnya 50% berarti video output memiliki lebar setengah piksel sebanyak input. |
H264RateControlMode
Mode kontrol laju video
Nama | Jenis | Deskripsi |
---|---|---|
ABR |
string |
Mode Laju Bit Rata-rata (ABR) yang mencapai laju bit target: Mode default. |
CBR |
string |
Mode Laju Bit Konstan (CBR) yang mengencangkan variasi laju bit di sekitar laju bit target. |
CRF |
string |
Mode Constant Rate Factor (CRF) yang menargetkan kualitas subjektif yang konstan. |
H264Video
Menjelaskan semua properti untuk mengodekan video dengan codec H.264.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
complexity |
Memberi tahu encoder cara memilih pengaturan pengodeannya. Nilai defaultnya adalah Seimbang. |
|
keyFrameInterval |
string |
Jarak antara dua bingkai kunci. Nilainya harus bukan nol dalam rentang [0,5, 20] detik, yang ditentukan dalam format ISO 8601. Defaultnya adalah 2 detik (PT2S). Perhatikan bahwa pengaturan ini diabaikan jika VideoSyncMode.Passthrough diatur, di mana nilai KeyFrameInterval akan mengikuti pengaturan sumber input. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
layers |
Kumpulan lapisan H.264 output yang akan diproduksi oleh encoder. |
|
rateControlMode |
Mode kontrol laju video |
|
sceneChangeDetection |
boolean |
Apakah encoder harus menyisipkan bingkai kunci pada perubahan adegan atau tidak. Jika tidak ditentukan, defaultnya adalah false. Bendera ini harus diatur ke true hanya ketika encoder sedang dikonfigurasi untuk menghasilkan satu video output. |
stretchMode |
Mode pengubahan ukuran - bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah AutoSize |
|
syncMode |
Mode Sinkronisasi Video |
H264VideoProfile
Saat ini kami mendukung Baseline, Main, High, High422, High444. Defaultnya adalah Otomatis.
Nama | Jenis | Deskripsi |
---|---|---|
Auto |
string |
Memberi tahu encoder untuk secara otomatis menentukan profil H.264 yang sesuai. |
Baseline |
string |
Profil garis besar |
High |
string |
Profil tinggi. |
High422 |
string |
Profil tinggi 4:2:2. |
High444 |
string |
Profil prediktif 4:4:4 tinggi. |
Main |
string |
Profil utama |
H265Complexity
Memberi tahu encoder cara memilih pengaturan pengodeannya. Kualitas akan memberikan rasio kompresi yang lebih tinggi tetapi dengan biaya yang lebih tinggi dan waktu komputasi yang lebih lama. Kecepatan akan menghasilkan file yang relatif lebih besar tetapi lebih cepat dan lebih ekonomis. Nilai defaultnya adalah Seimbang.
Nama | Jenis | Deskripsi |
---|---|---|
Balanced |
string |
Memberi tahu encoder untuk menggunakan pengaturan yang mencapai keseimbangan antara kecepatan dan kualitas. |
Quality |
string |
Memberi tahu encoder untuk menggunakan pengaturan yang dioptimalkan untuk menghasilkan output berkualitas lebih tinggi dengan mengorbankan waktu pengodean keseluruhan yang lebih lambat. |
Speed |
string |
Memberi tahu encoder untuk menggunakan pengaturan yang dioptimalkan untuk pengodean yang lebih cepat. Kualitas dikorbankan untuk mengurangi waktu pengodean. |
H265Layer
Menjelaskan pengaturan yang akan digunakan saat mengodekan video input ke dalam lapisan laju bit output yang diinginkan dengan codec video H.265.
Nama | Jenis | Deskripsi |
---|---|---|
adaptiveBFrame |
boolean |
Menentukan apakah bingkai B adaptif akan digunakan saat mengodekan lapisan ini atau tidak. Jika tidak ditentukan, encoder akan mengaktifkannya setiap kali profil video mengizinkan penggunaannya. |
bFrames |
integer |
Jumlah bingkai B yang akan digunakan saat mengodekan lapisan ini. Jika tidak ditentukan, encoder memilih nomor yang sesuai berdasarkan profil dan tingkat video. |
bitrate |
integer |
Laju bit rata-rata dalam bit per detik untuk mengodekan video input saat menghasilkan lapisan ini. Misalnya: laju bit target 3000Kbps atau 3Mbps berarti nilai ini harus 3000000 Ini adalah bidang yang diperlukan. |
bufferWindow |
string |
Panjang jendela buffer VBV. Nilai harus dalam format ISO 8601. Nilai harus dalam rentang [0,1-100] detik. Defaultnya adalah 5 detik (misalnya, PT5S). |
crf |
number |
Nilai CRF yang akan digunakan saat mengodekan lapisan ini. Pengaturan ini berlaku ketika RateControlMode codec video diatur pada mode CRF. Rentang nilai CRF adalah antara 0 dan 51, di mana nilai yang lebih rendah akan menghasilkan kualitas yang lebih baik, dengan mengorbankan ukuran file yang lebih tinggi. Nilai yang lebih tinggi berarti lebih banyak kompresi, tetapi pada beberapa titik penurunan kualitas akan diperhatikan. Nilai defaultnya adalah 28. |
frameRate |
string |
Kecepatan bingkai (dalam bingkai per detik) untuk mengodekan lapisan ini. Nilainya dapat dalam bentuk M/N di mana M dan N adalah bilangan bulat (Misalnya, 30000/1001), atau dalam bentuk angka (Misalnya, 30, atau 29,97). Encoder memberlakukan batasan pada kecepatan bingkai yang diizinkan berdasarkan profil dan tingkat. Jika tidak ditentukan, encoder akan menggunakan kecepatan bingkai yang sama dengan video input. |
height |
string |
Tinggi video output untuk lapisan ini. Nilainya bisa absolut (dalam piksel) atau relatif (dalam persentase). Misalnya 50% berarti video output memiliki tinggi setengah piksel sebanyak input. |
label |
string |
Label alfanumerik untuk lapisan ini, yang dapat digunakan dalam multipleks lapisan video dan audio yang berbeda, atau dalam penamaan file output. |
level |
string |
Saat ini kami mendukung Level hingga 6.2. Nilainya bisa Otomatis, atau angka yang cocok dengan profil H.265. Jika tidak ditentukan, defaultnya adalah Otomatis, yang memungkinkan encoder memilih Tingkat yang sesuai untuk lapisan ini. |
maxBitrate |
integer |
Laju bit maksimum (dalam bit per detik), di mana buffer VBV harus diasumsikan untuk mengisi ulang. Jika tidak ditentukan, default ke nilai yang sama dengan laju bit. |
profile |
Saat ini kami mendukung Main. Defaultnya adalah Otomatis. |
|
referenceFrames |
integer |
Jumlah bingkai referensi yang akan digunakan saat mengodekan lapisan ini. Jika tidak ditentukan, encoder menentukan angka yang sesuai berdasarkan pengaturan kompleksitas encoder. |
slices |
integer |
Jumlah irisan yang akan digunakan saat mengodekan lapisan ini. Jika tidak ditentukan, defaultnya adalah nol, yang berarti bahwa encoder akan menggunakan satu ipotong untuk setiap bingkai. |
width |
string |
Lebar video output untuk lapisan ini. Nilainya bisa absolut (dalam piksel) atau relatif (dalam persentase). Misalnya 50% berarti video output memiliki lebar setengah piksel sebanyak input. |
H265Video
Menjelaskan semua properti untuk mengodekan video dengan codec H.265.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
complexity |
Memberi tahu encoder cara memilih pengaturan pengodeannya. Kualitas akan memberikan rasio kompresi yang lebih tinggi tetapi dengan biaya yang lebih tinggi dan waktu komputasi yang lebih lama. Kecepatan akan menghasilkan file yang relatif lebih besar tetapi lebih cepat dan lebih ekonomis. Nilai defaultnya adalah Seimbang. |
|
keyFrameInterval |
string |
Jarak antara dua bingkai kunci. Nilainya harus bukan nol dalam rentang [0,5, 20] detik, yang ditentukan dalam format ISO 8601. Defaultnya adalah 2 detik (PT2S). Perhatikan bahwa pengaturan ini diabaikan jika VideoSyncMode.Passthrough diatur, di mana nilai KeyFrameInterval akan mengikuti pengaturan sumber input. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
layers |
Kumpulan lapisan H.265 output yang akan diproduksi oleh encoder. |
|
sceneChangeDetection |
boolean |
Menentukan apakah encoder harus menyisipkan bingkai kunci pada perubahan adegan atau tidak. Jika tidak ditentukan, defaultnya adalah false. Bendera ini harus diatur ke true hanya ketika encoder sedang dikonfigurasi untuk menghasilkan satu video output. |
stretchMode |
Mode pengubahan ukuran - bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah AutoSize |
|
syncMode |
Mode Sinkronisasi Video |
H265VideoProfile
Saat ini kami mendukung Utama. Defaultnya adalah Otomatis.
Nama | Jenis | Deskripsi |
---|---|---|
Auto |
string |
Memberi tahu encoder untuk secara otomatis menentukan profil H.265 yang sesuai. |
Main |
string |
Profil utama (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier) |
Main10 |
string |
10 profil utama (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10) |
Image
Menjelaskan properti dasar untuk menghasilkan gambar mini dari video input
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
keyFrameInterval |
string |
Jarak antara dua bingkai kunci. Nilainya harus bukan nol dalam rentang [0,5, 20] detik, yang ditentukan dalam format ISO 8601. Defaultnya adalah 2 detik (PT2S). Perhatikan bahwa pengaturan ini diabaikan jika VideoSyncMode.Passthrough diatur, di mana nilai KeyFrameInterval akan mengikuti pengaturan sumber input. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
range |
string |
Posisi relatif terhadap transformasi waktu mulai yang telah ditetapkan dalam video input untuk berhenti menghasilkan gambar mini. Nilai dapat dalam format ISO 8601 (Misalnya, PT5M30S berhenti pada 5 menit dan 30 detik dari waktu mulai), atau jumlah bingkai (Misalnya, 300 untuk berhenti pada bingkai ke-300 dari bingkai pada waktu mulai. Jika nilai ini adalah 1, itu berarti hanya menghasilkan satu gambar mini pada waktu mulai), atau nilai relatif terhadap durasi aliran (Misalnya, 50% untuk berhenti pada setengah durasi streaming dari waktu mulai). Nilai defaultnya adalah 100%, yang berarti berhenti di akhir stream. |
start |
string |
Posisi dalam video input dari mana mulai menghasilkan gambar mini. Nilainya dapat dalam format ISO 8601 (Misalnya, PT05S untuk memulai pada 5 detik), atau jumlah bingkai (Misalnya, 10 untuk memulai pada bingkai ke-10), atau nilai relatif terhadap durasi stream (Misalnya, 10% untuk memulai 10% dari durasi stream). Juga mendukung makro {Best}, yang memberi tahu penyandi untuk memilih gambar mini terbaik dari beberapa detik pertama video dan hanya akan menghasilkan satu gambar mini, tidak peduli apa pengaturan lainnya untuk Langkah dan Rentang. Nilai defaultnya adalah makro {Best}. |
step |
string |
Interval di mana gambar mini dihasilkan. Nilainya dapat dalam format ISO 8601 (Misalnya, PT05S untuk satu gambar setiap 5 detik), atau jumlah bingkai (Misalnya, 30 untuk satu gambar setiap 30 bingkai), atau nilai relatif terhadap durasi streaming (Misalnya, 10% untuk satu gambar setiap 10% durasi aliran). Catatan: Nilai langkah akan memengaruhi gambar mini pertama yang dihasilkan, yang mungkin tidak sama persis dengan yang ditentukan pada waktu mulai prasetel transformasi. Hal ini disebabkan oleh encoder, yang mencoba memilih gambar mini terbaik antara waktu mulai dan Posisi langkah dari waktu mulai sebagai output pertama. Karena nilai default adalah 10%, itu berarti jika aliran memiliki durasi yang lama, gambar mini pertama yang dihasilkan mungkin jauh dari yang ditentukan pada waktu mulai. Cobalah untuk memilih nilai yang wajar untuk Langkah jika gambar mini pertama diharapkan mendekati waktu mulai, atau atur nilai Rentang pada 1 jika hanya satu gambar mini yang diperlukan pada waktu mulai. |
stretchMode |
Mode pengubahan ukuran - bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah AutoSize |
|
syncMode |
Mode Sinkronisasi Video |
ImageFormat
Menjelaskan properti untuk file gambar output.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
filenamePattern |
string |
Pola penamaan file yang digunakan untuk pembuatan file output. Makro berikut ini didukung dalam nama file: {Basename} - Makro ekspansi yang akan menggunakan nama file video input. Jika nama dasar (akhiran file tidak disertakan) dari file video input kurang dari 32 karakter, nama dasar file video input akan digunakan. Jika panjang nama dasar file video input melebihi 32 karakter, nama dasar dipotok menjadi panjang total 32 karakter pertama. {Extension} - Ekstensi yang sesuai untuk format ini. {Label} - Label yang ditetapkan ke codec/layer. {Index} - Indeks unik untuk gambar mini. Hanya berlaku untuk gambar mini. {AudioStream} - string "Audio" ditambah nomor aliran audio (mulai dari 1). {Bitrate} - Laju bit audio/video dalam kbps. Tidak berlaku untuk gambar mini. {Codec} - Tipe codec audio/video. {Resolution} - Resolusi video. Makro yang tidak diganti akan diciutkan dan dihapus dari nama file. |
InsightsType
Menentukan jenis wawasan yang Anda inginkan untuk dihasilkan oleh layanan. Nilai yang diizinkan adalah 'AudioInsightsOnly', 'VideoInsightsOnly', dan 'AllInsights'. Defaultnya adalah AllInsights. Jika Anda mengatur ini ke AllInsights dan input hanya audio, maka hanya wawasan audio yang dihasilkan. Demikian pula jika input hanya video, maka hanya wawasan video yang dihasilkan. Disarankan agar Anda tidak menggunakan AudioInsightsOnly jika Anda mengharapkan beberapa input Anda menjadi video saja; atau gunakan VideoInsightsOnly jika Anda mengharapkan beberapa input Anda menjadi audio saja. Pekerjaan Anda dalam kondisi seperti itu akan bermasalah.
Nama | Jenis | Deskripsi |
---|---|---|
AllInsights |
string |
Hasilkan wawasan audio dan video. Gagal jika Insight audio atau video gagal. |
AudioInsightsOnly |
string |
Hasilkan wawasan audio saja. Abaikan video meskipun ada. Gagal jika tidak ada audio. |
VideoInsightsOnly |
string |
Hasilkan wawasan video saja. Abaikan audio jika ada. Gagal jika tidak ada video. |
InterleaveOutput
Mengatur mode interleave output untuk mengontrol bagaimana audio dan video disimpan dalam format kontainer. Contoh: atur InterleavedOutput sebagai NonInterleavedOutput untuk menghasilkan output audio saja dan video saja dalam file MP4 terpisah.
Nama | Jenis | Deskripsi |
---|---|---|
InterleavedOutput |
string |
Output mencakup audio dan video. |
NonInterleavedOutput |
string |
Outputnya hanya video atau audio saja. |
JpgFormat
Menjelaskan pengaturan untuk menghasilkan gambar mini JPEG.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
filenamePattern |
string |
Pola penamaan file yang digunakan untuk pembuatan file output. Makro berikut ini didukung dalam nama file: {Basename} - Makro ekspansi yang akan menggunakan nama file video input. Jika nama dasar (akhiran file tidak disertakan) dari file video input kurang dari 32 karakter, nama dasar file video input akan digunakan. Jika panjang nama dasar file video input melebihi 32 karakter, nama dasar dipotok menjadi panjang total 32 karakter pertama. {Extension} - Ekstensi yang sesuai untuk format ini. {Label} - Label yang ditetapkan ke codec/layer. {Index} - Indeks unik untuk gambar mini. Hanya berlaku untuk gambar mini. {AudioStream} - string "Audio" ditambah nomor aliran audio (mulai dari 1). {Bitrate} - Laju bit audio/video dalam kbps. Tidak berlaku untuk gambar mini. {Codec} - Tipe codec audio/video. {Resolution} - Resolusi video. Makro yang tidak diganti akan diciutkan dan dihapus dari nama file. |
JpgImage
Menjelaskan properti untuk menghasilkan serangkaian gambar JPEG dari video input.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
keyFrameInterval |
string |
Jarak antara dua bingkai kunci. Nilainya harus bukan nol dalam rentang [0,5, 20] detik, yang ditentukan dalam format ISO 8601. Defaultnya adalah 2 detik (PT2S). Perhatikan bahwa pengaturan ini diabaikan jika VideoSyncMode.Passthrough diatur, di mana nilai KeyFrameInterval akan mengikuti pengaturan sumber input. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
layers |
Jpg |
Kumpulan lapisan gambar JPEG output yang akan diproduksi oleh encoder. |
range |
string |
Posisi relatif terhadap transformasi waktu mulai yang telah ditetapkan dalam video input untuk berhenti menghasilkan gambar mini. Nilai dapat dalam format ISO 8601 (Misalnya, PT5M30S berhenti pada 5 menit dan 30 detik dari waktu mulai), atau jumlah bingkai (Misalnya, 300 untuk berhenti pada bingkai ke-300 dari bingkai pada waktu mulai. Jika nilai ini adalah 1, itu berarti hanya menghasilkan satu gambar mini pada waktu mulai), atau nilai relatif terhadap durasi aliran (Misalnya, 50% untuk berhenti pada setengah durasi streaming dari waktu mulai). Nilai defaultnya adalah 100%, yang berarti berhenti di akhir stream. |
spriteColumn |
integer |
Mengatur jumlah kolom yang digunakan dalam gambar mini sprite. Jumlah baris dihitung secara otomatis dan file VTT dihasilkan dengan pemetaan koordinat untuk setiap gambar mini dalam sprite. Catatan: nilai ini harus berupa bilangan bulat positif dan nilai yang tepat disarankan agar resolusi gambar output tidak akan melampaui batas resolusi piksel maksimum JPEG 65535x65535. |
start |
string |
Posisi dalam video input dari mana mulai menghasilkan gambar mini. Nilainya dapat dalam format ISO 8601 (Misalnya, PT05S untuk memulai pada 5 detik), atau jumlah bingkai (Misalnya, 10 untuk memulai pada bingkai ke-10), atau nilai relatif terhadap durasi stream (Misalnya, 10% untuk memulai 10% dari durasi stream). Juga mendukung makro {Best}, yang memberi tahu penyandi untuk memilih gambar mini terbaik dari beberapa detik pertama video dan hanya akan menghasilkan satu gambar mini, tidak peduli apa pengaturan lainnya untuk Langkah dan Rentang. Nilai defaultnya adalah makro {Best}. |
step |
string |
Interval di mana gambar mini dihasilkan. Nilainya dapat dalam format ISO 8601 (Misalnya, PT05S untuk satu gambar setiap 5 detik), atau jumlah bingkai (Misalnya, 30 untuk satu gambar setiap 30 bingkai), atau nilai relatif terhadap durasi streaming (Misalnya, 10% untuk satu gambar setiap 10% durasi aliran). Catatan: Nilai langkah akan memengaruhi gambar mini pertama yang dihasilkan, yang mungkin tidak sama persis dengan yang ditentukan pada waktu mulai prasetel transformasi. Hal ini disebabkan oleh encoder, yang mencoba memilih gambar mini terbaik antara waktu mulai dan Posisi langkah dari waktu mulai sebagai output pertama. Karena nilai default adalah 10%, itu berarti jika aliran memiliki durasi yang lama, gambar mini pertama yang dihasilkan mungkin jauh dari yang ditentukan pada waktu mulai. Cobalah untuk memilih nilai yang wajar untuk Langkah jika gambar mini pertama diharapkan mendekati waktu mulai, atau atur nilai Rentang pada 1 jika hanya satu gambar mini yang diperlukan pada waktu mulai. |
stretchMode |
Mode pengubahan ukuran - bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah AutoSize |
|
syncMode |
Mode Sinkronisasi Video |
JpgLayer
Menjelaskan pengaturan untuk menghasilkan gambar JPEG dari video input.
Nama | Jenis | Deskripsi |
---|---|---|
height |
string |
Tinggi video output untuk lapisan ini. Nilainya bisa absolut (dalam piksel) atau relatif (dalam persentase). Misalnya 50% berarti video output memiliki tinggi setengah piksel sebanyak input. |
label |
string |
Label alfanumerik untuk lapisan ini, yang dapat digunakan dalam multipleks lapisan video dan audio yang berbeda, atau dalam penamaan file output. |
quality |
integer |
Kualitas kompresi output JPEG. Rentangnya dari 0-100 dan defaultnya adalah 70. |
width |
string |
Lebar video output untuk lapisan ini. Nilainya bisa absolut (dalam piksel) atau relatif (dalam persentase). Misalnya 50% berarti video output memiliki lebar setengah piksel sebanyak input. |
Mp4Format
Menjelaskan properti untuk file ISO MP4 output.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
filenamePattern |
string |
Pola penamaan file yang digunakan untuk pembuatan file output. Makro berikut ini didukung dalam nama file: {Basename} - Makro ekspansi yang akan menggunakan nama file video input. Jika nama dasar (akhiran file tidak disertakan) dari file video input kurang dari 32 karakter, nama dasar file video input akan digunakan. Jika panjang nama dasar file video input melebihi 32 karakter, nama dasar dipotok menjadi panjang total 32 karakter pertama. {Extension} - Ekstensi yang sesuai untuk format ini. {Label} - Label yang ditetapkan ke codec/layer. {Index} - Indeks unik untuk gambar mini. Hanya berlaku untuk gambar mini. {AudioStream} - string "Audio" ditambah nomor aliran audio (mulai dari 1). {Bitrate} - Laju bit audio/video dalam kbps. Tidak berlaku untuk gambar mini. {Codec} - Tipe codec audio/video. {Resolution} - Resolusi video. Makro yang tidak diganti akan diciutkan dan dihapus dari nama file. |
outputFiles |
Daftar file output yang akan dihasilkan. Setiap entri dalam daftar adalah sekumpulan label lapisan audio dan video yang akan di-mux bersama-sama. |
MultiBitrateFormat
Menjelaskan properti untuk menghasilkan koleksi file multi-laju bit yang selaras dengan GOP. Perilaku default adalah menghasilkan satu file output untuk setiap lapisan video yang di-mux bersama dengan semua audio. File output yang tepat yang dihasilkan dapat dikontrol dengan menentukan koleksi outputFiles.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
filenamePattern |
string |
Pola penamaan file yang digunakan untuk pembuatan file output. Makro berikut ini didukung dalam nama file: {Basename} - Makro ekspansi yang akan menggunakan nama file video input. Jika nama dasar (akhiran file tidak disertakan) dari file video input kurang dari 32 karakter, nama dasar file video input akan digunakan. Jika panjang nama dasar file video input melebihi 32 karakter, nama dasar dipotok menjadi panjang total 32 karakter pertama. {Extension} - Ekstensi yang sesuai untuk format ini. {Label} - Label yang ditetapkan ke codec/layer. {Index} - Indeks unik untuk gambar mini. Hanya berlaku untuk gambar mini. {AudioStream} - string "Audio" ditambah nomor aliran audio (mulai dari 1). {Bitrate} - Laju bit audio/video dalam kbps. Tidak berlaku untuk gambar mini. {Codec} - Tipe codec audio/video. {Resolution} - Resolusi video. Makro yang tidak diganti akan diciutkan dan dihapus dari nama file. |
outputFiles |
Daftar file output yang akan dihasilkan. Setiap entri dalam daftar adalah sekumpulan label lapisan audio dan video yang akan di-mux bersama-sama. |
OnErrorType
Transformasi dapat menentukan lebih dari satu output. Properti ini menentukan apa yang harus dilakukan layanan ketika satu output gagal - baik terus menghasilkan output lain, atau, menghentikan output lainnya. Status Pekerjaan keseluruhan tidak akan mencerminkan kegagalan output yang ditentukan dengan 'ContinueJob'. Defaultnya adalah 'StopProcessingJob'.
Nama | Jenis | Deskripsi |
---|---|---|
ContinueJob |
string |
Memberi tahu layanan bahwa jika TransformOutput ini gagal, maka izinkan TransformOutput lainnya untuk melanjutkan. |
StopProcessingJob |
string |
Memberi tahu layanan bahwa jika TransformOutput ini gagal, maka TransformOutput lain yang tidak lengkap dapat dihentikan. |
OutputFile
Mewakili file output yang dihasilkan.
Nama | Jenis | Deskripsi |
---|---|---|
labels |
string[] |
Daftar label yang menjelaskan bagaimana encoder harus melakukan multipleks video dan audio ke dalam file output. Misalnya, jika encoder menghasilkan dua lapisan video dengan label v1 dan v2, dan satu lapisan audio dengan label a1, maka array seperti '[v1, a1]' memberi tahu encoder untuk menghasilkan file output dengan trek video yang diwakili oleh v1 dan trek audio yang diwakili oleh a1. |
PngFormat
Menjelaskan pengaturan untuk menghasilkan gambar mini PNG.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
filenamePattern |
string |
Pola penamaan file yang digunakan untuk pembuatan file output. Makro berikut ini didukung dalam nama file: {Basename} - Makro ekspansi yang akan menggunakan nama file video input. Jika nama dasar (akhiran file tidak disertakan) dari file video input kurang dari 32 karakter, nama dasar file video input akan digunakan. Jika panjang nama dasar file video input melebihi 32 karakter, nama dasar dipotong menjadi total 32 karakter pertama. {Extension} - Ekstensi yang sesuai untuk format ini. {Label} - Label yang ditetapkan ke codec/layer. {Index} - Indeks unik untuk gambar mini. Hanya berlaku untuk gambar mini. {AudioStream} - string "Audio" ditambah nomor aliran audio (mulai dari 1). {Bitrate} - Laju bit audio/video dalam kbps. Tidak berlaku untuk gambar mini. {Codec} - Tipe codec audio/video. {Resolution} - Resolusi video. Makro yang tidak ditugaskan akan diciutkan dan dihapus dari nama file. |
PngImage
Menjelaskan properti untuk menghasilkan serangkaian gambar PNG dari video input.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
keyFrameInterval |
string |
Jarak antara dua bingkai kunci. Nilainya harus bukan nol dalam rentang [0,5, 20] detik, yang ditentukan dalam format ISO 8601. Defaultnya adalah 2 detik (PT2S). Perhatikan bahwa pengaturan ini diabaikan jika VideoSyncMode.Passthrough diatur, di mana nilai KeyFrameInterval akan mengikuti pengaturan sumber input. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
layers |
Png |
Kumpulan lapisan gambar PNG output yang akan diproduksi oleh encoder. |
range |
string |
Posisi relatif terhadap transformasi waktu mulai yang telah ditetapkan dalam video input untuk berhenti menghasilkan gambar mini. Nilai dapat dalam format ISO 8601 (Misalnya, PT5M30S berhenti pada 5 menit dan 30 detik dari waktu mulai), atau jumlah bingkai (Misalnya, 300 untuk berhenti pada bingkai ke-300 dari bingkai pada waktu mulai. Jika nilai ini adalah 1, itu berarti hanya menghasilkan satu gambar mini pada waktu mulai), atau nilai relatif terhadap durasi aliran (Misalnya, 50% untuk berhenti pada setengah durasi streaming dari waktu mulai). Nilai defaultnya adalah 100%, yang berarti berhenti di akhir stream. |
start |
string |
Posisi dalam video input dari mana mulai menghasilkan gambar mini. Nilainya dapat dalam format ISO 8601 (Misalnya, PT05S untuk memulai pada 5 detik), atau jumlah bingkai (Misalnya, 10 untuk memulai pada bingkai ke-10), atau nilai relatif terhadap durasi stream (Misalnya, 10% untuk memulai 10% dari durasi stream). Juga mendukung makro {Best}, yang memberi tahu penyandi untuk memilih gambar mini terbaik dari beberapa detik pertama video dan hanya akan menghasilkan satu gambar mini, tidak peduli apa pengaturan lainnya untuk Langkah dan Rentang. Nilai defaultnya adalah makro {Best}. |
step |
string |
Interval di mana gambar mini dihasilkan. Nilainya dapat dalam format ISO 8601 (Misalnya, PT05S untuk satu gambar setiap 5 detik), atau jumlah bingkai (Misalnya, 30 untuk satu gambar setiap 30 bingkai), atau nilai relatif terhadap durasi streaming (Misalnya, 10% untuk satu gambar setiap 10% durasi aliran). Catatan: Nilai langkah akan memengaruhi gambar mini pertama yang dihasilkan, yang mungkin tidak sama persis dengan yang ditentukan pada waktu mulai prasetel transformasi. Hal ini disebabkan oleh encoder, yang mencoba memilih gambar mini terbaik antara waktu mulai dan Posisi langkah dari waktu mulai sebagai output pertama. Karena nilai default adalah 10%, itu berarti jika aliran memiliki durasi yang lama, gambar mini pertama yang dihasilkan mungkin jauh dari yang ditentukan pada waktu mulai. Cobalah untuk memilih nilai yang wajar untuk Langkah jika gambar mini pertama diharapkan mendekati waktu mulai, atau atur nilai Rentang pada 1 jika hanya satu gambar mini yang diperlukan pada waktu mulai. |
stretchMode |
Mode pengubahan ukuran - bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah AutoSize |
|
syncMode |
Mode Sinkronisasi Video |
PngLayer
Menjelaskan pengaturan untuk menghasilkan gambar PNG dari video input.
Nama | Jenis | Deskripsi |
---|---|---|
height |
string |
Tinggi video output untuk lapisan ini. Nilainya bisa absolut (dalam piksel) atau relatif (dalam persentase). Misalnya 50% berarti video output memiliki setengah piksel sebanyak tinggi input. |
label |
string |
Label alfanumerik untuk lapisan ini, yang dapat digunakan dalam multipleks lapisan video dan audio yang berbeda, atau dalam penamaan file output. |
width |
string |
Lebar video output untuk lapisan ini. Nilainya bisa absolut (dalam piksel) atau relatif (dalam persentase). Misalnya 50% berarti video output memiliki lebar setengah piksel sebanyak input. |
PresetConfigurations
Objek pengaturan konfigurasi opsional untuk encoder.
Nama | Jenis | Deskripsi |
---|---|---|
complexity |
Memungkinkan Anda mengonfigurasi pengaturan encoder untuk mengontrol keseimbangan antara kecepatan dan kualitas. Contoh: atur Kompleksitas sebagai Kecepatan untuk pengodean yang lebih cepat tetapi lebih sedikit efisiensi pemadatan. |
|
interleaveOutput |
Mengatur mode interleave output untuk mengontrol bagaimana audio dan video disimpan dalam format kontainer. Contoh: atur InterleavedOutput sebagai NonInterleavedOutput untuk menghasilkan output audio saja dan video saja dalam file MP4 terpisah. |
|
keyFrameIntervalInSeconds |
number |
Interval bingkai kunci dalam hitungan detik. Contoh: atur KeyFrameIntervalInSeconds sebagai 2 untuk mengurangi buffering pemutaran untuk beberapa pemain. |
maxBitrateBps |
integer |
Laju bit maksimum dalam bit per detik (ambang batas untuk lapisan video atas). Contoh: atur MaxBitrateBps sebagai 6000000 untuk menghindari produksi output laju bit yang sangat tinggi untuk konten dengan kompleksitas tinggi. |
maxHeight |
integer |
Tinggi maksimum lapisan video output. Contoh: atur MaxHeight sebagai 720 untuk menghasilkan lapisan output hingga 720P meskipun inputnya adalah 4K. |
maxLayers |
integer |
Jumlah maksimum lapisan video output. Contoh: atur MaxLayers sebagai 4 untuk memastikan paling banyak 4 lapisan output diproduksi untuk mengontrol biaya keseluruhan pekerjaan pengodean. |
minBitrateBps |
integer |
Laju bit minimum dalam bit per detik (ambang batas untuk lapisan video bawah). Contoh: atur MinBitrateBps sebagai 200000 agar memiliki lapisan bawah yang mencakup pengguna dengan bandwidth jaringan rendah. |
minHeight |
integer |
Tinggi minimum lapisan video output. Contoh: atur MinHeight sebagai 360 untuk menghindari lapisan output resolusi yang lebih kecil seperti 180P. |
Priority
Mengatur prioritas relatif TransformOutputs dalam Transformasi. Ini menetapkan prioritas yang digunakan layanan untuk memproses TransformOutputs. Prioritas defaultnya adalah Normal.
Nama | Jenis | Deskripsi |
---|---|---|
High |
string |
Digunakan untuk TransformOutput yang harus diutamakan daripada yang lain. |
Low |
string |
Digunakan untuk TransformOutput yang dapat dihasilkan setelah TransformOutput prioritas Normal dan Tinggi. |
Normal |
string |
Digunakan untuk TransformOutput yang dapat dihasilkan pada prioritas Normal. |
Rectangle
Menjelaskan properti jendela persegi panjang yang diterapkan ke media input sebelum memprosesnya.
Nama | Jenis | Deskripsi |
---|---|---|
height |
string |
Tinggi wilayah persegi panjang dalam piksel. Ini bisa menjadi nilai piksel absolut (misalnya 100), atau relatif terhadap ukuran video (Misalnya, 50%). |
left |
string |
Jumlah piksel dari margin kiri. Ini bisa menjadi nilai piksel absolut (misalnya 100), atau relatif terhadap ukuran video (Misalnya, 50%). |
top |
string |
Jumlah piksel dari margin atas. Ini bisa menjadi nilai piksel absolut (misalnya 100), atau relatif terhadap ukuran video (Misalnya, 50%). |
width |
string |
Lebar wilayah persegi panjang dalam piksel. Ini bisa menjadi nilai piksel absolut (misalnya 100), atau relatif terhadap ukuran video (Misalnya, 50%). |
Rotation
Rotasi, jika ada, untuk diterapkan ke video input, sebelum dikodekan. Defaultnya adalah Otomatis
Nama | Jenis | Deskripsi |
---|---|---|
Auto |
string |
Deteksi dan putar secara otomatis sesuai kebutuhan. |
None |
string |
Jangan putar video. Jika format output mendukungnya, metadata apa pun tentang rotasi tetap utuh. |
Rotate0 |
string |
Jangan memutar video tetapi hapus metadata apa pun tentang rotasi. |
Rotate180 |
string |
Putar 180 derajat searah jajaran. |
Rotate270 |
string |
Putar 270 derajat searah jajaran. |
Rotate90 |
string |
Putar 90 derajat searah jajaran. |
StandardEncoderPreset
Menjelaskan semua pengaturan yang akan digunakan saat mengodekan video input dengan Encoder Standar.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
codecs | Codec[]: |
Daftar codec yang akan digunakan saat mengodekan video input. |
experimentalOptions |
object |
Kamus yang berisi pasangan nilai kunci untuk parameter yang tidak diekspos dalam preset itu sendiri |
filters |
Satu atau beberapa operasi pemfilteran yang diterapkan ke media input sebelum pengodean. |
|
formats | Format[]: |
Daftar output yang akan diproduksi oleh encoder. |
StretchMode
Mode pengubahan ukuran - bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah AutoSize
Nama | Jenis | Deskripsi |
---|---|---|
AutoFit |
string |
Pad output (dengan kotak surat atau kotak pilar) untuk menghormati resolusi output, sambil memastikan bahwa wilayah video aktif dalam output memiliki rasio aspek yang sama dengan input. Misalnya, jika input adalah 1920x1080 dan preset pengodean meminta 1280x1280, maka output akan berada di 1280x1280, yang berisi persegi dalam 1280x720 pada rasio aspek 16:9, dan wilayah kotak pilar lebar 280 piksel di kiri dan kanan. |
AutoSize |
string |
Ambil alih resolusi output, dan ubah agar sesuai dengan rasio aspek tampilan input, tanpa padding. Misalnya, jika input adalah 1920x1080 dan preset pengodean meminta 1280x1280, maka nilai dalam preset diambil alih, dan output akan berada di 1280x720, yang mempertahankan rasio aspek input 16:9. |
None |
string |
Sangat menghormati resolusi output tanpa mempertimbangkan rasio aspek piksel atau rasio aspek tampilan video input. |
systemData
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
createdAt |
string |
Tanda waktu pembuatan sumber daya (UTC). |
createdBy |
string |
Identitas yang membuat sumber daya. |
createdByType |
Jenis identitas yang membuat sumber daya. |
|
lastModifiedAt |
string |
Tanda waktu modifikasi terakhir sumber daya (UTC) |
lastModifiedBy |
string |
Identitas yang terakhir memodifikasi sumber daya. |
lastModifiedByType |
Jenis identitas yang terakhir mengubah sumber daya. |
Transform
Transformasi merangkum aturan atau instruksi untuk menghasilkan output yang diinginkan dari media input, seperti dengan transcoding atau dengan mengekstrak wawasan. Setelah Transformasi dibuat, transformasi dapat diterapkan ke media input dengan membuat Pekerjaan.
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nama sumber daya. |
properties.created |
string |
Tanggal dan waktu UTC ketika Transformasi dibuat, dalam format 'YYYY-MM-DDThh:mm:ssZ'. |
properties.description |
string |
Deskripsi verbose opsional dari Transformasi. |
properties.lastModified |
string |
Tanggal dan waktu UTC ketika Transformasi terakhir diperbarui, dalam format 'YYYY-MM-DDThh:mm:ssZ'. |
properties.outputs |
Array dari satu atau beberapa TransformOutput yang harus dihasilkan transformasi. |
|
systemData |
Metadata sistem yang berkaitan dengan sumber daya ini. |
|
type |
string |
Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
TransformOutput
Menjelaskan properti TransformOutput, yang merupakan aturan yang akan diterapkan sambil menghasilkan output yang diinginkan.
Nama | Jenis | Deskripsi |
---|---|---|
onError |
Transformasi dapat menentukan lebih dari satu output. Properti ini menentukan apa yang harus dilakukan layanan ketika satu output gagal - baik terus menghasilkan output lain, atau, menghentikan output lainnya. Status Pekerjaan keseluruhan tidak akan mencerminkan kegagalan output yang ditentukan dengan 'ContinueJob'. Defaultnya adalah 'StopProcessingJob'. |
|
preset | Preset: |
Preset yang menjelaskan operasi yang akan digunakan untuk memodifikasi, melakukan transkode, atau mengekstrak wawasan dari file sumber untuk menghasilkan output. |
relativePriority |
Mengatur prioritas relatif TransformOutputs dalam Transformasi. Ini menetapkan prioritas yang digunakan layanan untuk memproses TransformOutputs. Prioritas defaultnya adalah Normal. |
TransportStreamFormat
Menjelaskan properti untuk menghasilkan file video output MPEG-2 Transport Stream (ISO/IEC 13818-1).
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
filenamePattern |
string |
Pola penamaan file yang digunakan untuk pembuatan file output. Makro berikut ini didukung dalam nama file: {Basename} - Makro ekspansi yang akan menggunakan nama file video input. Jika nama dasar (akhiran file tidak disertakan) dari file video input kurang dari 32 karakter, nama dasar file video input akan digunakan. Jika panjang nama dasar file video input melebihi 32 karakter, nama dasar dipotok menjadi panjang total 32 karakter pertama. {Extension} - Ekstensi yang sesuai untuk format ini. {Label} - Label yang ditetapkan ke codec/layer. {Index} - Indeks unik untuk gambar mini. Hanya berlaku untuk gambar mini. {AudioStream} - string "Audio" ditambah nomor aliran audio (mulai dari 1). {Bitrate} - Laju bit audio/video dalam kbps. Tidak berlaku untuk gambar mini. {Codec} - Tipe codec audio/video. {Resolution} - Resolusi video. Makro yang tidak diganti akan diciutkan dan dihapus dari nama file. |
outputFiles |
Daftar file output yang akan dihasilkan. Setiap entri dalam daftar adalah sekumpulan label lapisan audio dan video yang akan di-mux bersama-sama. |
Video
Menjelaskan properti dasar untuk mengodekan video input.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
keyFrameInterval |
string |
Jarak antara dua bingkai kunci. Nilainya harus bukan nol dalam rentang [0,5, 20] detik, yang ditentukan dalam format ISO 8601. Defaultnya adalah 2 detik (PT2S). Perhatikan bahwa pengaturan ini diabaikan jika VideoSyncMode.Passthrough diatur, di mana nilai KeyFrameInterval akan mengikuti pengaturan sumber input. |
label |
string |
Label opsional untuk codec. Label dapat digunakan untuk mengontrol perilaku muxing. |
stretchMode |
Mode pengubahan ukuran - bagaimana video input akan diubah ukurannya agar sesuai dengan resolusi output yang diinginkan. Defaultnya adalah AutoSize |
|
syncMode |
Mode Sinkronisasi Video |
VideoAnalyzerPreset
Preset penganalisis video yang mengekstrak wawasan (metadata kaya) dari audio dan video, dan menghasilkan file format JSON.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
audioLanguage |
string |
Bahasa untuk payload audio dalam input menggunakan format BCP-47 dari 'language tag-region' (misalnya: 'en-US'). Jika Anda mengetahui bahasa konten Anda, disarankan agar Anda menentukannya. Bahasa harus ditentukan secara eksplisit untuk AudioAnalysisMode::Basic, karena deteksi bahasa otomatis tidak disertakan dalam mode dasar. Jika bahasa tidak ditentukan atau diatur ke null, deteksi bahasa otomatis akan memilih bahasa pertama yang terdeteksi dan diproses dengan bahasa yang dipilih selama durasi file. Saat ini tidak mendukung peralihan dinamis antar bahasa setelah bahasa pertama terdeteksi. Deteksi otomatis bekerja paling baik dengan rekaman audio dengan ucapan yang jelas jelas. Jika deteksi otomatis gagal menemukan bahasa, transkripsi akan kembali ke 'en-US'." Daftar bahasa yang didukung tersedia di sini: https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
Kamus yang berisi pasangan nilai kunci untuk parameter yang tidak diekspos dalam preset itu sendiri |
insightsToExtract |
Menentukan jenis wawasan yang Anda inginkan untuk dihasilkan oleh layanan. Nilai yang diizinkan adalah 'AudioInsightsOnly', 'VideoInsightsOnly', dan 'AllInsights'. Defaultnya adalah AllInsights. Jika Anda mengatur ini ke AllInsights dan input hanya audio, maka hanya wawasan audio yang dihasilkan. Demikian pula jika input hanya video, maka hanya wawasan video yang dihasilkan. Disarankan agar Anda tidak menggunakan AudioInsightsOnly jika Anda mengharapkan beberapa input Anda hanya berupa video; atau gunakan VideoInsightsOnly jika Anda mengharapkan beberapa input Anda hanya berupa audio. Pekerjaan Anda dalam kondisi seperti itu akan bermasalah. |
|
mode |
Menentukan serangkaian operasi analisis audio yang akan dilakukan. Jika tidak ditentukan, AudioAnalysisMode Standar akan dipilih. |
VideoOverlay
Menjelaskan properti overlay video.
Nama | Jenis | Deskripsi |
---|---|---|
@odata.type |
string:
#Microsoft. |
Diskriminator untuk jenis turunan. |
audioGainLevel |
number |
Tingkat perolehan audio dalam overlay. Nilai harus dalam rentang [0, 1.0]. Defaultnya adalah 1.0. |
cropRectangle |
Jendela persegi panjang opsional yang digunakan untuk memangkas gambar atau video overlay. |
|
end |
string |
Posisi akhir, dengan referensi ke video input, di mana overlay berakhir. Nilai harus dalam format ISO 8601. Misalnya, PT30S untuk mengakhiri overlay pada 30 detik ke dalam video input. Jika tidak ditentukan atau nilai lebih besar dari durasi video input, overlay akan diterapkan hingga akhir video input jika durasi media overlay lebih besar dari durasi video input, jika tidak, overlay akan berlangsung selama durasi media overlay. |
fadeInDuration |
string |
Durasi di mana overlay memudar ke video input. Nilai harus dalam format durasi ISO 8601. Jika tidak ditentukan, perilaku defaultnya adalah tidak memudar (sama seperti PT0S). |
fadeOutDuration |
string |
Durasi di mana overlay memudar dari video input. Nilai harus dalam format durasi ISO 8601. Jika tidak ditentukan, perilaku defaultnya adalah tidak akan memudar (sama seperti PT0S). |
inputLabel |
string |
Label input pekerjaan yang akan digunakan sebagai overlay. Input harus menentukan tepat satu file. Anda dapat menentukan file gambar dalam format JPG, PNG, GIF atau BMP, atau file audio (seperti WAV, MP3, WMA atau M4A), atau file video. Lihat https://aka.ms/mesformats untuk daftar lengkap format file audio dan video yang didukung. |
opacity |
number |
Keburaman overlay. Ini adalah nilai dalam rentang [0 - 1.0]. Defaultnya adalah 1,0 yang berarti overlay buram. |
position |
Lokasi dalam video input tempat overlay diterapkan. |
|
start |
string |
Posisi awal, dengan referensi ke video input, di mana overlay dimulai. Nilai harus dalam format ISO 8601. Misalnya, PT05S untuk memulai overlay pada 5 detik ke dalam video input. Jika tidak ditentukan, overlay dimulai dari awal video input. |
VideoSyncMode
Mode Sinkronisasi Video
Nama | Jenis | Deskripsi |
---|---|---|
Auto |
string |
Ini adalah metode default. Memilih antara Cfr dan Vfr tergantung pada kemampuan muxer. Untuk format output MP4, mode defaultnya adalah Cfr. |
Cfr |
string |
Bingkai input akan diulang dan/atau dihilangkan sesuai kebutuhan untuk mencapai kecepatan bingkai konstanta yang diminta. Disarankan ketika kecepatan bingkai output secara eksplisit diatur pada nilai yang ditentukan |
Passthrough |
string |
Tanda waktu presentasi pada bingkai diteruskan dari file input ke penulis file output. Disarankan ketika sumber input memiliki kecepatan bingkai variabel, dan mencoba menghasilkan beberapa lapisan untuk streaming adaptif dalam output yang telah menyelaraskan batas GOP. Catatan: jika dua bingkai atau lebih dalam input memiliki tanda waktu duplikat, output juga akan memiliki perilaku yang sama |
Vfr |
string |
Mirip dengan mode Passthrough, tetapi jika input memiliki bingkai yang memiliki tanda waktu duplikat, maka hanya satu bingkai yang diteruskan ke output, dan yang lain dihilangkan. Disarankan ketika jumlah bingkai output diharapkan sama dengan jumlah bingkai input. Misalnya, output digunakan untuk menghitung metrik kualitas seperti PSNR terhadap input |