ApsaraVideo Media Processing：Aktivitas Alur Kerja

Nama Aktivitas

Jenis aktivitas dalam topologi

Deskripsi

Input

Mulai

Wajib. Mengonfigurasi jalur input Object Storage Service (OSS) dan pengaturan global termasuk antrian ApsaraVideo Media Processing (MPS) dan notifikasi pesan.

Publish

Laporan

Wajib. Mengonfigurasi mode publikasi. Dua mode publikasi didukung: Otomatis dan Manual.

Analyze

Analisis

Menganalisis secara cerdas file media input dan merekomendasikan template preset yang sesuai untuk file tersebut.

Encode

Transkode

Mentranskode file media input ke format yang berbeda. Ini memastikan bahwa file dapat diputar di platform yang berbeda.

Snapshot

Tangkapan Layar

Mengambil tangkapan layar video pada titik waktu tertentu. Anda dapat menggunakan tangkapan layar sebagai gambar mini video atau menggunakan beberapa tangkapan layar untuk menghasilkan sprite.

Pack

PackageConfig

Mengemas file video multi-resolusi, multi-trek audio, dan multi-subtitle untuk menghasilkan file M3U8.

Video Group

VideoGroup

Audio Group

AudioGroup

Subtitle Group

SubtitleGroup

Ekstrak Video

Ekstrak Audio

Ekstrak Subtitle

Transcode

Generate

GenerateMasterPlayList

Content Moderation

Censor

Mendeteksi konten pornografi, konten teroris, dan konten yang tidak diinginkan dalam pidato, teks, dan adegan video. Ini mengurangi biaya untuk tinjauan manual dan menurunkan risiko yang mungkin dibawa oleh konten yang tidak sesuai.

Video DNA

FpShot

Mengidentifikasi video secara unik. Ini memungkinkan Anda mengekstrak dan membandingkan sidik jari gambar dan audio dalam video. Dengan cara ini, Anda dapat menemukan video duplikat, melacak sumber klip video, dan mengidentifikasi plagiarisme.

Thumbnail Cerdas

Cover

Memilih frame kunci atau klip terbaik dari video sebagai gambar mini video untuk meningkatkan tingkat konversi klik dan pengalaman pengguna video. Ini diimplementasikan dengan menggunakan algoritma berdasarkan pemahaman penuh tentang konten video, estetika gambar, dan sejumlah besar data perilaku pengguna.

Parameter

Tipe

Wajib

Deskripsi

InputFile

String

Ya

File input. Anda dapat menggunakan parameter Bucket, Location, dan Object untuk menentukan lokasi file.

• Untuk informasi lebih lanjut tentang aturan pemicuan alur kerja, lihat Aturan pemicuan alur kerja untuk file.

• File hanya dapat disimpan di OSS. Untuk informasi lebih lanjut tentang detail parameter InputFile, lihat Detail parameter.

• Path objek OSS harus di-enkode URL dalam UTF-8 sebelum digunakan di MPS. Untuk informasi lebih lanjut, lihat Pengkodean URL.

• Contoh: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","ObjectPrefix":"example.mp4"}.

PipelineId

String

Ya

ID antrian MPS, yang merupakan pengaturan global.

• ID antrian MPS ini hanya digunakan untuk aktivitas Analyze, Encode, Snapshot, dan Pack. Untuk pekerjaan AI, Anda harus mengonfigurasi ID antrian MPS secara terpisah untuk sebuah aktivitas.

• Dalam alur kerja media, pengaturan pesan untuk antrian MPS tertentu tidak valid. Gunakan pengaturan parameter QueueName atau TopicName untuk alur kerja media.

MessageType

String

Tidak

Jenis pesan, yang merupakan pengaturan global. Nilai valid:

• Queue: Antrian Simple Message Queue (sebelumnya MNS). Jika Anda mengatur parameter ini ke Queue, Anda harus menentukan parameter QueueName.

• Topic: Topik SMQ. Jika Anda mengatur parameter ini ke Topic, Anda harus menentukan parameter TopicName.

• Nilai default: Queue.

QueueName

String

Tidak

Antrian SMQ yang akan dikaitkan dengan antrian MPS, yang merupakan pengaturan global. Setelah pekerjaan selesai di antrian MPS, hasil pekerjaan didorong ke antrian SMQ. Untuk informasi lebih lanjut tentang notifikasi pesan, lihat Terima notifikasi.

• Anda dapat menentukan salah satu antrian SMQ queues yang telah Anda buat. Jika tidak ada antrian SMQ queue yang tersedia, buat satu di Konsol SMQ.

TopicName

String

Tidak

Topik SMQ yang akan dikaitkan dengan antrian MPS, yang merupakan pengaturan global. Setelah pekerjaan selesai di antrian MPS, hasil pekerjaan didorong ke topik SMQ. Topik SMQ terkait mendorong pesan tentang hasil ke URL yang berlangganan topik SMQ. Untuk informasi lebih lanjut, lihat Terima notifikasi.

• Anda dapat menentukan salah satu topik SMQ topics yang telah Anda buat. Jika tidak ada topik SMQ topic yang tersedia, buat satu di Konsol SMQ.

RoleName

String

Tidak

Nama peran Resource Access Management (RAM), yang merupakan pengaturan global.

• Nilai default: AliyunMTSDefaultRole.

Parameter

Tipe

Wajib

Deskripsi

PublishType

String

Tidak

Mode publikasi file media, yang merupakan pengaturan global. Nilai valid:

• Manual: mempublikasikan file media secara manual. File media tidak dipublikasikan setelah alur kerja dijalankan. Anda dapat mempublikasikan file media secara manual. Untuk informasi lebih lanjut, lihat Kelola file media.

• Auto: mempublikasikan file media secara otomatis setelah semua aktivitas selesai. File media dipublikasikan secara otomatis setelah alur kerja dijalankan.

• TranscodeCompletedAuto: mempublikasikan file media secara otomatis setelah aktivitas Transcode selesai. Pengaturan pesan aktivitas Input digunakan untuk memberi tahu Anda bahwa transkode selesai. Jika aktivitas Transcode dilewati, tidak ada pesan yang dikirim.

• Nilai default: Manual.

  Catatan

  • MPS memproses file media dalam alur kerja dan menggunakan Security Token Service (STS) untuk memberikan izin kepada pengguna RAM. Ini memungkinkan Anda mengonfigurasi cara file media dipublikasikan.

  • Status publikasi memengaruhi izin akses pada file output.

    • Jika file video, audio, dan tangkapan layar output tidak dipublikasikan, izin akses pada file bersifat pribadi.

    • Jika file video, audio, dan tangkapan layar output dipublikasikan, izin akses pada file ditentukan berdasarkan izin akses pada bucket OSS tempat mereka berada.

Parameter

Tipe

Wajib

Deskripsi

KeepOnlyHighestDefinition

String

Tidak

Menentukan apakah hanya menyimpan hasil analisis untuk video dalam definisi tertinggi. Nilai valid:

• True: hanya menyimpan video output dalam definisi tertinggi.

• False: menghasilkan video output dalam semua definisi.

• Nilai default: False.

Parameter

Tipe

Wajib

Deskripsi

Outputs

String

Tidak

Output pekerjaan transkode.

• Tentukan nilai dalam array JSON objek Output. Anda dapat menentukan hingga 30 objek Output.

• Untuk informasi lebih lanjut tentang parameter dalam setiap objek Output, lihat Detail parameter.

• Contoh: [{"OutputObject":"transcode%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D","TemplateId": "S00000001-000070"}].

OutputBucket

String

Tidak

Nama bucket output.

• Selama pengemasan HTTP Live Streaming (HLS) dan Dynamic Adaptive Streaming over HTTP (DASH), parameter Bucket dalam aktivitas Pack memiliki prioritas lebih tinggi daripada parameter OutputBucket.

OutputLocation

String

Tidak

Wilayah bucket output.

• Selama pengemasan HLS dan DASH, parameter Location dalam aktivitas Pack memiliki prioritas lebih tinggi daripada parameter OutputLocation.

MultiBitrateVideoStream

String

Tidak

Parameter ini diperlukan untuk mengekstrak aliran video selama pengemasan HLS.

• Untuk informasi lebih lanjut, lihat Detail parameter.

• Contoh: {"URI": "c/d/video1.m3u8"}.

ExtXMedia

String

Tidak

Parameter ini diperlukan untuk mengekstrak aliran audio atau subtitle selama pengemasan HLS.

• Untuk informasi lebih lanjut, lihat Detail parameter.

• Contoh: {"Name": "english","Language": "en-US","URI":"c/d/audio-1.m3u8"}.

WebVTTSubtitleURL

String

Tidak

URL subtitle. Parameter ini diperlukan untuk mengekstrak aliran subtitle selama pengemasan HLS.

• Hanya file subtitle Web Video Text Tracks (WebVTT) yang didukung. URL subtitle harus mematuhi standar URL dan dapat ditimpa saat Anda memanggil operasi AddMedia.

• Contoh: http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitles****-en.vtt.

Representation

String

Tidak

Parameter ini diperlukan untuk mengekstrak aliran video, audio, atau subtitle selama pengemasan DASH.

• Untuk informasi lebih lanjut, lihat Detail parameter.

• Contoh: {\"Id\":\"480p\", \"URI\":\"videoSD/xx.mpd\"}.

InputConfig

String

Tidak

URL subtitle. Parameter ini diperlukan untuk mengekstrak aliran subtitle selama pengemasan DASH.

• Untuk informasi lebih lanjut, lihat Detail parameter.

• Contoh: "{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://example-Bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitle/subtitle****-en.vtt\"}}".

Parameter

Tipe

Wajib

Deskripsi

SnapshotConfig

String

Ya

Konfigurasi snapshot.

• Untuk informasi lebih lanjut, lihat Detail parameter.

• Contoh: {"OutputFile": {"Bucket": "example-001", "Location": "oss-cn-hangzhou", "Object":"snapshot%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D%2F1.jpg"},"Time": "5"}.

MediaCover

String

Tidak

Menentukan apakah akan mengatur snapshot sebagai gambar mini media. Parameter ini hanya valid untuk satu snapshot tunggal. Nilai valid:

• true

• false

• Nilai default: false.

Parameter

Tipe

Wajib

Deskripsi

Output

String

Ya

Informasi rinci tentang file output, yang merupakan string JSON. Contoh: {"Bucket":"output","Location":"oss-cn-hangzhou","MasterPlayListName":"a/b/c.m3u8"}.

Protocol

String

Ya

Protokol yang dapat digunakan untuk pengemasan. Nilai valid: hls dan dash.

Parameter

Tipe

Wajib

Deskripsi

AdaptationSet

String

Tidak

Informasi tentang grup video. Parameter ini diperlukan untuk pengemasan DASH.

• Untuk informasi lebih lanjut, lihat Detail parameter.

• Contoh: "AdaptationSet":"{\"Group\":\"VideoGroup\"}".

Parameter

Tipe

Wajib

Deskripsi

GroupId

String

Tidak

ID grup audio. Parameter ini diperlukan untuk pengemasan HLS.

• ID dapat memiliki panjang hingga 32 byte.

AdaptationSet

String

Tidak

Informasi tentang grup audio. Parameter ini diperlukan untuk pengemasan DASH.

• Untuk informasi lebih lanjut, lihat Detail parameter.

• Contoh: "{\"Lang\":\"english\", \"Group\":\"AudioGroupEnglish\"}".

Parameter

Tipe

Wajib

Deskripsi

GroupId

String

Tidak

ID grup subtitle. Parameter ini diperlukan untuk pengemasan HLS.

• ID dapat memiliki panjang hingga 32 byte.

AdaptationSet

String

Tidak

Informasi tentang grup subtitle. Parameter ini diperlukan untuk pengemasan DASH.

• Untuk informasi lebih lanjut, lihat Detail parameter.

• Contoh: "{\"Lang\":\"english\", \"Group\":\"SubtitleENGroup\"}".

Parameter

Tipe

Wajib

Deskripsi

MasterPlayList

String

Tidak

• Aliran video multi-bitrate. Parameter ini eksklusif dan diperlukan untuk pengemasan HLS. Untuk informasi lebih lanjut, lihat Detail parameter.

• Contoh: {"MultiBitrateVideoStreams": [{"RefActivityName": "video-1","ExtXStreamInf": {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}}]}.