Gunakan AddMedia untuk menambahkan file media - ApsaraVideo Media Processing - Alibaba Cloud - ApsaraVideo Media Processing

Mengirimkan pekerjaan untuk menambahkan media.

Deskripsi operasi

Jika Anda memiliki video yang sudah ada dan disimpan di OSS, Anda dapat menggunakan operasi ini untuk memprosesnya tanpa mengunggah ulang video ke Bucket OSS. Jika Anda telah mengonfigurasi alur kerja media, OSS secara otomatis memberi tahu ApsaraVideo Media Processing setelah file media diunggah ke Bucket OSS. Berdasarkan bucket dan objek OSS yang dikonfigurasi, sistem secara otomatis mencocokkan dan menjalankan alur kerja yang aktif. Oleh karena itu, dalam sebagian besar kasus, Anda tidak perlu memanggil operasi AddMedia secara manual untuk memproses file.
Informasi media hanya diperoleh secara otomatis ketika Anda menentukan alur kerja aktif untuk memproses file media. Jika Anda tidak menentukan alur kerja atau menentukan alur kerja dalam status lain, informasi media tidak akan diperoleh.

Batas QPS

Batas QPS untuk satu pengguna untuk operasi ini adalah 100 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan benar. Untuk informasi lebih lanjut, lihat Batas QPS.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

mts:AddMedia

create

*Semua resource.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
FileURL	string	Yes	Jalur file input. Anda dapat memperoleh jalur dari Konsol ApsaraVideo Media Processing atau Konsol OSS. Untuk aturan pemicu terperinci, lihat Aturan pencocokan pemicu alur kerja di bawah ini. Hanya alamat HTTP OSS yang didukung. Alamat CDN dan alamat HTTPS tidak didukung. Nilai tidak boleh melebihi 3.200 byte. URL harus mematuhi RFC 2396 (dienkode UTF-8 dan dienkode URL). Untuk informasi lebih lanjut, lihat Pengodean URL.	http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4
Title	string	No	Judul media. Nilai tidak boleh melebihi 128 byte. Dienkode UTF-8.	mytest
Description	string	No	Deskripsi. Nilai tidak boleh melebihi 1.024 byte. Dienkode UTF-8.	A test video
CoverURL	string	No	URL sampul. Ini adalah alamat penyimpanan sampul yang ingin Anda atur. Anda dapat memperoleh alamat dari Konsol ApsaraVideo Media Processing > Manajemen Alur Kerja > Bucket Media atau Konsol OSS > Jalur Akses Saya. Nilai tidak boleh melebihi 3.200 byte. URL harus mematuhi RFC 2396 (dienkode UTF-8 dan dienkode URL). Untuk informasi lebih lanjut, lihat Pengodean URL.	http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png
Tags	string	No	Daftar tag. Catatan Di ApsaraVideo Media Processing, setiap tag dari setiap media bersifat independen. Anda dapat mencari Pustaka Media untuk menemukan semua media yang memiliki tag yang sama. Pisahkan beberapa tag dengan koma (,). Maksimal 16 tag didukung. Setiap tag tidak boleh melebihi 32 byte. Dienkode UTF-8.	tag1,tag2
MediaWorkflowId	string	No	ID alur kerja media. Anda dapat memperoleh ID dari Konsol ApsaraVideo Media Processing atau dengan memanggil operasi AddMediaWorkflow. Catatan Parameter ini adalah Tugas asinkron. Setelah dikirimkan, tugas tidak segera selesai dan dimasukkan ke dalam antrean untuk eksekusi asinkron di latar belakang.	07da6c65da7f458997336e0de192****
MediaWorkflowUserData	string	No	Data kustom alur kerja media. Nilai tidak boleh melebihi 1.024 byte. Dienkode UTF-8.	test
InputUnbind	boolean	No	Apakah akan memeriksa bahwa alur kerja yang ditentukan mendukung jalur input. Atur parameter ini ke true untuk menghindari kesalahan yang disebabkan oleh jalur yang salah. Nilai valid: true: Periksa. false: Jangan periksa.	false
CateId	integer	No	ID kategori media. Nilai negatif tidak diperbolehkan.	123
OverrideParams	string	No	Parameter penggantian. Contoh 1: Penggantian teks terjemahan Pengemasan HLS `{"WebVTTSubtitleOverrides",[{"RefActivityName":"subtitleNode","WebVTTSubtitleURL":"http://test.oss-cn-hangzhou.aliyuncs.com/example1.vtt"}]}`. Contoh 2: Penggantian teks terjemahan Pengemasan DASH `{"subtitleTransNodeName":{"InputConfig":{"Format":"stl","InputFile":{"URL":"http://subtitleBucket.oss-cn-hangzhou.aliyuncs.com/package/example/CENG.stl"}}}}`.	{“subtitleTransNodeName”:{“InputConfig”:{“Format”:”stl”,”InputFile”:{“URL”:”http://exampleBucket.oss-cn-hangzhou.aliyuncs.com/package/example/CENG.stl"}}}}

Aturan pencocokan pemicu alur kerja

Kebijakan eksekusi pencocokan aturan adalah sebagai berikut: berdasarkan jalur file baru, sistem memeriksa lokasi yang terikat pada alur kerja. Jika jalur file baru berisi string yang terikat pada aturan, aturan tersebut cocok. Jika tidak, aturan tidak cocok. Misalnya, untuk http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv, aturannya adalah:

1、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/          Cocok
2、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/            Cocok
3、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/              Cocok
4、http://bucket.oss-cn-hangzhou.aliyuncs.com/                Cocok
5、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.flv  Cocok
6、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/CC/         Tidak cocok
7、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B2/           Tidak cocok
8、http://bucket.oss-cn-hangzhou.aliyuncs.com/A2/B/C/         Tidak cocok

Catatan

Saat Anda menambahkan alur kerja media, jangan mengonfigurasi jalur input satu alur kerja sebagai awalan dari jalur input alur kerja lainnya. Jika tidak, satu file inkremental akan memicu dua instans eksekusi alur kerja. Misalnya, jika jalur input dari dua alur kerja dikonfigurasi sebagai test dan test1, ketika file input diunggah ke folder test1, file tersebut juga cocok dengan awalan test, sehingga memicu dua instans eksekusi alur kerja.

Mencocokkan ekstensi nama file

Pemicu memerlukan file multimedia. Pustaka Media menentukan jenis file berdasarkan ekstensi nama file. File 要么 tidak memiliki ekstensi nama file (nama file tidak mengandung pemisah ekstensi ".") atau memiliki ekstensi nama file yang mematuhi aturan berikut:

Catatan

Untuk file SWF, kualitas layanan snapshot dan transkoding tidak dijamin.

Tipe	Ekstensi
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, ts, vob, wmv, webm
Audio	aac, ac3, acm, amr, ape, caf, flac, m4a, mp3, ra, wav, wma, aiff

Pesan alur kerja media

Alur kerja media menggunakan Alibaba Cloud Simple Message Queue (sebelumnya MNS) untuk mengirim pesan kepada konsumen layanan cloud video. Alur kerja media mengirim pesan ketika node aktivitas Start atau Report selesai. Untuk menerima pesan, atur nama antrean atau notifikasi pada aktivitas Start. Pesan yang dihasilkan oleh alur kerja media disimpan dalam antrean atau notifikasi. Anda dapat menggunakan SDK Simple Message Queue (sebelumnya MNS) untuk mengambil pesan. Spesifikasi pesan adalah sebagai berikut:

Nama	Tipe	Deskripsi
RunId	String	ID eksekusi alur kerja.
Name	String	Nama aktivitas.
Type	String	Tipe aktivitas. Nilai valid: Report, Start.
State	String	Status aktivitas. Nilai valid: Fail, Success.
Code	String	Kode error. Kode error spesifik dikembalikan jika status aktivitas adalah Fail.
Message	String	Pesan error. Deskripsi error terperinci dikembalikan jika status aktivitas adalah Fail.
MediaWorkflowExecution	MediaWorkflowExecution	Informasi eksekusi alur kerja media.

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	05F8B913-E9F3-4A6F-9922-48CADA0FFAAD
Media	object	Informasi media.
CreationTime	string	Waktu pembuatan.	2016-09-20T03:02:40Z
CateId	integer	ID kategori.	1
Height	string	Tinggi file media.	1280
CensorState	string	Status moderasi video. Nilai valid: Initiated: Dimulai. Video telah diunggah tetapi moderasi belum selesai. Pass: Lulus. Video telah diunggah dan telah lulus moderasi.	Initiated
Tags	object
Tag	array	Tag.
	string	Daftar tag.	tag,tag2
Bitrate	string	Laju bit.	1148.77
MediaId	string	ID media.	3e6149d5a8c944c09b1a8d2dc3e4****
File	object	File asli.
State	string	Status file. Nilai default adalah Normal.	Normal
URL	string	URL file.	http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4
PublishState	string	Status publikasi media, yang menunjukkan apakah media dipublikasikan secara eksternal. Nilai valid: Initiated: Dimulai. UnPublish: Tidak dipublikasikan. Izin file pemutaran OSS adalah Private. Published: Dipublikasikan. Izin file pemutaran OSS adalah Default.	Published
Description	string	Deskripsi. Nilai tidak boleh melebihi 1.024 byte.	A test video
Width	string	Lebar file media.	1280
Size	string	Ukuran file media.	379860
CoverURL	string	URL sampul.	http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png
RunIdList	object
RunId	array	Daftar ID instans eksekusi alur kerja media.
	string	Daftar ID instans eksekusi alur kerja media yang telah dieksekusi, dipisahkan dengan koma (,).	{"RunId":["cbad98d35629470fa05ff393d347****"]}
Duration	string	Durasi file media.	2.645333
Fps	string	Laju frame file media.	25.0
Title	string	Judul media. Nilai tidak boleh melebihi 128 byte.	mytest.mp4
Format	string	Format. Format yang didukung: mov, mp4, m4a, 3gp, 3g2, dan mj2.	mp4

Contoh

Respons sukses

JSONformat

{
  "RequestId": "05F8B913-E9F3-4A6F-9922-48CADA0FFAAD",
  "Media": {
    "CreationTime": "2016-09-20T03:02:40Z",
    "CateId": 1,
    "Height": "1280",
    "CensorState": "Initiated",
    "Tags": {
      "Tag": [
        "tag,tag2"
      ]
    },
    "Bitrate": "1148.77",
    "MediaId": "3e6149d5a8c944c09b1a8d2dc3e4****",
    "File": {
      "State": "Normal",
      "URL": "http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4"
    },
    "PublishState": "Published",
    "Description": "A test video",
    "Width": "1280",
    "Size": "379860",
    "CoverURL": "http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png",
    "RunIdList": {
      "RunId": [
        "{\"RunId\":[\"cbad98d35629470fa05ff393d347****\"]}"
      ]
    },
    "Duration": "2.645333",
    "Fps": "25.0",
    "Title": "mytest.mp4",
    "Format": "mp4"
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.