ApsaraVideo Media Processing:Aktivitas alur kerja

Nama aktivitas

Jenis aktivitas dalam topologi

Deskripsi

Input

Start

Anda dapat mengatur konfigurasi global, termasuk antrian MPS dan notifikasi pesan, serta jalur input OSS untuk media workflow.

Publish (wajib)

Report

Anda dapat mengatur mode penerbitan menjadi manual atau otomatis.

Analyze

Analysis

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

Encode

Transcode

Men-transcode file media input ke berbagai format. Hal ini memastikan bahwa file tersebut dapat diputar di berbagai platform.

Snapshot

Screenshot

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

Konfigurasi pengemasan

PackageConfig

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

Video Group

VideoGroup

Audio Group

AudioGroup

Subtitle Group

SubtitleGroup

Extract Video

Extract Audio

Extract Subtitle

Transcode

Generate

GenerateMasterPlayList

Content Moderation

Censor

Mendeteksi konten pornografi, konten teroris, dan konten tidak diinginkan dalam ucapan, teks, dan adegan video. Hal ini mengurangi biaya tinjauan manual dan menurunkan risiko yang mungkin ditimbulkan oleh konten yang tidak sesuai.

Video DNA

FpShot

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

Intelligent Thumbnail

Cover

Memilih frame kunci atau klip optimal dari video sebagai gambar mini video untuk meningkatkan tingkat konversi klik dan pengalaman pengguna video. Hal ini diimplementasikan menggunakan algoritma berbasis pemahaman menyeluruh terhadap konten video, estetika gambar, dan data perilaku pengguna dalam jumlah besar.

Nama

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 pemicu alur kerja, lihat Aturan pemicu alur kerja untuk file.

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

• Jalur objek OSS harus dikodekan 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 pipeline konfigurasi 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 setiap aktivitas.

• Dalam media workflow, pengaturan pesan untuk antrian MPS tertentu tidak berlaku. Gunakan pengaturan parameter QueueName atau TopicName untuk media workflow tersebut.

MessageType

String

Tidak

Konfigurasi global: Kategori pesan

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

• Topic: Topik MNS. Atur ke TopicName.

• Nilai default: Queue.

QueueName

String

Tidak

Konfigurasi global menentukan antrian MNS yang akan disambungkan ke pipeline ApsaraVideo Media Processing. Setelah disambungkan, hasil pekerjaan yang telah selesai dari pipeline tersebut dikirim ke antrian ini. Untuk informasi lebih lanjut tentang pesan, lihat Menerima notifikasi pesan.

• Nilai valid: sebuah queue MNS yang telah Anda buat. Jika tidak tersedia queue, buka konsol Simple Message Queue (formerly MNS) untuk membuatnya.

TopicName

String

Tidak

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

• Nilai valid: sebuah topic MNS yang telah Anda buat. Jika tidak tersedia topic, buka konsol Simple Message Queue (formerly MNS) untuk membuatnya.

RoleName

String

Tidak

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

• Nilai default: AliyunMTSDefaultRole.

Nama

Tipe

Wajib

Deskripsi

PublishType

String

Tidak

Konfigurasi global untuk tipe penerbitan media.

• Manual: menerbitkan file media secara manual. File media tidak diterbitkan setelah alur kerja dijalankan. Anda dapat menerbitkan file media secara manual. Untuk informasi lebih lanjut, lihat Mengelola file media.

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

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

• Nilai default: Manual.

  Catatan

  • Saat ApsaraVideo Media Processing mengeksekusi alur kerja untuk memproses file, sistem menggunakan pengguna temporary Security Token Service (STS) untuk memodifikasi file output sesuai dengan tipe penerbitan.

  • Status penerbitan memengaruhi izin akses pada file output.

    • Belum diterbitkan: File video, audio, dan screenshot memiliki izin akses privat.

    • Diterbitkan: File video, audio, dan screenshot mewarisi izin akses dari Bucket yang memuatnya.

Nama

Tipe

Wajib

Deskripsi

KeepOnlyHighestDefinition

String

Tidak

Menentukan apakah hanya menyimpan hasil analisis definisi tertinggi.

• True: hanya menyimpan video output dalam definisi tertinggi.

• False: menghasilkan video output dalam semua definisi.

• Nilai default: False.

Nama

Tipe

Wajib

Deskripsi

Outputs

String

Tidak

Output dari pekerjaan transkoding.

• 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

Menentukan wilayah output.

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

MultiBitrateVideoStream

String

Tidak

Parameter ini wajib untuk mengekstraksi aliran video selama pengemasan HLS.

• Untuk informasi lebih lanjut, lihat Detail parameter.

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

ExtXMedia

String

Tidak

Parameter ini wajib untuk mengekstraksi 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 wajib untuk mengekstraksi aliran subtitle selama pengemasan HLS.

• Hanya file subtitle Web Video Text Tracks (WebVTT) yang didukung. URL subtitle harus memenuhi 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 wajib untuk mengekstraksi 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 wajib untuk mengekstraksi 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\"}}".

Nama

Type

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 snapshot diatur sebagai gambar mini media. Parameter ini hanya berlaku untuk satu snapshot. Nilai valid:

• true: Benar.

• false: Tidak

• Nilai default: false.

Nama

Tipe

Wajib

Deskripsi

Output

String

Ya

Informasi detail tentang file output, berupa 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.

Nama

Tipe

Wajib

Deskripsi

AdaptationSet

String

Tidak

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

• Untuk informasi lebih lanjut, lihat Detail parameter.

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

Nama

Tipe

Wajib

Deskripsi

GroupId

String

Tidak

ID grup audio. Parameter ini wajib untuk pengemasan HLS.

• Panjang maksimum adalah 32 byte.

AdaptationSet

String

Tidak

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

• Untuk informasi lebih lanjut, lihat Detail parameter.

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

Nama

Tipe

Wajib

Deskripsi

GroupId

String

Tidak

ID grup subtitle. Parameter ini wajib untuk pengemasan HLS.

• Panjang maksimum adalah 32 byte.

AdaptationSet

String

Tidak

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

• Untuk informasi lebih lanjut, lihat Detail parameter.

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

Nama

Tipe

Wajib

Deskripsi

MasterPlayList

String

Tidak

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

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