ApsaraVideo Media Processing (MPS) menyediakan tiga mode untuk memicu alur kerja yang memenuhi berbagai kebutuhan terkait jalur input dan otomatisasi pemicuan. Topik ini menjelaskan tiga mode pemicu alur kerja beserta skenario dan persyaratannya masing-masing.
Perbandingan mode pemicu
Mode Pemicu | Skema |
Pemicu Otomatis | Sebuah file diproses menggunakan alur kerja yang telah ditentukan segera setelah diunggah ke jalur tertentu. |
Pemicu Manual untuk File di Bawah Jalur Terverifikasi |
|
Pemicu Manual untuk File di Bawah Jalur Berbeda | File yang disimpan di jalur berbeda diproses menggunakan alur kerja yang sama. |
Mode 1: Pemicu otomatis
Buat alur kerja dan atur mode pemicu ke pemicu otomatis. Secara default, ketika membuat alur kerja, mode pemicunya adalah pemicu otomatis. Untuk informasi lebih lanjut tentang cara membuat alur kerja, lihat Buat Alur Kerja.
Tambahkan file. Persyaratan berikut harus dipenuhi:
File tersebut bukan dihasilkan oleh MPS atau Intelligent Media Services (IMS). Untuk informasi lebih lanjut, lihat bagian "File Tidak Dihasilkan oleh MPS atau IMS" dari topik ini.
Jalur file sesuai dengan aturan pencocokan jalur. Untuk informasi lebih lanjut, lihat bagian "Aturan Pencocokan Jalur" dari topik ini.
Nama file sesuai dengan aturan pencocokan ekstensi nama file. Untuk informasi lebih lanjut, lihat bagian "Aturan Pencocokan Ekstensi Nama File" dari topik ini.
File diunggah dengan memanggil salah satu operasi API berikut dari OSS.
Operasi
Deskripsi
PutObject
Mengunggah objek.
PostObject
Mengunggah objek ke bucket tertentu menggunakan formulir HTML.
CopyObject
Menyalin objek dalam bucket atau lintas bucket di wilayah yang sama.
CompleteMultipartUpload
Menggabungkan bagian-bagian yang diunggah menjadi objek setelah semua bagian objek diunggah.
PutSymlink
Membuat tautan simbolik untuk objek, yang memungkinkan Anda mengakses objek menggunakan tautan simbolik.
Mode 2: Pemicu manual untuk file di bawah jalur terverifikasi
Buat alur kerja. Sebelum menambahkan file, ubah mode pemicu alur kerja menjadi pemicu manual dengan memanggil operasi UpdateMediaWorkflowTriggerMode. Untuk informasi lebih lanjut tentang cara membuat alur kerja, lihat Buat Alur Kerja.
Tambahkan file. Persyaratan berikut harus dipenuhi:
Jalur file sesuai dengan aturan pencocokan jalur. Untuk informasi lebih lanjut, lihat bagian "Aturan Pencocokan Jalur" dari topik ini.
Nama file sesuai dengan aturan pencocokan ekstensi nama file. Untuk informasi lebih lanjut, lihat bagian "Aturan Pencocokan Ekstensi Nama File" dari topik ini.
File diunggah dengan memanggil operasi API OSS pilihan Anda.
Setelah menambahkan file, panggil operasi AddMedia untuk menentukan file yang akan diproses dan ID alur kerja yang akan dipicu berdasarkan kebutuhan bisnis Anda.
Mode 3: Pemicu manual untuk file di bawah jalur berbeda
Buat alur kerja. Sebelum menambahkan file, ubah mode pemicu alur kerja menjadi pemicu manual dengan memanggil operasi UpdateMediaWorkflowTriggerMode. Untuk informasi lebih lanjut tentang cara membuat alur kerja, lihat Buat Alur Kerja.
Tambahkan file. Persyaratan berikut harus dipenuhi:
File disimpan di wilayah tempat MPS diaktifkan.
File diunggah dengan memanggil operasi API OSS pilihan Anda.
Setelah menambahkan file, panggil operasi AddMedia untuk menentukan file yang akan diproses dan ID alur kerja yang akan dipicu berdasarkan kebutuhan bisnis Anda. Selain itu, atur parameter InputUnbind ke false, yang menentukan bahwa MPS tidak memeriksa file terhadap aturan pencocokan jalur atau aturan pencocokan ekstensi nama file.
Aturan pencocokan file
File tidak dihasilkan oleh MPS atau IMS
Jika jalur input alur kerja sama dengan jalur output pekerjaan MPS atau IMS, file yang dihasilkan oleh pekerjaan MPS atau IMS tidak dapat memicu alur kerja. Ini mencegah alur kerja dipicu secara siklik karena pengaturan jalur input dan output yang tidak tepat. Contoh:
Output jalur Workflow A dan input jalur Workflow B keduanya http://bucket.oss-cn-hangzhou.aliyuncs.com/A/.
Jika file input http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv dihasilkan oleh Workflow A, Workflow B tidak dapat dipicu.
Jika file input http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv diunggah langsung ke jalur http://bucket.oss-cn-hangzhou.aliyuncs.com/A/, Workflow B dapat dipicu.
Aturan pencocokan jalur
Jika jalur file input berada di bawah jalur input yang Anda tentukan untuk Node Input alur kerja, file input dapat memicu alur kerja. Jika tidak, file input tidak dapat memicu alur kerja. Contoh:
Jalur input alur kerja tidak boleh menjadi awalan jalur input alur kerja lain. Jika tidak, kedua alur kerja akan dipicu jika file diunggah ke jalur terakhir. Sebagai contoh, jalur input Workflow A adalah test dan jalur input Workflow B adalah test1. Jika file diunggah ke folder test1, kedua alur kerja akan dipicu.
Jika jalur input yang Anda tentukan untuk Node Input alur kerja berakhiran dengan garis miring (/), seperti http://bucket.oss-cn-hangzhou.aliyuncs.com/A/, hasil pencocokan beberapa file input dijelaskan dalam tabel berikut.
Jalur file input | Cocok |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv | Ya |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/example.flv | Ya |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/example.flv | Ya |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A1/example.flv | Tidak |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A_video01.mp4 | Tidak |
http://bucket.oss-cn-beijing.aliyuncs.com/A/example.flv | Tidak |
http://bucket.oss-cn-hangzhou.aliyuncs.com/example.flv | Tidak |
http://bucket.oss-cn-hangzhou.aliyuncs.com/D/example.flv | Tidak |
Jika jalur input yang Anda tentukan untuk Node Input alur kerja tidak berakhiran dengan garis miring (/), seperti http://bucket.oss-cn-hangzhou.aliyuncs.com/A, hasil pencocokan beberapa file input dijelaskan dalam tabel berikut.
Jalur file input | Cocok |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv | Ya |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/example.flv | Ya |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/example.flv | Ya |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A1/example.flv | Ya |
http://bucket.oss-cn-hangzhou.aliyuncs.com/A_video01.mp4 | Ya |
http://bucket.oss-cn-beijing.aliyuncs.com/A/example.flv | Tidak |
http://bucket.oss-cn-hangzhou.aliyuncs.com/example.flv | Tidak |
http://bucket.oss-cn-hangzhou.aliyuncs.com/D/example.flv | Tidak |
Aturan pencocokan ekstensi nama file
Tabel berikut menjelaskan ekstensi nama file yang didukung. Jika ekstensi nama file dari file input ada di tabel, file input dapat memicu alur kerja. Jika tidak, file input tidak dapat memicu alur kerja. Contoh:
File input adalah http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv. Ekstensi nama file adalah .flv, yang sesuai dengan aturan pencocokan.
Pemeriksaan didasarkan pada ekstensi nama file terakhir. Sebagai contoh, jika file input adalah http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv.mp4, ekstensi nama file adalah .mp4, yang sesuai dengan aturan pencocokan.
Tipe | Ekstensi nama file |
File video | .3gp, .asf, .avi, .dat, .dv, .flv, .f4v, .gif, .m2t, .m3u8, .m4v, .mj2, .mjpeg, .mkv, .mov, .mp4, .mpe, .mpg, .mpeg, .mts, ogg, .qt, .rm, .rmvb, .swf, .vob, .wmv, .webm, .mxf, and .quicktime |
File audio | .s48, .aac, .ac3, .acm, .amr, .ape, .caf, .flac, .m4a, .mp3, .ra, .wav, .wma, and .aiff |