Ikhtisar unggah media - ApsaraVideo VOD - ApsaraVideo VOD

Unggah media mendaftarkan resource media ke ApsaraVideo VOD sehingga memungkinkan layanan downstream seperti manajemen aset media, pemrosesan media, dan pengiriman konten. Topik ini mencakup format yang didukung, metode unggah, pengaturan penyimpanan, dan alur kerja pasca-unggah.

Format media yang didukung

ApsaraVideo VOD mendukung pengunggahan video, audio, gambar, dan aset media pendukung (watermark, subtitle, dan file material). File dapat berupa lokal atau online (diunggah dari URL).

Catatan

Ekstensi file wajib disertakan. Ekstensi tidak peka huruf besar/kecil — MP4 dan mp4 setara.

Jenis media	Format file
Video	Format MPEG: MP4, TS, 3GP, MPG, MPEG, MPE, DAT, VOB, ASF, dan lainnya. Format AVI: AVI. Format Windows Media Video: WMV dan ASF. Format Flash Video: FLV dan F4V. Format Real Video: RM dan RMVB. Format QuickTime: MOV. Format Matroska: MKV. Format HLS: M3U8. Catatan Konsol hanya mendukung unggah M3U8 dari URL. Untuk mengunggah file M3U8 lokal, gunakan API atau SDK. Unggah file media menggunakan API ApsaraVideo VOD. Format lain: DV, GIF, M2T, M4V, MJ2, MJPEG, MTS, OGG, QT, SWF, dan WEBM.
Audio	MP3, WMA, WAV, AAC, RA, M4A, FLAC, APE, AC3, AMR, CAF, dan ACM.
Gambar	PNG, JPG, JPEG, GIF, dan HEIC.
Aset media pendukung	File watermark: PNG, GIF, APNG, dan MOV. File subtitle: SRT, ASS, STL, TTML, dan VTT. File material: JPG, GIF, PNG, MP4, MAT, dan ZIP.

Catatan

ApsaraVideo VOD hanya menerima jenis file yang tercantum di atas. Untuk jenis lain, Unggah file ke OSS.

Metode unggah

ApsaraVideo VOD menyediakan metode unggah manual dan terprogram.

	Metode unggah	Kasus Penggunaan	Deskripsi
Unggah manual	Unggah file menggunakan konsol ApsaraVideo VOD	Unggah aset media yang cepat dan mudah. Catatan Unggah file besar melalui konsol dapat gagal jika sesi Anda kedaluwarsa. Gunakan klien PC untuk file besar.	Login ke konsol ApsaraVideo VOD untuk mengunggah file media setelah mengaktifkan layanan. Mendukung pengunggahan audio dan video dari file lokal atau URL.
Unggah manual	Unggah file menggunakan klien Windows	Unggah file besar dan tugas unggah berdurasi panjang.	Perlu mengunduh dan menginstal. Hanya tersedia klien Windows. Hanya mendukung unggah file lokal.
Integrasi Program	Unggah file menggunakan SDK unggah	Untuk unggah otomatis dan migrasi video skala besar. Untuk mengunggah file media online. Catatan Gunakan SDK unggah jika memungkinkan. Jika SDK yang disediakan tidak mendukung bahasa Anda, gunakan SDK native OSS sebagai gantinya.	SDK unggah sisi server mengenkapsulasi mendapatkan kredensial unggah dan URL unggah serta mengintegrasikan kemampuan unggah OSS. Memerlukan konfigurasi minimal. Bahasa yang didukung meliputi Java, Python, PHP, dan C/C++.
	Unggah file menggunakan SDK OSS	Untuk unggah otomatis dan migrasi video skala besar. Untuk mengunggah file media online.	Dengan SDK native OSS, Anda harus mengimplementasikan logika unggah lengkap: memperoleh URL dan kredensial unggah dari ApsaraVideo VOD, mendekode Base64-nya, lalu memanggil operasi OSS untuk menyelesaikan unggah. Bahasa yang didukung meliputi Java, Python, PHP, .NET, Go, Node.js, dan C/C++. Catatan Untuk Java, Python, PHP, dan C/C++, gunakan SDK unggah ApsaraVideo VOD sebagai gantinya.
	Unggah file melalui URL	Untuk file yang dapat diakses melalui URL publik.	Anda hanya dapat mengunggah file ke wilayah China (Shanghai) dan Singapura. Metode ini tidak mendukung unggah file lokal.

Perbandingan fitur berdasarkan metode unggah

Tabel berikut membandingkan fitur unggah berdasarkan metode:

Kelompok	Fitur	Konsol	Klien PC	Upload from servers	Upload from clients	UploadMediaByURL	Upload media files using OSS SDKs	Upload OSS objects
Manajemen aset media	Judul media	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung
	Kategori media	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung
	Tag media	Tidak didukung	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung
	Gambar mini video	Tidak didukung	Tidak didukung	Didukung	Didukung	Didukung	Didukung	Didukung
Transkoding audio dan video^①	Kelompok template transkoding	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung
	Alur kerja	Didukung	Tidak didukung	Didukung	Didukung	Didukung	Didukung	Didukung
	Tidak ada transkoding	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung
Kontrol unggah^②	Progres unggah	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung	Didukung
	Unggah yang dapat dilanjutkan	Tidak didukung	Tidak didukung	Hanya didukung oleh SDK unggah sisi server untuk Java	Didukung	Tidak didukung	Hanya didukung oleh SDK OSS untuk Java	Tidak didukung
	Unggah multi-bagian	Diaktifkan secara default	Diaktifkan secara default	Diaktifkan secara default	Diaktifkan secara default	Diaktifkan secara default	Diaktifkan secara default	Diaktifkan secara default

Transkoding audio dan video^①

Konfigurasikan transkoding saat unggah dengan menentukan kelompok template transkoding atau alur kerja media. Transkoding dimulai secara otomatis setelah unggah. Anda juga dapat menonaktifkan transkoding. Namun, hanya file dalam format berikut yang dapat diputar tanpa transkoding: MP4, FLV, M3U8, MP3, dan WEBM.

Tentukan kelompok template transkoding: Pilih Transcoding Template Group saat unggah. Transkoding dimulai secara otomatis setelah unggah. Ini adalah metode default.
Tentukan alur kerja media: Buat alur kerja dengan pekerjaan transkoding, lalu pilih Media Workflow saat unggah. Alur kerja dijalankan secara otomatis setelah unggah.
Untuk menonaktifkan transkoding saat unggah, pilih template No Transcoding dalam kelompok template transkoding.

Kontrol unggah^②

Unggah multi-bagian: Membagi file menjadi bagian-bagian, mengunggahnya secara terpisah, lalu menyusunnya kembali. Diaktifkan secara default.

Catatan
Jika unggah multi-bagian gagal, bagian yang tersisa akan dihapus secara otomatis setelah tujuh hari. Untuk menghapusnya segera, panggil operasi DeleteMultipartUpload.
Monitor progres dan status unggah.
Unggah yang dapat dilanjutkan: Melanjutkan unggah yang terputus dari bagian terakhir yang berhasil diunggah.

Catatan
SDK unggah klien menyertakan fitur unggah yang dapat dilanjutkan bawaan dan secara otomatis melanjutkan dari titik putus.

Penyimpanan

Wilayah penyimpanan

ApsaraVideo VOD menggunakan Object Storage Service (OSS) untuk menyimpan aset media di seluruh node penyimpanan global. Setiap node sesuai dengan wilayah yang memiliki alamat penyimpanan khusus.

Alamat penyimpanan

Catatan

Data diisolasi berdasarkan wilayah dan tidak dibagikan lintas wilayah, bahkan dalam akun yang sama. Pastikan wilayah unggah sesuai dengan wilayah layanan yang Anda maksudkan.

Pengaturan	Deskripsi
Aktifkan alamat penyimpanan sistem VOD	Saat Anda mengaktifkan ApsaraVideo VOD, bucket penyimpanan default (bucket sistem VOD) dibuat di setiap wilayah, siap digunakan segera. Kelola bucket penyimpanan.
Tambahkan alamat penyimpanan	Tambahkan bucket OSS Anda sendiri ke ApsaraVideo VOD untuk transkoding, pengambilan snapshot, dan pemutaran file dalam bucket tersebut. Kelola bucket penyimpanan.
Ubah alamat penyimpanan default	Setelah menambahkan beberapa alamat penyimpanan, Anda dapat mengubah default-nya. Unggah akan menuju alamat default kecuali Anda menentukan sebaliknya. Kelola bucket penyimpanan.

Tabel berikut mencantumkan wilayah yang didukung dan ID-nya.

Catatan

Unggah melalui konsol dan klien PC menggunakan alamat penyimpanan wilayah yang dipilih. Unggah melalui SDK dan API menerima parameter alamat penyimpanan, seperti parameter StorageLocation dalam operasi unggah pull berbasis URL.

Wilayah	ID Wilayah
China (Shanghai)	cn-shanghai
China (Beijing)	cn-beijing
China (Shenzhen)	cn-shenzhen
China (Hong Kong)	cn-hongkong
Jepang (Tokyo)	ap-northeast-1
Singapura	ap-southeast-1
Indonesia (Jakarta)	ap-southeast-5
Jerman (Frankfurt)	eu-central-1
AS (Silicon Valley)	us-west-1

Penagihan

Penyimpanan ApsaraVideo VOD ditagih berdasarkan skema bayar sesuai penggunaan (postpaid) atau paket sumber daya (prepaid).

Bayar sesuai penggunaan: Penagihan untuk penyimpanan aset media.
Paket sumber daya: Paket penyimpanan ApsaraVideo VOD.

Notifikasi event unggah

ApsaraVideo VOD mengirim notifikasi event setelah setiap unggah melalui callback HTTP(S) atau MNS. Konfigurasikan callback untuk menerima pembaruan status pemrosesan. Tabel berikut menjelaskan event unggah.

Catatan

Detail lengkap event: Notifikasi event.

Nama event	Jenis	Deskripsi
Unggah Video Selesai	FileUploadComplete	Dipicu setelah unggah file audio atau video selesai. Catatan Untuk file audio atau video non-transkoding, URL pemutaran hanya tersedia setelah event FileUploadComplete. Jika Anda menonaktifkan transkoding saat unggah, Anda tetap dapat memanggil operasi Submit media transcoding jobs untuk mentranskode file setelah menerima notifikasi event FileUploadComplete.
Unggah Gambar Selesai	ImageUploadComplete	Dipicu setelah unggah file gambar selesai.
Unggah Media Pendukung Selesai	AttachedMediaUploadComplete	Dipicu setelah unggah aset media pendukung selesai.
Unggah Video dari URL Selesai	UploadByURLComplete	Dipicu ketika operasi UploadMediaByURL selesai menarik dan mengunggah video.
Transkoding selesai untuk satu aliran	StreamTranscodeComplete	Dipicu ketika aliran video ditranskode ke definisi dan format tertentu (misalnya, SD dalam MP4). Catatan Untuk file yang telah ditranskode, tunggu hingga event StreamTranscodeComplete sebelum mendapatkan URL pemutaran. Pemutaran dapat gagal sebelum callback ini diterima.
Transkoding Video Selesai	TranscodeComplete	Dipicu ketika semua aliran untuk video selesai ditranskode. Catatan Tunggu hingga event TranscodeComplete untuk memastikan semua definisi tersedia. Pemutaran dapat gagal sebelum callback ini.

Otorisasi unggah

Untuk unggah developer, otorisasi dengan kredensial unggah atau token Security Token Service (STS) untuk mencegah unggah berbahaya dan pemutaran tidak sah.

Perbandingan antara kredensial unggah dan token STS.
Detail otorisasi berdasarkan metode unggah:
Sejak 31 Januari 2024, ApsaraVideo VOD tidak lagi mendukung header OSS x-oss-object-acl untuk mengubah izin file. Untuk melarang unggah baca-publik ke bucket OSS ApsaraVideo VOD Anda:
1. Otorisasi ApsaraVideo VOD untuk mengakses resource OSS Anda. Klik Cloud Resource Access Authorization.
2. Buat kebijakan kustom untuk melarang mengunggah objek dengan ACL objek baca-publik ke bucket OSS Anda. Konten kebijakan dan instruksi: Larang mengunggah objek dengan ACL objek baca-publik ke bucket OSS Anda.
3. Berikan kebijakan kustom yang Anda buat pada langkah sebelumnya kepada peran AliyunVODDefaultRole.
  
  Login ke Konsol RAM untuk memberikan izin (Kelola izin pengguna RAM).
  
  Di panel navigasi kiri, klik Roles. Temukan dan klik AliyunVODDefaultRole. Di tab Permissions, klik Add Permissions. Di panel yang muncul, pilih tab Custom Policy, lalu pilih kebijakan target.

Akselerasi unggah

Akselerasi unggah meningkatkan transfer jarak jauh dan file besar (GB/TB). Ideal untuk unggah cross-region, seperti mentransfer video dari Tiongkok daratan ke bucket wilayah Singapura.

Cara mengaktifkan

Untuk mengaktifkan akselerasi unggah, submit a ticket. Berikan Account ID dan bucket yang ingin dipercepat.

Penagihan

Akselerasi unggah ditagih berdasarkan penggunaan (penagihan untuk akselerasi transfer).

Catatan

Anda tidak dikenai biaya untuk fitur ini jika tidak menggunakannya.

Batasan

Semua metode unggah mendukung akselerasi kecuali mengunggah file melalui konsol ApsaraVideo VOD.

Langkah selanjutnya

Catatan

Aset yang diunggah diberi status berdasarkan tahap pemrosesan. Aset dengan status Uploading, Upload Failed, atau Blocked hanya dapat dihapus. Aset dengan status Normal mendukung semua operasi: transkoding, pengambilan snapshot, tinjauan, dan pemutaran. Status: status video dan Status: status gambar.

Tabel berikut menjelaskan layanan pasca-unggah dan pertimbangan pemutaran.

Layanan	Deskripsi	Referensi
Manajemen aset media (pasca-unggah)	Kelola file media yang diunggah, termasuk video sumber, aliran yang telah dikodekan ulang, dan gambar.	Manajemen aset media
Pemrosesan media	Operasi pasca-unggah mencakup transkoding, tinjauan otomatis, pengeditan daring, dan pemrosesan AI. Catatan ApsaraVideo VOD secara otomatis mengekstraksi metadata (resolusi, durasi, bitrate) dan mengambil gambar mini serta sprite untuk video. Operasi pra-pemrosesan ini gratis.	Pemrosesan media
Pemutaran audio dan video	File yang diunggah tidak langsung dapat diputar. Notifikasi event memberi tahu Anda kapan file siap. File non-transkoding: URL pemutaran tersedia setelah event FileUploadComplete. File transkoding: URL pemutaran tersedia setelah event StreamTranscodeComplete. Tunggu hingga event TranscodeComplete untuk memastikan semua definisi siap.	Terima notifikasi event seperti FileUploadComplete. Panggil API untuk mendapatkan URL pemutaran audio dan video.