Buat pekerjaan transkoding atau alur kerja - ApsaraVideo Media Processing

Untuk menggunakan ApsaraVideo Media Processing (MPS) dalam transkoding, Anda dapat membuat pekerjaan transkoding atau alur kerja melalui konsol MPS atau dengan memanggil operasi API. Panduan ini menjelaskan cara membuat pekerjaan transkoding reguler atau alur kerja di MPS.

Sebelum Anda mulai

Pastikan langkah-langkah berikut telah dilakukan:

Aktifkan antrian MPS. Untuk informasi lebih lanjut, lihat Buat antrian MPS. Antrian MPS standar dapat digunakan untuk pekerjaan transkoding reguler atau alur kerja.
Unggah video yang akan diproses ke OSS.
- Untuk membuat pekerjaan, unggah video langsung ke OSS. Untuk informasi lebih lanjut, lihat Unggah video.
- Untuk membuat alur kerja dan memicu otomatis, tambahkan bucket media dan buat alur kerja sebelum mengunggah video. Setelah menentukan bucket input dan output serta mengunggah file media ke bucket input, MPS menerima notifikasi pengunggahan dan memicu alur kerja terkait. File hasil pemrosesan akan diunggah ke bucket output setelah alur kerja selesai. Untuk informasi lebih lanjut, lihat Tambahkan bucket media.
Konfigurasikan template transkoding.
Opsional. Konfigurasikan template watermark. Jika ingin menambahkan watermark ke video, gunakan template watermark untuk menyederhanakan proses. Untuk informasi lebih lanjut, lihat Kelola template watermark.
Opsional. Aktifkan fitur notifikasi. Jika ingin MPS mengirimkan notifikasi tentang pekerjaan atau alur kerja ke topik atau antrian MNS, konfigurasikan antrian atau topik MNS sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Aktifkan fitur notifikasi untuk pekerjaan atau alur kerja MPS.

Buat pekerjaan transkoding reguler atau alur kerja di konsol

Buat pekerjaan transkoding reguler

Masuk ke Konsol MPS.
Di bilah navigasi atas, pilih wilayah dari daftar drop-down.
Di panel navigasi sisi kiri, klik Job Management.
Pada tab Encode, klik Create Task.

Konfigurasikan parameter yang dijelaskan dalam tabel berikut.

Parameter	Deskripsi
Input File URL	Tentukan URL file input yang disimpan di Object Storage Service (OSS) bucket. Klik Select di sebelah kolom URL File Input. Dalam kotak dialog Pilih File, pilih bucket OSS dari daftar drop-down Bucket. Kemudian, folder di bucket OSS secara otomatis ditampilkan di bagian Path. Pilih file dari folder sebagai file input. Catatan Jika tidak ada bucket yang ditampilkan dalam daftar drop-down Bucket, pergi ke konsol OSS dan buat bucket di wilayah yang ditentukan. Untuk informasi lebih lanjut, lihat Tambahkan bucket media. Jika tidak ada file yang ditampilkan setelah Anda memilih bucket OSS, pergi ke konsol OSS dan unggah file ke bucket yang ditentukan. Jika Anda diminta untuk mengaktifkan OSS, pergi ke konsol OSS dan aktifkan OSS. Jika pesan kesalahan memberi tahu Anda bahwa peran Resource Access Management (RAM) saat ini tidak valid atau Anda tidak memiliki izin yang diperlukan, pergi ke konsol RAM dan berikan izin kepada pengguna RAM untuk mengakses OSS. Anda dapat melampirkan kebijakan AliyunOSSFullAccess ke pengguna RAM untuk memberikan pengguna RAM izin penuh pada OSS, atau Anda dapat menyesuaikan izin berdasarkan kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Buat pengguna RAM dan berikan izin kepada pengguna RAM.
Encoding Pipeline	Pilih antrian MPS untuk transkoding dari daftar drop-down. Catatan Jika tidak ada antrian MPS yang ditampilkan dalam daftar drop-down Pipeline Encoding, aktifkan antrian MPS untuk transkoding. Untuk informasi lebih lanjut, lihat Buat antrian MPS. Jumlah maksimum pekerjaan yang dapat diproses secara bersamaan oleh antrian MPS untuk transkoding tidak dijamin karena kemampuan pemrosesan bersamaan bergantung pada sumber daya yang tersedia. Secara default, antrian MPS untuk transkoding dapat memproses maksimal 200 pekerjaan secara bersamaan.
Output File Name	Masukkan nama di kolom Nama File Output. Anda harus menyertakan ekstensi nama file untuk semua jenis file kecuali file M3U8. Contoh: example_video01.mp4.
Output Path	Tentukan URL file output yang akan disimpan di bucket OSS. Klik Select di sebelah kolom Path Output. Dalam kotak dialog Pilih Path Output, pilih bucket OSS dari daftar drop-down Bucket. Kemudian, folder di bucket OSS secara otomatis ditampilkan di bagian Path. Pilih folder sebagai path output. Catatan Jika path output sama dengan path input, tentukan nama file output yang berbeda dari nama file input. Dengan cara ini, file input tidak tertimpa. Jika file input dan output memiliki nama yang sama, pengaturan OSS terkait menentukan apakah file output menimpa file input. Untuk informasi tentang cara menonaktifkan penimpaan file, lihat Cegah objek agar tidak tertimpa oleh objek dengan nama yang sama. Jika Anda menonaktifkan penimpaan file, file output hasil transkoding yang memiliki nama yang sama dengan file input gagal ditulis ke bucket OSS. Kami sarankan Anda tidak menentukan nama yang sama untuk file input dan output. Untuk informasi lebih lanjut tentang jawaban atas pertanyaan umum lainnya, lihat deskripsi parameter Input File URL.

Klik Next.

Konfigurasikan parameter yang dijelaskan dalam tabel berikut.

Parameter	Deskripsi
Template Type	Pilih tipe template transkoding. Untuk informasi lebih lanjut tentang template preset, lihat bagian "Template Preset" dari topik Template Transkoding. Untuk informasi tentang cara membuat template transkoding kustom, lihat Template Transkoding.
Output Format	Pilih format output dari daftar drop-down. Nilai default: mp4.
Templates	Pilih template transkoding dari daftar. Nilai default: MP4-4K.
Watermark Templates	Opsional. Jika Anda mengaktifkan saklar ini, Anda juga perlu melakukan operasi berikut: Pilih template watermark dari daftar drop-down Watermark Templates. Jika tidak ada template watermark yang ditampilkan dalam daftar drop-down, buat satu. Untuk informasi lebih lanjut, lihat Kelola template watermark. Klik Select di sebelah kolom Watermark Image. Dalam kotak dialog Pilih File, pilih bucket dari daftar drop-down Bucket. Kemudian, folder di bucket secara otomatis ditampilkan di bagian Path. Pilih file sebagai watermark. Catatan Anda dapat memilih gambar PNG, gambar PNG animasi, atau video MOV.
Clip Output	Opsional. Jika Anda mengaktifkan saklar ini, Anda dapat mengonfigurasi waktu mulai untuk pengeditan video dan panjang yang akan dipotong untuk menentukan durasi klip video. Dalam pemilih waktu Start From, pilih jam, menit, dan detik untuk waktu dari mana pengeditan video dimulai. Catatan Waktu mulai tidak boleh lebih besar dari durasi total video. Jika tidak, pekerjaan transkoding gagal. Dalam pemilih waktu Clip Length, pilih jam, menit, dan detik untuk durasi klip video. Catatan Jika durasi klip video yang ditentukan melebihi panjang sisa video, klip video dari waktu mulai hingga bagian akhir video dipertahankan.
Rotate Angle	Opsional. Masukkan nilai di kolom Sudut Rotasi. Video diputar searah jarum jam. Nilai valid: 0 hingga 360. Satuan: derajat.

Klik Submit. Pekerjaan transkoding dibuat dan dikirimkan.
Setelah pekerjaan transkoding dikirimkan, Anda dapat melihat status eksekusi dan konfigurasi pekerjaan. Klik nama pekerjaan untuk melihat informasi tambahan seperti path input dan output.
Catatan
Jika kolom Status Encoding menampilkan Gagal tanpa detail, periksa kondisi jaringan dan kirim ulang pekerjaan setelah kondisi jaringan normal.

Buat alur kerja transkoding reguler

Masuk ke Konsol MPS.
Di bilah navigasi atas, pilih wilayah dari daftar drop-down.
Di panel navigasi sisi kiri, pilih Workflow > Workflow Orchestration.
Klik Create Workflow.
Konfigurasikan parameter berikut sesuai kebutuhan bisnis Anda:
1. Workflow Name: Masukkan nama di kolom.
2. Configuration Plan: Pilih tipe alur kerja dari daftar drop-down.
  Catatan
  MPS menyediakan beberapa alur kerja preset untuk memenuhi kebutuhan bisnis Anda dalam skenario berbeda. Anda dapat memilih alur kerja preset untuk pengeditan cepat atau menyesuaikan alur kerja sesuai kebutuhan bisnis Anda.

Edit topologi alur kerja.

Klik ikon Plus di sebelah kanan node yang diperlukan dan pilih Encode.
Klik ikon Pen di sebelah kanan node Encode. Kotak dialog Encoding akan muncul.

Dalam kotak dialog Encoding, konfigurasikan parameter yang dijelaskan dalam tabel berikut.

Parameter	Deskripsi
Name	Nama node Encode.
Transcoding Templates	Klik Select di sebelah kolom Template Transkoding. Dalam kotak dialog Encoding Template, lakukan operasi berikut: Konfigurasikan parameter Template Type. Pilih format output dari daftar drop-down Output Format. Pilih template dari daftar Templates. Klik OK. Catatan Untuk informasi lebih lanjut tentang template preset, lihat bagian "Template Preset" dari topik Template Transkoding. Untuk informasi tentang cara membuat template transkoding kustom, lihat Template Transkoding.
Output Path	Klik Select di sebelah kolom Path Output. Dalam kotak dialog Pilih Path Output, pilih bucket dari daftar drop-down Bucket. Kemudian, folder di bucket secara otomatis ditampilkan di bagian Path. Pilih folder sebagai path output. Catatan Dua situasi berikut mungkin terjadi jika path output dan path input sama: Jika file input dan output memiliki nama yang berbeda, file output tidak menimpa file input. Jika file input dan output memiliki nama yang sama, pengaturan OSS terkait menentukan apakah file output menimpa file input. Untuk informasi tentang cara menonaktifkan penimpaan file, lihat Cegah objek agar tidak tertimpa oleh objek dengan nama yang sama. Jika Anda menonaktifkan penimpaan file, file output hasil transkoding yang memiliki nama yang sama dengan file input gagal ditulis ke bucket OSS. Kami sarankan Anda tidak menentukan nama yang sama untuk file input dan output. Untuk mencegah file output tertimpa ketika alur kerja dijalankan beberapa kali, Anda dapat menentukan path output dengan menggunakan variabel UC bawaan berikut dalam kombinasi: {RunId}: ID instance eksekusi alur kerja. {ObjectPrefix}: path file asli yang tidak termasuk informasi bucket. {FileName}: nama file asli yang mencakup ekstensi nama file. Ekstensi nama bervariasi berdasarkan format template transkoding. {ExtName}: ekstensi nama file dari file asli.
Watermark	Opsional. Jika Anda mengaktifkan saklar, lakukan operasi berikut: Pilih template watermark dari daftar drop-down Watermark Template. Catatan Jika tidak ada template watermark yang ditampilkan dalam daftar drop-down, buat satu. Untuk informasi lebih lanjut, lihat Kelola template watermark. Klik Select di sebelah kolom Watermark Image. Dalam kotak dialog Pilih Path, pilih path gambar watermark. Catatan Anda dapat memilih gambar PNG, gambar PNG animasi, atau video MOV.
Encryption	Opsional. Jika Anda mengaktifkan saklar, lakukan operasi berikut: Atur parameter Encryption Method ke Alibaba Cloud Private Encryption atau HLS Standard Encryption. Untuk informasi lebih lanjut tentang enkripsi video, lihat Enkripsi Video.
Clip	Opsional. Jika Anda mengaktifkan saklar, lakukan operasi berikut: Atur parameter Clip Method ke Video Clip atau Video Ending Clip. Atur parameter Start From ke waktu di mana pemotongan video dimulai. Atur parameter Length ke panjang klip. Catatan Waktu mulai tidak boleh lebih besar dari durasi total video. Jika tidak, pekerjaan transkoding gagal. Jika durasi klip video yang ditentukan melebihi panjang sisa video, klip video dari waktu mulai hingga bagian akhir video dipertahankan.
Add Credits	Opsional. Jika Anda mengaktifkan saklar, lakukan operasi berikut: Klik Select di sebelah kolom File Path dan pilih path bagian akhir.
Rotate Angle	Opsional. Masukkan nilai di kolom Sudut Rotasi. Video diputar searah jarum jam. Nilai valid: 0 hingga 360. Satuan: derajat.

Klik OK. Node Encode telah dikonfigurasi.

Klik Simpan. Alur kerja telah dibuat.

Buat pekerjaan transkoding reguler dengan memanggil operasi API

Jika pekerjaan transkoding dan alur kerja yang dibuat di konsol MPS tidak memenuhi kebutuhan bisnis Anda, panggil operasi SubmitJobs untuk mengirimkan pekerjaan transkoding dan mengonfigurasi parameter transkoding sesuai logika bisnis Anda.

Panggil operasi SubmitJobs untuk mengirimkan pekerjaan transkoding.
Untuk informasi lebih lanjut, lihat SubmitJobs. Atur parameter permintaan berdasarkan instruksi berikut:
1. PipelineId: ID antrian MPS. Atur parameter ini ke ID antrian MPS standar.
2. TemplateId: ID template transkoding. Atur parameter ini ke ID template preset atau template kustom sesuai kebutuhan bisnis Anda. Untuk informasi tentang cara membuat template transkoding kustom, lihat AddTemplate.
3. Opsional. Jika ingin mengenkripsi file output, atur parameter Enkripsi dalam parameter Output sesuai kebutuhan bisnis Anda.
  Catatan
  File terenkripsi dihasilkan dalam format M3U8. Anda memanggil operasi API untuk mengenkripsi file menggunakan algoritma Base64 atau Key Management Service (KMS). Untuk informasi lebih lanjut, lihat Detail Parameter.
Terima notifikasi callback.
Jika telah mengonfigurasi antrian atau topik Simple Message Queue (SMQ) untuk menerima notifikasi, MPS akan mengirimkan notifikasi ke antrian atau topik SMQ setelah pekerjaan transkoding selesai. Untuk informasi lebih lanjut, lihat Terima Notifikasi.
Query hasil pekerjaan transkoding.
1. Anda dapat memanggil operasi QueryJobList untuk menanyakan hasil pekerjaan transkoding dan URL file output.
2. Anda dapat memanggil operasi ListJob untuk menanyakan beberapa pekerjaan transkoding sekaligus berdasarkan ID antrian MPS, status pekerjaan, dan interval waktu pembuatan.