ApsaraVideo Media Processing (MPS) menyediakan tiga mode pemicu alur kerja, masing-masing dengan persyaratan berbeda terkait path input dan otomatisasi pemicu.
Perbandingan mode pemicu
|
Mode pemicu |
Skenario |
|
Pemicu otomatis |
File harus diproses oleh alur kerja yang telah ditetapkan segera setelah diunggah ke path tertentu. |
|
Pemicu manual untuk file di bawah path yang telah diverifikasi |
|
|
Pemicu manual untuk file di bawah path yang berbeda |
File yang disimpan di path berbeda harus diproses oleh alur kerja yang sama. |
Mode 1: Pemicu otomatis
-
Buat alur kerja dan atur mode pemicunya menjadi pemicu otomatis. Secara default, mode pemicu alur kerja adalah pemicu otomatis saat Anda membuatnya. Untuk informasi selengkapnya tentang cara membuat alur kerja, lihat Create a workflow.
-
Tambahkan file. Persyaratan berikut harus dipenuhi:
-
File tersebut tidak dihasilkan oleh MPS atau Intelligent Media Services (IMS). Untuk informasi selengkapnya, lihat bagian "Files are not generated by MPS or IMS" dalam topik ini.
-
Path file mematuhi aturan pencocokan path. Untuk informasi selengkapnya, lihat bagian "Path matching rules" dalam topik ini.
-
Nama file mematuhi aturan pencocokan ekstensi nama file. Untuk informasi selengkapnya, lihat bagian "File name extension matching rules" dalam topik ini.
-
File diunggah dengan memanggil salah satu Operasi API OSS berikut.
Operation
Description
PutObject
Uploads an object.
PostObject
Uploads an object to a specific bucket by using an HTML form.
CopyObject
Copies an object within a bucket or across buckets in the same region.
CompleteMultipartUpload
Combines the uploaded parts into an object after all parts of the object are uploaded.
PutSymlink
Creates a symbolic link for an object, which allows you to access the object by using the symbolic link.
-
Mode 2: Pemicu manual untuk file di bawah path yang telah diverifikasi
-
Buat alur kerja. Sebelum menambahkan file, ubah mode pemicu alur kerja menjadi manual trigger dengan memanggil operasi UpdateMediaWorkflowTriggerMode. Untuk informasi selengkapnya tentang cara membuat alur kerja, lihat Create a workflow.
-
Tambahkan file. Persyaratan berikut harus dipenuhi:
Path file mengikuti aturan pencocokan path. Untuk informasi selengkapnya, lihat bagian "Path matching rules" dalam topik ini.
Nama file mengikuti aturan pencocokan ekstensi nama file. Untuk informasi selengkapnya, lihat bagian "File name extension matching rules" dalam topik ini.
-
File diunggah dengan memanggil Operasi API OSS pilihan Anda.
Setelah menambahkan file, panggil operasi AddMedia untuk menentukan file yang akan diproses serta ID alur kerja yang sesuai dengan kebutuhan bisnis Anda.
Mode 3: Pemicu manual untuk file di bawah path yang berbeda
-
Buat alur kerja. Sebelum menambahkan file, ubah mode pemicu alur kerja menjadi manual trigger dengan memanggil operasi UpdateMediaWorkflowTriggerMode. Untuk informasi selengkapnya tentang cara membuat alur kerja, lihat Create a workflow.
-
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 sesuai kebutuhan bisnis Anda. Selain itu, atur parameter InputUnbind ke false, yang menonaktifkan pemeriksaan file terhadap aturan pencocokan path dan aturan pencocokan ekstensi nama file.
Aturan pencocokan file
File tidak dihasilkan oleh MPS atau IMS
Jika input path suatu alur kerja sama dengan output path pekerjaan MPS atau IMS, file yang dihasilkan oleh pekerjaan tersebut tidak dapat memicu alur kerja tersebut. Hal ini mencegah pemicuan siklik akibat tumpang tindih path input dan output. Contoh:
Output path Workflow A dan input path Workflow B keduanya adalah 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 path http://bucket.oss-cn-hangzhou.aliyuncs.com/A/, Workflow B dapat dipicu.
Aturan pencocokan path
File input hanya dapat memicu alur kerja jika path-nya berada di bawah path input yang ditentukan untuk Input node alur kerja tersebut. Contoh:
Jangan mengatur path input satu alur kerja sebagai awalan dari path input alur kerja lainnya. Jika tidak, kedua alur kerja akan dipicu saat file diunggah ke path yang belakangan. Misalnya, jika path input Workflow A adalah test dan path input Workflow B adalah test1, mengunggah file ke folder test1 akan memicu kedua alur kerja tersebut.
Jika path input yang ditentukan untuk Input node suatu alur kerja diakhiri dengan garis miring (/), seperti http://bucket.oss-cn-hangzhou.aliyuncs.com/A/, tabel berikut menunjukkan hasil pencocokan untuk berbagai file input.
|
Input file path |
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 path input yang ditentukan untuk Input node suatu alur kerja tidak diakhiri dengan garis miring (/), seperti http://bucket.oss-cn-hangzhou.aliyuncs.com/A, tabel berikut menunjukkan hasil pencocokan untuk berbagai file input.
|
Input file path |
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 mencantumkan ekstensi nama file yang didukung. File input hanya dapat memicu alur kerja jika ekstensinya tercantum dalam tabel ini. Contoh:
File input adalah http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv. Ekstensi nama file-nya adalah .flv, yang memenuhi aturan pencocokan.
Pemeriksaan didasarkan pada ekstensi nama file terakhir. Misalnya, jika file input adalah http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv.mp4, ekstensi nama file-nya adalah .mp4, yang memenuhi aturan pencocokan.
|
Jenis |
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, dan .quicktime |
|
File audio |
.s48, .aac, .ac3, .acm, .amr, .ape, .caf, .flac, .m4a, .mp3, .ra, .wav, .wma, dan .aiff |