Ikhtisar unggah media - ApsaraVideo VOD

Unggah media adalah proses mendaftarkan sumber daya media ke ApsaraVideo VOD, yang merupakan prasyarat untuk menggunakan layanan ApsaraVideo VOD lainnya seperti manajemen aset media, pemrosesan media, serta pengiriman dan pemutaran konten. Topik ini menjelaskan format media yang didukung, metode unggah, pengaturan unggah, dan catatan penggunaan untuk aset media di ApsaraVideo VOD.

Format media yang didukung

ApsaraVideo VOD memungkinkan Anda mengunggah berbagai file media, seperti video, audio, citra, serta aset media pendukung termasuk file watermark, subtitle, dan materi. File tersebut dapat berupa file lokal atau file daring (diunggah melalui URL). Tabel berikut menjelaskan format file yang didukung untuk setiap jenis aset media.

Catatan

Ekstensi nama file harus disertakan dalam path file media yang diunggah ke ApsaraVideo VOD. Ekstensi tidak peka huruf besar/kecil; misalnya, MP4 dan mp4 keduanya valid.

Jenis media	Format file yang didukung
Video	Format MPEG: MP4, TS, 3GP, MPG, MPEG, MPE, DAT, VOB, dan ASF. 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 Saat Anda mengunggah file M3U8 melalui konsol ApsaraVideo VOD, Anda hanya dapat menggunakan metode unggah URL. Untuk file M3U8 lokal, Anda dapat menggunakan API atau SDK ApsaraVideo VOD untuk mengunggahnya. Untuk informasi selengkapnya, lihat Unggah file media menggunakan API ApsaraVideo VOD. Format lainnya: 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.
Citra	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 materi: JPG, GIF, PNG, MP4, MAT, dan ZIP.

Catatan

Anda hanya dapat mengunggah jenis aset media yang disebutkan di atas ke ApsaraVideo VOD. Untuk jenis file lainnya, ikuti langkah-langkah yang disediakan di Unggah file ke OSS.

Metode unggah

ApsaraVideo VOD menyediakan metode unggah manual dan otomatis untuk berbagai skenario.

	Metode unggah	Skenario	Deskripsi
Unggah manual	Unggah file melalui konsol ApsaraVideo VOD	Konsol ApsaraVideo VOD merupakan metode cepat dan praktis untuk mengunggah file media. Catatan Durasi sesi konsol dikendalikan oleh kebijakan keamanan. Saat mengunggah file besar yang memerlukan waktu lama, sesi konsol mungkin kedaluwarsa sebelum unggah selesai. Dalam kasus ini, kami menyarankan menggunakan klien PC untuk mengunggah file besar.	Setelah mengaktifkan ApsaraVideo VOD, Anda dapat masuk ke konsol ApsaraVideo VOD melalui browser untuk mengunggah file media. Anda dapat mengunggah file audio dan video dari perangkat lokal atau menggunakan URL file tersebut.
Unggah manual	Unggah file menggunakan klien Windows	Klien PC cocok untuk mengunggah file besar yang memerlukan waktu lama atau skenario tanpa persyaratan produksi ketat.	Anda harus mengunduh dan menginstal klien PC. ApsaraVideo VOD menyediakan klien PC untuk sistem operasi Windows. Hanya file lokal yang dapat diunggah.
Integrasi Program	Unggah file menggunakan SDK unggah	Skenario yang memerlukan unggah otomatis atau pengunggahan banyak file video. Skenario pengunggahan file media daring. Catatan Kami menyarankan menggunakan SDK unggah untuk mengunggah file media. Jika SDK unggah ApsaraVideo VOD tidak mendukung bahasa pemrograman pilihan Anda, Anda dapat menggunakan SDK OSS.	SDK unggah server mengenkapsulasi logika mendapatkan kredensial dan URL unggah di ApsaraVideo VOD serta kemampuan unggah OSS. Anda dapat mengimplementasikan fitur unggah dengan konfigurasi sederhana. Didukung untuk Java, Python, PHP, dan C/C++.
	Unggah file menggunakan SDK OSS	Skenario yang memerlukan unggah otomatis atau pengunggahan banyak file video. Skenario pengunggahan file media daring.	Jika menggunakan SDK OSS, Anda harus mengimplementasikan seluruh logika unggah, termasuk mendapatkan URL dan kredensial unggah dari ApsaraVideo VOD, mendekode Base64 kredensial dan URL unggah, serta memanggil kemampuan OSS untuk menyelesaikan unggah. SDK OSS mendukung bahasa pemrograman Java, Python, PHP, .NET, Node.js, C, C++, dan Go. Catatan Kami menyarankan menggunakan SDK unggah jika Anda menggunakan bahasa pemrograman Java, Python, PHP, C, atau C++.
	Unggah file berdasarkan URL	Skenario pengunggahan file yang tidak disimpan di server atau terminal lokal Anda tetapi dapat diakses melalui URL publik.	Anda hanya dapat mengunggah file ke wilayah Tiongkok (Shanghai) dan Singapura. Anda tidak dapat mengunggah file lokal.

Perbandingan fitur yang didukung oleh berbagai metode unggah

Tabel berikut menjelaskan fitur-fitur yang didukung oleh berbagai metode unggah selama proses unggah:

Grup	Fitur	Konsol	Klien PC	Unggah dari server	Unggah dari klien	UploadMediaByURL	Unggah file menggunakan SDK OSS	Unggah file ke OSS
Manajemen Sumber Daya	Atur judul aset media	Dukungan	Dukungan	Dukungan	Dukungan	Dukungan	Dukungan	Dukungan
	Atur kategori aset media	Dukungan	Dukungan	Dukungan	Dukungan	Didukung	Dukungan	Dukungan
	Atur tag aset media	Tidak didukung	Dukungan	Dukungan	Dukungan	Didukung	Dukungan	Dukungan
	Atur gambar mini file video	Tidak didukung	Tidak didukung	Dukungan	Dukungan	Didukung	Dukungan	Didukung
Transkoding audio dan video^①	Kelompok templat transkoding	Dukungan	Dukungan	Didukung	Dukungan	Dukungan	Dukungan	Dukungan
	Alur kerja	Didukung	Tidak didukung	Dukungan	Dukungan	Dukungan	Dukungan	Dukungan
	Nonaktifkan transkoding	Dukungan	Dukungan	Dukungan	Dukungan	Dukungan	Dukungan	Dukungan
Kontrol unggah^②	Dapatkan progres unggah	Didukung	Dukungan	Dukungan	Dukungan	Dukungan	Dukungan	Dukungan
	Lakukan unggah yang dapat dilanjutkan	Tidak didukung	Tidak didukung	Hanya SDK unggah untuk Java yang mendukung fitur ini	Dukungan	Tidak didukung	Hanya SDK OSS untuk Java yang mendukung fitur ini	Tidak didukung
	Lakukan 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^①

Anda dapat menentukan kelompok templat transkoding atau alur kerja media untuk mentranskode file audio dan video saat mengonfigurasi pengaturan unggah. Transkoding akan dipicu secara otomatis setelah unggah selesai. Anda juga dapat menonaktifkan transkoding. Namun, perhatikan bahwa hanya file dalam format berikut yang dapat diputar tanpa transkoding: MP4, FLV, M3U8, MP3, dan WEBM.

Tentukan kelompok templat transkoding: Menentukan kelompok templat transkoding adalah metode pemrosesan default ApsaraVideo VOD. Anda dapat memilih Kelompok Templat Transkoding saat mengonfigurasi pengaturan unggah. Transkoding akan dipicu secara otomatis setelah unggah selesai.
Tentukan alur kerja media: Setelah membuat alur kerja media yang berisi tugas transkoding, Anda dapat memilih Alur Kerja Media saat mengonfigurasi pengaturan unggah. Setelah unggah selesai, ApsaraVideo VOD akan menjalankan alur kerja media yang ditentukan secara otomatis untuk menyelesaikan pekerjaan transkoding.
Nonaktifkan transkoding: Jika tidak perlu mentranskode file selama unggah, Anda dapat memilih templat Tanpa Transkoding dalam kelompok templat transkoding.

Kontrol unggah^②

Lakukan unggah multi-bagian: ApsaraVideo VOD membagi file media menjadi beberapa bagian selama unggah dan menggabungkan bagian-bagian yang telah diunggah setelah unggah selesai. Secara default, semua file media diunggah ke ApsaraVideo VOD dalam mode unggah multi-bagian.
Catatan
Selama unggah multi-bagian, bagian-bagian yang tidak berguna mungkin tetap tersimpan jika unggah gagal. Bagian-bagian tersebut akan dihapus secara otomatis setelah tujuh hari. Anda juga dapat memanggil operasi DeleteMultipartUpload untuk menghapus bagian-bagian yang tidak berguna secara manual.
Dapatkan progres dan status unggah.
Lakukan unggah yang dapat dilanjutkan. Jika unggah file media gagal karena kesalahan jaringan, ApsaraVideo VOD akan melanjutkan unggah dari bagian terakhir yang berhasil diunggah.
Catatan
Unggah yang dapat dilanjutkan diimplementasikan di dalam SDK unggah klien. Jika unggah file media gagal karena pengecualian, unggah akan dilanjutkan dari posisi yang telah dicatat tanpa campur tangan pengguna.

Penyimpanan

Wilayah penyimpanan

ApsaraVideo VOD menyimpan aset media di Object Storage Service (OSS). Node penyimpanan ApsaraVideo VOD tersebar secara global. Setiap node penyimpanan mewakili sebuah wilayah penyimpanan, yang diberikan alamat penyimpanan oleh ApsaraVideo VOD.

Alamat penyimpanan

Catatan

ApsaraVideo VOD tidak mengizinkan akses data lintas wilayah, bahkan jika data tersebut dimiliki oleh akun yang sama. Sebelum mengunggah file media, pastikan Anda mengunggah ke wilayah tempat bisnis Anda berada. Jika tidak, Anda mungkin tidak dapat menggunakan file media di lokasi yang dimaksud.

Pengaturan alamat penyimpanan	Deskripsi
Aktifkan alamat penyimpanan sistem VOD	Setelah Anda mengaktifkan ApsaraVideo VOD, Anda akan diberikan bucket independen di setiap wilayah. Anda harus mengaktifkan bucket tersebut sebelum dapat mengunggah dan mengelola sumber daya media di suatu wilayah. Tidak diperlukan konfigurasi lainnya. Untuk informasi selengkapnya, lihat Kelola bucket penyimpanan.
Tambahkan alamat penyimpanan	Anda dapat menambahkan bucket OSS ke ApsaraVideo VOD. Dengan cara ini, Anda dapat melakukan operasi seperti transkoding, pengambilan snapshot, dan pemutaran pada file media yang disimpan di bucket OSS tersebut. Untuk informasi selengkapnya, lihat Kelola bucket penyimpanan.
Ubah alamat penyimpanan default	Setelah Anda mengaktifkan alamat penyimpanan di beberapa wilayah, Anda dapat mengubah alamat penyimpanan default. Anda dapat menentukan alamat penyimpanan untuk file media yang akan diunggah. Jika Anda tidak menentukan alamat penyimpanan, file media akan diunggah ke alamat penyimpanan default. Untuk informasi selengkapnya, lihat Kelola bucket penyimpanan.

Tabel berikut menjelaskan wilayah penyimpanan yang didukung oleh ApsaraVideo VOD dan ID wilayah yang sesuai.

Catatan

Unggah tarik berbasis URL: Saat mengunggah file media menggunakan konsol ApsaraVideo VOD atau klien PC, sistem menggunakan alamat penyimpanan di wilayah tempat Anda mengakses layanan ApsaraVideo VOD. Saat mengunggah file media menggunakan SDK atau operasi API, Anda dapat menentukan alamat penyimpanan melalui parameter, seperti parameter StorageLocation dalam operasi UploadMediaByURL.

Wilayah penyimpanan	ID Wilayah
Tiongkok (Shanghai)	cn-shanghai
Tiongkok (Beijing)	cn-beijing
Tiongkok (Shenzhen)	cn-shenzhen
Tiongkok (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 untuk data yang disimpan

ApsaraVideo VOD menagih Anda atas sumber daya penyimpanan yang digunakan berdasarkan metode penagihan bayar sesuai penggunaan atau langganan (paket sumber daya).

Untuk informasi selengkapnya tentang penagihan bayar sesuai penggunaan, lihat Penagihan untuk penyimpanan aset media.
Untuk informasi selengkapnya tentang paket sumber daya, lihat Paket penyimpanan ApsaraVideo VOD.

Notifikasi event unggah

Anda dapat mengonfigurasi callback untuk menerima notifikasi event mengenai progres dan status unggah setelah mengunggah file media. ApsaraVideo VOD memungkinkan Anda mengonfigurasi callback HTTP atau HTTPS dan Message Service (MNS) untuk mendapatkan notifikasi event. Untuk informasi selengkapnya tentang callback, lihat Notifikasi event. Untuk informasi selengkapnya tentang cara mengonfigurasi callback, lihat Konfigurasi callback. Semua metode unggah mendukung notifikasi event. Tabel berikut menjelaskan event unggah.

Catatan

Untuk informasi selengkapnya tentang setiap event, lihat Notifikasi event.

Nama event	Jenis event	Deskripsi
FileUploadComplete	FileUploadComplete	Event FileUploadComplete dihasilkan saat unggah file audio dan video selesai. Catatan Untuk file audio dan video yang tidak ditranskode, Anda dapat memperoleh URL pemutaran setelah menerima notifikasi event FileUploadComplete. Jika Anda menonaktifkan transkoding selama unggah, Anda dapat memanggil operasi SubmitTranscodeJobs untuk mentranskode file tersebut setelah menerima notifikasi event FileUploadComplete.
ImageUploadComplete	ImageUploadComplete	Event ImageUploadComplete dihasilkan saat unggah file citra selesai.
AttachedMediaUploadComplete	AttachedMediaUploadComplete	Event AttachedMediaUploadComplete dihasilkan saat unggah aset media pendukung selesai.
UploadByURLComplete	UploadByURLComplete	Event UploadByURLComplete dihasilkan setelah Anda memanggil operasi UploadMediaByURL untuk mengunggah video berdasarkan URL.
StreamTranscodeComplete	StreamTranscodeComplete	Event StreamTranscodeComplete dihasilkan saat aliran video ditranskode ke definisi dan format tertentu, seperti aliran SD dalam format MP4. Catatan Untuk file audio dan video yang telah ditranskode, Anda dapat memperoleh URL pemutaran setelah menerima notifikasi event StreamTranscodeComplete. Kegagalan pemutaran dapat terjadi jika Anda memutar file video sebelum menerima callback.
TranscodeComplete	TranscodeComplete	Event TranscodeComplete dihasilkan saat semua aliran yang telah dikodekan ulang dari video telah dihasilkan. Catatan Jika Anda ingin memastikan bahwa semua definisi tersedia sebelum pemutaran, Anda dapat menunggu hingga menerima notifikasi event TranscodeComplete. Kegagalan pemutaran dapat terjadi jika Anda memutar file audio atau video sebelum menerima callback.

Otorisasi unggah

Dalam skenario unggah pengembang, Anda dapat menggunakan kredensial unggah atau token Security Token Service (STS) untuk menyelesaikan masalah otorisasi dan keamanan selama unggah, sehingga mencegah unggah dan pemutaran file media yang tidak sah.

Untuk informasi selengkapnya tentang skenario penerapan kedua metode tersebut, lihat Perbandingan antara kredensial unggah dan token STS.
Untuk informasi selengkapnya, lihat dokumen operasi untuk setiap metode unggah pengembang.
Sejak 31 Januari 2024, Anda tidak dapat lagi memodifikasi daftar kontrol akses (ACL) file di ApsaraVideo VOD dengan menentukan parameter x-oss-object-acl di OSS. Hal ini bertujuan mencegah masalah akibat pengunggahan file yang dapat diakses publik, seperti kebocoran data dan biaya tinggi tak terduga akibat permintaan jahat. Anda dapat melakukan langkah-langkah berikut untuk melarang pengunggahan objek yang daftar kontrol aksesnya (ACL) bersifat baca-publik:
1. Otorisasi ApsaraVideo VOD untuk mengakses sumber daya OSS Anda. Klik Otorisasi Akses Sumber Daya Cloud untuk memberikan otorisasi.
2. Buat kebijakan kustom untuk melarang pengunggahan objek yang ACL-nya bersifat baca-publik ke bucket OSS. Untuk informasi selengkapnya tentang operasi dan isi kebijakan, lihat Larang pengunggahan objek yang ACL-nya bersifat baca-publik ke bucket OSS.
3. Berikan izin melarang pengunggahan file dengan izin ACL Objek yang diatur ke baca-publik ke bucket OSS milik sendiri yang dibuat pada langkah sebelumnya kepada peran AliyunVODDefaultRole.
  Masuk ke Konsol RAM untuk memberikan otorisasi. Untuk informasi selengkapnya, lihat Berikan izin kepada Pengguna RAM.

Akselerasi unggah

ApsaraVideo VOD menyediakan fitur akselerasi unggah untuk mempercepat transfer file jarak jauh dan unggah file berukuran gigabyte atau terabyte. Akselerasi unggah cocok untuk unggah lintas wilayah, seperti mengunggah file dari Daratan Tiongkok ke wilayah Singapura.

Aktivasi

Untuk mengaktifkan fitur akselerasi unggah, kirim tiket. Anda perlu memberikan Alibaba Cloud Account UID dan Storage Address yang ingin Anda aktifkan fitur akselerasi unggahnya.

Penagihan

Anda akan dikenai biaya untuk menggunakan fitur akselerasi unggah, yang merupakan fitur bernilai tambah yang disediakan oleh ApsaraVideo VOD. Untuk informasi selengkapnya tentang penagihan, lihat Penagihan untuk akselerasi transfer.

Catatan

Tidak ada biaya yang dikenakan jika Anda mengaktifkan akselerasi unggah tetapi tidak menggunakannya.

Batasan

Hanya mengunggah file melalui konsol ApsaraVideo VOD yang tidak mendukung akselerasi unggah. Semua metode unggah lainnya mendukung akselerasi unggah.

Langkah selanjutnya

Catatan

Setelah file media diunggah ke ApsaraVideo VOD, file tersebut berada dalam status yang berbeda-beda berdasarkan progres pemrosesan. File media dalam status yang berbeda mendukung operasi yang berbeda di ApsaraVideo VOD. Misalnya, file audio dan video dalam status Mengunggah, Unggah Gagal, atau Diblokir hanya dapat dihapus. Anda tidak dapat melakukan operasi lain seperti transkoding, pengambilan snapshot, dan tinjauan media pada file-file tersebut. File audio dan video dalam status Normal mendukung semua operasi, termasuk transkoding, pengambilan snapshot, tinjauan media, dan pemutaran. Untuk informasi selengkapnya tentang status media, lihat Status: status video dan Status: status citra.

Tabel berikut menjelaskan catatan penggunaan untuk fitur-fitur ApsaraVideo VOD yang terkait dengan file media yang telah diunggah.

Layanan ApsaraVideo VOD	Deskripsi	Referensi
Manajemen aset media (setelah unggah)	Anda dapat mengelola file media yang telah diunggah seperti file video sumber, file aliran yang telah dikodekan ulang, dan file citra di ApsaraVideo VOD.	Manajemen aset media
Pemrosesan media	ApsaraVideo VOD mendukung transkoding audio dan video, tinjauan otomatis, pengeditan daring, dan pemrosesan AI untuk file media yang telah diunggah. Catatan ApsaraVideo VOD secara otomatis mengekstrak metadata (seperti resolusi video, durasi, dan bitrate) dari file audio dan video yang diunggah. Untuk video, ApsaraVideo VOD juga secara otomatis mengambil gambar mini dan sprite. Operasi pra-pemrosesan ini tidak dikenai biaya.	Pemrosesan media
Pemutaran audio dan video	Setelah file audio dan video diunggah, file tersebut belum siap langsung untuk diputar. ApsaraVideo VOD perlu memastikan bahwa file audio dan video telah diterima. Anda dapat menentukan apakah file audio dan video siap untuk diputar dengan memeriksa notifikasi event. Untuk file audio dan video yang tidak ditranskode, Anda dapat memperoleh URL pemutaran setelah menerima notifikasi event FileUploadComplete. Untuk file audio dan video yang telah ditranskode, Anda dapat memperoleh URL pemutaran setelah menerima notifikasi event StreamTranscodeComplete. Jika Anda ingin memastikan bahwa semua definisi tersedia sebelum pemutaran, Anda dapat menunggu hingga menerima notifikasi event TranscodeComplete.	Terima notifikasi event seperti FileUploadComplete. Panggil GetPlayInfo untuk memperoleh URL pemutaran file audio atau video.