Parameter pengeditan dan produksi - Intelligent Media Services

Topik ini menjelaskan parameter yang umum digunakan dalam pengeditan dan produksi.

OutputMediaConfig

Konfigurasi file media, yang harus ditentukan dalam format JSON. Anda dapat menentukan URL file media di Bucket Object Storage Service (OSS) atau lokasi penyimpanan file media di ApsaraVideo VOD. Untuk menyimpan file media di bucket OSS, tentukan field MediaURL. Untuk menyimpan file media di ApsaraVideo VOD, tentukan field StorageLocation dan FileName.

Parameter

Parameter	Tipe	Diperlukan	Deskripsi
MediaURL	String	Field ini diperlukan saat Anda menyimpan file media di bucket OSS.	URL file media di bucket OSS. Contoh: http://-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4 Perhatikan informasi berikut: Pastikan bahwa bucket OSS berada di wilayah yang sama dengan layanan yang ingin Anda panggil. Anda tidak dapat menentukan titik akhir akselerasi OSS atau nama domain Content Delivery Network (CDN). Untuk informasi selengkapnya tentang format output yang didukung, lihat Format aset media yang didukung untuk pengeditan.
StorageLocation	String	Field ini diperlukan saat Anda menyimpan file media di ApsaraVideo VOD.	Lokasi penyimpanan file media di ApsaraVideo VOD. Nilainya tidak termasuk awalan http://. Contoh: outin-xxxxxx.oss-cn-shanghai.aliyuncs.com
FileName	String	Field ini diperlukan saat Anda menyimpan file media di ApsaraVideo VOD.	Nama file media di ApsaraVideo VOD. Nama file mencakup ekstensi file, tetapi tidak termasuk jalur file. Contoh: outputVod.mp4
Video	String	Tidak	Konfigurasi video output dan aliran video. Untuk informasi selengkapnya, lihat Detail Video
Width	Integer	Tidak	Lebar video output. Anda dapat mengosongkan parameter ini. Nilai default adalah lebar maksimum dari material input.
Height	Integer	Tidak	Tinggi video output. Anda dapat mengosongkan parameter ini. Nilai default adalah tinggi maksimum dari material input.
Bitrate	Integer	Tidak	Bitrate video output. Satuan: Kbit/s. Anda dapat mengosongkan parameter ini. Nilai default adalah bitrate maksimum dari beberapa video.
MaxDuration	Float	Tidak	Durasi maksimum video output. Satuan: detik. Untuk informasi selengkapnya tentang cara menggunakan parameter ini, lihat Set MaxDuration
ProduceTemplateId	String	Tidak	Parameter kustom. ID templat produksi, yang sama dengan ID templat transkoding MPS. Parameter ini digunakan untuk mengatur parameter produksi dan transkoding video output. Anda dapat menggunakan bidang ini untuk mentranskode video yang diproduksi dan memproses video kustom dalam skenario tertentu. Anda dapat membuat templat transkoding di MPS.
VodTemplateGroupId	String	Tidak	Saat Anda menyimpan video output di ApsaraVideo VOD, Anda harus menentukan kelompok template transkoding VOD. Anda dapat memperoleh ID kelompok template transkoding dari Konsol ApsaraVideo VOD. Jika Anda tidak perlu mentranskode video yang diproduksi, atur bidang ini ke VOD_NO_TRANSCODE. Untuk informasi selengkapnya, lihat Template transkoding.
Endpoint	String	Tidak	Titik akhir penyedia layanan cloud. Bidang ini wajib jika S3 digunakan.
Bucket	String	Tidak	Bucket S3. Field ini diperlukan saat S3 digunakan.
ObjectKey	String	Tidak	Nama objek. Field ini diperlukan saat S3 digunakan.
AccessKeyId	String	Tidak	ID AccessKey sementara yang diperoleh dari penyedia layanan cloud. Bidang ini wajib jika Amazon Simple Storage Service (S3) digunakan.
AccessKeySecret	String	Tidak	Rahasia AccessKey sementara yang diperoleh dari penyedia layanan cloud. Field ini diperlukan saat S3 digunakan.

Detail Video

Field parameter OutputMediaConfig yang menentukan konfigurasi video keluaran dan aliran video. Tabel berikut memberikan contoh konfigurasi.

Parameter	Tipe	Diperlukan	Makna	Deskripsi
Fps	Integer	Tidak	Tingkat frame video keluaran.	Nilai valid: 1 hingga 60. Nilai default: 25.
Orientation	String	Tidak	Mode orientasi tampilan video.	Nilai valid: Horizontal dan Vertical. Horizontal: mode lanskap. Vertical: mode potret. Jika Anda mengatur field ini ke Horizontal, sistem menentukan lebar dan tinggi maksimum video keluaran berdasarkan lebar dan tinggi video dengan lebar terbesar di antara semua video dalam mode lanskap. Jika Anda mengatur field ini ke Vertical, sistem menentukan lebar dan tinggi maksimum video keluaran berdasarkan lebar dan tinggi video dengan tinggi terbesar di antara semua video dalam mode potret. Jika Anda menentukan field Width dan Height, field ini tidak berlaku.
Codec	String	Tidak	Format encoding.	Nilai valid: H.264 dan H.265. Nilai default: H.264.
Profile	String	Tidak	Profil encoding video.	Nilai valid: baseline, main, dan high. Nilai default: high. Catatan: Field ini hanya valid jika field Codec diatur ke H.264.
Crf	Integer	Tidak	Faktor laju konstan.	Nilai valid: 0 hingga 51. Nilai default: Jika Anda mengatur Codec ke H.264, field ini adalah 23 secara default. Jika Anda mengatur Codec ke H.265, field ini adalah 26 secara default. Catatan: Jika Anda menentukan field Crf dan Bitrate, field Bitrate tidak berlaku.
Preset	String	Tidak	Algoritma video preset.	Nilai valid: veryfast, fast, medium, slow, dan slower. Nilai default: medium. Catatan: Field ini hanya valid jika field Codec diatur ke H.264.

Contoh

Output ke OSS

Jika Anda menyimpan file media di bucket OSS, Anda harus menentukan field MediaURL. Field lain bersifat opsional. Field Bitrate menentukan bitrate video output; bitrate yang lebih tinggi menghasilkan kualitas video yang lebih jernih. Nilai maksimum untuk field Bitrate adalah 5.000. Field Width dan Height menentukan resolusi video.

{
 "MediaURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4",
 "Bitrate": 2000,  
 "Width": 800,  
 "Height": 680
}

Format URL OSS: https://${bucket}.${oss-region-name}.aliyuncs.com/${fileKey}

bucket adalah nama bucket OSS, sedangkan fileKey adalah nama objek OSS, termasuk jalur objek dan ekstensi.

oss-region-name.aliyuncs.com adalah titik akhir publik bucket OSS. Kode berikut menunjukkan titik akhir publik untuk wilayah China (Shanghai), China (Hangzhou), dan China (Beijing):

oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com 
oss-cn-beijing.aliyuncs.com

VOD

Jika Anda ingin menyimpan file media di ApsaraVideo VOD, Anda harus menentukan field StorageLocation dan FileName. Lokasi penyimpanan ApsaraVideo VOD yang tersedia dapat dilihat di Konsol VOD.

{ 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",  
  "FileName": "outputVod.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680,
  "VodTemplateGroupId": "VOD_NO_TRANSCODE"
}

Contoh konfigurasi field Video

Berikut adalah contoh konfigurasi field Video dari parameter OutputMediaConfig.

{
  "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4",
  "Width": 800,
  "Height": 680,
  "Video": {
    "Codec": "H.264",
    "Fps": 50,
    "Profile": "main",
    "Crf": 15
  }
}

ProjectMetadata

Metadata proyek pengeditan dalam format JSON.

Parameter

Tipe

Diperlukan

Deskripsi

Description

String

Tidak

Deskripsi proyek pengeditan.

Title

String

Tidak

Judul proyek pengeditan.

Contoh

{
   "Description":"Description",
   "Title":"Title"
}

EditingProduceConfig

Parameter untuk pengeditan dan produksi umum dalam format JSON.

Parameter

Parameter	Tipe	Diperlukan	Deskripsi
AudioChannelCopy	String	Tidak	Saluran audio yang ingin Anda salin. Nilai valid: left dan right. Jika Anda mengatur field ini ke left, sistem menyalin saluran audio kiri dan kanan video keluaran sebagai saluran audio kiri video masukan. Jika Anda mengatur field ini ke right, sistem menyalin saluran audio kiri dan kanan video keluaran sebagai saluran audio kanan video masukan.
AutoRegisterInputVodMedia	Boolean	Tidak	Menentukan apakah akan mendaftarkan file media ApsaraVideo VOD di timeline Anda ke pustaka aset media Intelligent Media Services (IMS) secara otomatis. Nilai default: true.
AutoRegisterOutputImsMedia	Boolean	Tidak	Menentukan apakah akan mendaftarkan video yang dihasilkan setelah pengeditan dan produksi ke pustaka aset media IMS secara otomatis. Nilai default: true.
OutputWebmTransparentChannel	Boolean	Tidak	Menentukan apakah akan mengekspor video dengan saluran alpha dalam format WebM. Nilai default: false. Jika Anda ingin mengekspor video dengan saluran alpha dalam format WebM, pastikan bahwa field MediaURL atau FileName dari parameter OutputMediaConfig diakhiri dengan webm dan hanya Efek Skala yang tersedia di timeline Anda. Jika tidak, video dalam format MP4 tanpa saluran alpha diekspor secara default.
CoverConfig	JSON	Tidak	Gambar mini. Anda dapat menggunakan frame dalam video sebagai gambar mini. Gambar mini disimpan sebagai gambar dan disimpan di bucket OSS Anda. Anda tidak dapat menggunakan gambar mini untuk memodifikasi frame pertama video. Anda dapat memanggil operasi GetMediaInfo untuk menanyakan URL gambar mini. StartTime: titik waktu gambar mini dalam video. Nilainya dapat dibulatkan hingga empat tempat desimal. Unit: detik.
InputMediaRegisterConfig	JSON	Tidak	Jika timeline pengeditan berisi URL, sistem akan secara otomatis mendaftarkan URL tersebut sebagai aset media. Bidang ini menentukan konfigurasi untuk mendaftarkan material input sebagai aset media. NeedSnapshot: menentukan apakah akan secara otomatis mengambil snapshot untuk file media. Tipenya Boolean. Nilai default: true. NeedSprite: menentukan apakah akan menggunakan snapshot untuk menghasilkan sprite untuk file media. Tipenya Boolean. Nilai default: true. SearchLibName: nama pustaka pencarian kustom. Tipenya String. Nilai default: kosong. Jika Anda ingin mengimpor aset media yang terdaftar ke pustaka pencarian kustom, Anda harus menentukan bidang ini. Untuk informasi selengkapnya, lihat Proses menggunakan pustaka pencarian kustom berdasarkan OpenAPI.
SearchLibName	String	Tidak	Jika Anda ingin mengimpor file media yang secara otomatis terdaftar setelah pengeditan dan produksi ke pustaka pencarian kustom, Anda harus menentukan bidang ini. Untuk informasi selengkapnya, lihat Proses menggunakan pustaka pencarian kustom berdasarkan OpenAPI.
NeedSnapshot	Boolean	Tidak	Menentukan apakah akan menangkap snapshot secara otomatis untuk file media. Nilai default: true.
NeedSprite	Boolean	Tidak	Menentukan apakah akan menggunakan snapshot untuk menghasilkan sprite untuk file media. Nilai default: true.
PipelineId	String	Tidak	ID pipeline kustom. Anda dapat menentukan bidang ini sesuai kebutuhan. Saat beberapa lini bisnis menggunakan Akun Alibaba Cloud yang sama untuk mengirimkan tugas, Anda dapat menggunakan bidang ini untuk membedakan tugas dari lini bisnis yang berbeda. Jika Anda memiliki persyaratan, kirimkan Tiket.
MaxBitrate	Integer	Tidak	Bitrate maksimum video output. Anda dapat menentukan bidang ini sesuai kebutuhan. Jika Anda menentukan bidang ini dan bitrate video input lebih besar daripada nilai bidang ini, sistem akan menggunakan nilai bidang ini sebagai bitrate video output. Jika Anda tidak menentukan field ini, bitrate maksimum video keluaran adalah 5.000 secara default.
KeepOriginMaxBitrate	Boolean	Tidak	Menentukan apakah akan menggunakan bitrate maksimum file sumber untuk video keluaran. Nilai default: false. Jika Anda mengatur field ini ke true, sistem menggunakan bitrate maksimum file sumber untuk video keluaran. Bitrate maksimum video keluaran adalah 50.000.
KeepOriginVideoMaxFps	Boolean	Tidak	Menentukan apakah akan menggunakan tingkat frame maksimum file sumber untuk video keluaran. Nilai default: false. Jika Anda mengatur field ini ke true, sistem menggunakan tingkat frame maksimum file sumber untuk video keluaran.

Contoh

{
	"AutoRegisterInputVodMedia": true,
	"OutputWebmTransparentChannel": true,
	"CoverConfig": {
		"StartTime": 3.3
	},
	"AudioChannelCopy": "left",
	"PipelineId": "xxxd54a97cff4108b555b01166d4bxxx",
	"MaxBitrate": 5000,
	"KeepOriginMaxBitrate": false,
	"KeepOriginVideoMaxFps": false
}

MediaMetadata

Metadata file media yang dihasilkan setelah pengeditan, dalam format JSON.

Parameter

Parameter	Tipe	Diperlukan	Deskripsi
Title	String	Tidak	Judul file media. Judul dapat memiliki panjang hingga 128 byte. Judul harus dikodekan dalam UTF-8.
Description	String	Tidak	Deskripsi file media. Deskripsi dapat memiliki panjang hingga 1.024 byte. Pengkodean UTF-8.
Tags	String	Tidak	Tag file media. Anda dapat menentukan maksimal 16 tag. Beberapa tag dipisahkan dengan koma (,). Setiap tag dapat memiliki panjang hingga 32 byte. Nilainya harus dikodekan dalam UTF-8.
CateId	Long	Tidak	ID kategori file media.
CustomMetadata	String	Tidak	Metadata kustom dalam format JSON. Contoh: {"key1": "value1", "dict1": {"key2": "value2", "key3": "value3"}} Metadata video output berisi informasi di atas.

UserData

Data pengguna dalam format JSON. Saat mengirimkan tugas produksi, Anda dapat menambahkan data pengguna ke parameter UserData. Jika Anda mengonfigurasi URL callback untuk tugas produksi, sistem akan mengirimkan permintaan callback ke URL tersebut setelah produksi selesai, yang mencakup parameter UserData. Nilai parameter ini dapat memiliki panjang hingga 1.024 byte.

Untuk memudahkan penggunaan, Anda dapat langsung mengonfigurasi callback dalam parameter UserData. Untuk informasi selengkapnya, lihat Konfigurasikan alamat notifikasi event untuk menerima callback setelah produksi selesai.

Tabel berikut menjelaskan field yang dicadangkan dalam parameter UserData.

Parameter yang dicadangkan

Parameter

Tipe

Diperlukan

Deskripsi

NotifyAddress

String

Tidak

URL callback. Callback HTTP dan callback Message Service (MNS) Alibaba Cloud didukung.

Contoh callback HTTP: http://yourdomain.com/callback.

Contoh callback MNS: "ice-callback-test". Nama antrian MNS harus dimulai dengan ice-callback.