Unggah media mengirimkan sumber daya media Anda ke ApsaraVideo VOD dan merupakan prasyarat untuk layanan ApsaraVideo VOD lainnya, seperti pengelolaan aset media, pemrosesan media, serta pengiriman dan pemutaran. Topik ini menjelaskan hal-hal yang perlu dikonfirmasi sebelum Anda mengunggah, metode unggah yang tersedia, notifikasi event unggah, dan tindakan setelah unggah.
Sebelum Anda mengunggah
Format media yang didukung
ApsaraVideo VOD mendukung pengunggahan file media seperti video, audio, gambar, dan aset media pendukung (watermark, subtitle, dan file material). File dapat berupa file lokal atau file jaringan (file jaringan menggunakan URL pull upload). Tabel berikut mencantumkan format yang didukung untuk setiap jenis media.
Sertakan ekstensi nama file saat Anda mengunggah. Ekstensi tidak peka huruf besar/kecil. Misalnya, MP4 dan mp4 setara.
| Jenis media | Format file yang didukung |
| Video |
Catatan Untuk mengunggah file M3U8 melalui konsol ApsaraVideo VOD, Anda hanya dapat menggunakan URL pull upload. Untuk mengunggah file M3U8 lokal, gunakan API atau SDK ApsaraVideo VOD. Untuk detailnya, lihat Unggah file media menggunakan API ApsaraVideo VOD
|
| Audio | MP3, WMA, WAV, AAC, RA, M4A, FLAC, APE, AC3, AMR, CAF, ACM. |
| Gambar | PNG, JPG, JPEG, GIF, HEIC. |
| Aset media pendukung |
|
Unggah media ApsaraVideo VOD hanya mendukung jenis media yang tercantum di atas. Untuk mengunggah jenis file lain, ikuti langkah-langkah dalam Unggah file ke OSS.
Wilayah penyimpanan
ApsaraVideo VOD menyimpan sumber daya media berdasarkan Alibaba Cloud Object Storage Service (OSS). Setiap node penyimpanan merupakan wilayah penyimpanan, dan ApsaraVideo VOD menetapkan alamat penyimpanan untuk setiap wilayah penyimpanan.
Saat Anda mengunggah dari konsol ApsaraVideo VOD atau klien PC, alamat penyimpanan didasarkan pada wilayah tempat Anda login atau pilih. Saat Anda mengunggah dengan SDK atau API, Anda dapat menentukan alamat penyimpanan menggunakan parameter, seperti parameter StorageLocation pada operasi UploadMediaByURL.
ApsaraVideo VOD mendukung wilayah penyimpanan dan ID wilayah berikut:
| 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 |
Secara default, ApsaraVideo VOD tidak membagikan data lintas wilayah dalam akun yang sama. Sebelum Anda mengunggah, pastikan wilayah unggah Anda sesuai dengan wilayah bisnis aktual Anda. Jika tidak, Anda mungkin gagal menemukan file Anda.
Tentang alamat penyimpanan
| Pengaturan alamat penyimpanan yang tersedia | Deskripsi |
| Aktifkan alamat penyimpanan sistem ApsaraVideo VOD | Setelah Anda mengaktifkan ApsaraVideo VOD, setiap wilayah layanan diberi bucket penyimpanan independen (bucket sistem ApsaraVideo VOD) secara default. Aktifkan bucket ini untuk mengunggah dan mengelola sumber daya media tanpa konfigurasi tambahan. Untuk detailnya, lihat Kelola bucket penyimpanan. |
| Tambahkan alamat penyimpanan | Tambahkan bucket OSS Anda sendiri ke ApsaraVideo VOD sehingga Anda dapat melakukan transkoding, mengambil snapshot, dan memutar file media yang disimpan di bucket OSS tersebut. Untuk detailnya, lihat Kelola bucket penyimpanan. |
| Ubah alamat penyimpanan default | Setelah Anda mengaktifkan alamat penyimpanan untuk beberapa wilayah penyimpanan atau menambahkan beberapa alamat penyimpanan, Anda dapat mengubah alamat penyimpanan default. Saat Anda mengunggah file, Anda dapat menentukan alamat penyimpanan atau tidak menentukannya. Jika Anda tidak menentukannya, ApsaraVideo VOD akan menggunakan alamat penyimpanan default. Untuk detailnya, lihat Kelola bucket penyimpanan. |
Penagihan penyimpanan
Penyimpanan ApsaraVideo VOD mendukung dua metode penagihan: bayar sesuai penggunaan (postpaid) dan paket sumber daya (prepaid).
Untuk bayar sesuai penggunaan, lihat Penagihan penyimpanan aset media.
Untuk paket sumber daya, lihat Paket penyimpanan ApsaraVideo VOD.
Metode unggah
ApsaraVideo VOD menyediakan metode unggah manual dan programatik (otomatis) untuk skenario pengguna yang berbeda. Gunakan panduan berikut untuk memilih metode, dan lihat tabel ikhtisar untuk detailnya.
Unggah cepat beberapa file kecil: Gunakan konsol.
Unggah file besar atau unggah jangka panjang: Gunakan klien PC.
Unggah batch atau integrasi otomatis: Gunakan SDK unggah sisi server.
Unggah file jaringan: Gunakan URL pull upload.
| Metode unggah | Skenario | Deskripsi | |
| Unggah manual | Unggah file ke konsol ApsaraVideo VOD | Skenario yang memerlukan cara cepat dan mudah untuk mengunggah sumber daya media ke ApsaraVideo VOD. Catatan Karena kebijakan keamanan konsol, unggah jangka panjang mungkin gagal untuk file besar ketika sesi login kedaluwarsa. Untuk menghindari masalah ini, unggah file besar dengan klien PC. |
|
| Unggah file menggunakan klien Windows | File besar, unggah jangka panjang, dan skenario operasional dengan hambatan rendah. |
| |
| Integrasi programatik | Unggah menggunakan Upload SDK |
Catatan Kami merekomendasikan upload SDK. Jika upload SDK tidak mendukung bahasa Anda, Anda dapat menggunakan SDK OSS native untuk menyelesaikan unggah. |
|
| Unggah file media menggunakan SDK OSS |
|
Catatan Untuk Java, Python, PHP, dan C/C++, kami merekomendasikan SDK unggah ApsaraVideo VOD. | |
| Unggah batch dari URL | Skenario di mana file tidak disimpan di server lokal atau terminal dan harus diunggah dari URL yang dapat diakses publik. |
|
Perbandingan fitur berdasarkan metode unggah
Tabel berikut membandingkan fitur yang didukung setiap metode unggah selama proses unggah. Tanda ① dan ② berkaitan dengan penjelasan fitur setelah tabel.
| Grup | Fitur | Console | Klien PC | Server-side SDK-Java | SDK sisi server-Python | SDK sisi server-PHP | SDK sisi server-C/C++ | SDK OSS |
| Pengelolaan aset media | Atur judul media | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung |
| Tentukan kategori media | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | |
| Atur tag media | Tidak didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | |
| Atur thumbnail 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 media | Didukung | Tidak didukung | Didukung | Didukung | Didukung | Didukung | Didukung | |
| Tanpa transkoding | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | |
| Kontrol unggah② | Dapatkan progres unggah | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung |
| Unggah yang dapat dilanjutkan | Tidak didukung | Tidak didukung | Hanya didukung oleh SDK unggah Java | Didukung | Tidak didukung | Tidak didukung | 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 |
Catatan berikut menjelaskan grup fitur yang ditandai dengan ① dan ② pada tabel di atas.
Transkoding audio dan video①
Atur transkoding saat Anda mengunggah file audio atau video (dengan menentukan kelompok template transkoding atau alur kerja media), dan transkoding akan dimulai secara otomatis setelah unggah selesai. Anda juga dapat memilih untuk tidak melakukan transkoding. Namun, perhatikan bahwa Hanya video dalam format berikut yang dapat diputar tanpa transkoding: MP4, FLV, M3U8, MP3, dan WEBM.
Transkode dengan kelompok template transkoding: Menggunakan kelompok template transkoding adalah metode pemrosesan default ApsaraVideo VOD. Saat Anda mengunggah, pilih metode pemrosesan kelompok template transkoding. ApsaraVideo VOD akan secara otomatis memulai transkoding setelah unggah selesai.
Transkode dengan alur kerja media: Setelah Anda membuat alur kerja media yang berisi tugas transkoding, pilih metode pemrosesan alur kerja media saat Anda mengunggah. Setelah unggah selesai, ApsaraVideo VOD akan secara otomatis menjalankan alur kerja media yang ditentukan untuk menyelesaikan transkoding.
Tanpa transkoding: Jika Anda tidak memerlukan transkoding selama unggah, pilih template No Transcoding dalam kelompok template transkoding.
Kontrol unggah②
Unggah multi-bagian: File yang akan diunggah dibagi menjadi beberapa bagian yang diunggah secara terpisah, lalu digabung menjadi satu objek setelah unggah selesai. ApsaraVideo VOD mengunggah file menggunakan unggah multi-bagian secara default.
Saat Anda menggunakan unggah multi-bagian, jika unggah gagal, file fragmen mungkin dihasilkan. File-file ini akan dihapus secara otomatis setelah sekitar tujuh hari. Anda juga dapat memanggil operasi DeleteMultipartUpload untuk menghapus file fragmen secara manual.
Dapatkan progres atau status unggah.
Unggah yang dapat dilanjutkan: Jika kesalahan jaringan menyebabkan unggah gagal, ApsaraVideo VOD dapat melanjutkan unggah dari bagian terakhir yang berhasil diunggah, sehingga mencapai unggah yang dapat dilanjutkan.
Unggah yang dapat dilanjutkan ditangani secara internal oleh SDK unggah (klien). Anda tidak perlu mengelola titik putus atau pemulihan fragmen, karena unggah ulang setelah kegagalan akibat pengecualian akan dimulai dari titik putus.
Notifikasi event unggah
Setelah unggah file media selesai, Anda dapat memperoleh progres dan status pemrosesan secara tepat waktu melalui alamat callback yang telah dikonfigurasi sebelumnya. ApsaraVideo VOD mendukung dua metode callback untuk notifikasi event: callback HTTP (kompatibel HTTPS) dan callback Message Service (MNS). Untuk mempelajari konfigurasi callback, lihat Notifikasi event. Untuk menyelesaikan konfigurasi callback, lihat Konfigurasi callback. Semua metode unggah mendukung notifikasi event unggah. Event terkait unggah tercantum dalam tabel berikut.
Untuk detail setiap event, lihat Notifikasi event.
| Nama event | Jenis peristiwa | Deskripsi |
| Video Upload Complete | FileUploadComplete | Dihasilkan setelah server ApsaraVideo VOD selesai menerima file audio atau video yang diunggah. Catatan Untuk audio dan video tanpa transkoding (atau audio), Anda hanya dapat memperoleh URL pemutaran setelah menerima notifikasi event Video Upload Complete. Jika Anda menonaktifkan transkoding selama unggah, setelah menerima notifikasi event Video Upload Complete, Anda dapat memanggil operasi Submit media transcoding jobs untuk melakukan transkoding. |
| Image Upload Complete | ImageUploadComplete | Dihasilkan setelah server ApsaraVideo VOD selesai menerima file gambar yang diunggah. |
| Auxiliary Media Upload Complete | AttachedMediaUploadComplete | Dihasilkan setelah server ApsaraVideo VOD selesai menerima file aset media pendukung yang diunggah. |
| Video Upload from URL Complete | UploadByURLComplete | Setelah Anda memanggil tugas Unggah file media melalui URL, event UploadByURLComplete dihasilkan ketika cloud selesai menarik dan mengunggah video. |
| Stream Transcode Complete | StreamTranscodeComplete | Dihasilkan ketika aliran video dengan definisi dan format tertentu (misalnya, file MP4 dalam definisi standar) selesai ditranskode. Catatan Untuk audio dan video yang ditranskode, Anda hanya dapat memperoleh URL pemutaran setelah menerima notifikasi event Stream Transcode Complete. Memutar sebelum menerima callback dapat menyebabkan pemutaran gagal. |
| Video Transcode Complete | TranscodeComplete | Dihasilkan ketika semua aliran untuk video selesai ditranskode. Catatan Untuk memastikan semua definisi tersedia sebelum pemutaran, tunggu hingga Anda menerima notifikasi event Video Transcode Complete sebelum melanjutkan. Memutar sebelum menerima callback dapat menyebabkan pemutaran gagal. |
Yang harus dilakukan setelah unggah
Setelah sumber daya media diunggah ke ApsaraVideo VOD, mereka memasuki status media yang berbeda tergantung pada situasi dan tahap pemrosesan bisnis. Sumber daya audio dan video dalam status media yang berbeda mendukung operasi yang berbeda. Misalnya, audio dan video dalam status Uploading, Upload Failed, atau Blocked hanya dapat dihapus dan tidak mendukung operasi lain (Anda tidak dapat memulai transkoding, mengambil snapshot video, atau meninjau aset media). Audio dan video dalam status Normal mendukung semua operasi, termasuk transkoding, snapshot video, tinjauan aset media, dan pemutaran. Untuk detail tentang status media, lihat Status: status video dan Status: status gambar.
Layanan ApsaraVideo VOD yang tersedia setelah unggah dan catatan untuk pengiriman serta pemutaran selanjutnya adalah sebagai berikut:
| Layanan ApsaraVideo VOD | Deskripsi | Referensi |
| Pengelolaan aset media (setelah unggah) | Setelah unggah selesai, gunakan ApsaraVideo VOD untuk mengelola file media, seperti file sumber video, file aliran yang telah dikodekan ulang, dan file gambar. | Pengelolaan aset media |
| Pemrosesan media | ApsaraVideo VOD mendukung operasi pasca-unggah seperti transkoding audio dan video, tinjauan otomatis, pengeditan daring (pengeditan video di cloud), dan pemrosesan AI. Catatan File audio dan video yang diunggah ke penyimpanan ApsaraVideo VOD secara default mengekstraksi metadata (seperti resolusi video, durasi, dan bitrate), serta secara default mengambil thumbnail dan sprite untuk video. Pra-pemrosesan ini sepenuhnya gratis. | Pemrosesan media |
| Pemutaran audio dan video | Setelah Anda selesai mengunggah audio atau video, file tersebut belum tentu siap. Server ApsaraVideo VOD harus mengonfirmasi bahwa file telah selesai diterima. Gunakan notifikasi event untuk menentukan kapan audio atau video yang diunggah dapat diputar.
|
|
Keamanan unggah
Dalam skenario unggah programatik, baik kredensial unggah maupun STS menyelesaikan masalah otorisasi dan keamanan selama unggah, mencegah file media diunggah dan diputar secara jahat.
Untuk skenario masing-masing metode, lihat Metode kredensial vs. metode STS.
Untuk penggunaan spesifik, lihat dokumentasi operasi untuk setiap metode unggah developer.
- - - - Unggah file media menggunakan SDK OSS
Batasi unggah file baca-publik
Sejak 31 Januari 2024, ApsaraVideo VOD tidak lagi mendukung modifikasi izin file melalui header OSS x-oss-object-acl. Hal ini secara efektif mencegah masalah seperti kebocoran sumber daya media atau lonjakan biaya akibat akses jahat yang disebabkan oleh pengunggahan langsung file baca-publik. Untuk membatasi pengunggahan file baca-publik ke bucket OSS Anda sendiri di ApsaraVideo VOD, Anda dapat menggunakan metode pengelolaan izin berikut:
Untuk memberikan otorisasi kepada ApsaraVideo VOD agar dapat mengakses OSS dan sumber daya lainnya, klik Cloud Resource Access Authorization untuk memberikan otorisasi.
Buat kebijakan kustom yang melarang pengunggahan file dengan ACL objek baca-publik ke bucket OSS Anda sendiri. Untuk prosedur dan isi kebijakan, lihat Kebijakan yang melarang pengunggahan objek dengan ACL baca-publik ke bucket OSS.
Berikan peran AliyunVODDefaultRole izin melarang pengunggahan file dengan ACL objek baca-publik ke bucket OSS Anda sendiri yang dibuat pada langkah sebelumnya.
Untuk memberikan izin kepada peran AliyunVODDefaultRole
Login ke Konsol Resource Access Management (RAM). Untuk prosedurnya, lihat Kelola izin pengguna RAM.
Di panel navigasi kiri, klik Roles, lalu temukan dan klik AliyunVODDefaultRole.
Di tab Permissions, klik Grant Permission.
Di panel yang muncul, pilih tab Custom Policy, pilih kebijakan target, lalu selesaikan otorisasi.
Akselerasi unggah
ApsaraVideo VOD menyediakan akselerasi unggah untuk meningkatkan transfer file jarak jauh dan file besar tingkat GB atau TB. Akselerasi unggah berlaku untuk unggah cross-region (seperti transfer lintas laut), misalnya, mengunggah video dari Tiongkok daratan ke alamat penyimpanan di wilayah penyimpanan Singapura.
Cara mengaktifkan
Untuk mengaktifkan akselerasi unggah, submit a ticket. Berikan UID Akun Alibaba Cloud Anda dan alamat penyimpanan yang ingin Anda percepat.
Penagihan
Akselerasi unggah adalah fitur bernilai tambah dari ApsaraVideo VOD dan ditagih berdasarkan penggunaan. Untuk detail penagihan, lihat Penagihan untuk akselerasi transfer.
Anda tidak dikenai biaya jika Anda mengaktifkan fitur tetapi tidak menggunakannya.
Batasan
Hanya Unggah file ke konsol ApsaraVideo VOD yang tidak mendukung akselerasi. Semua metode unggah lainnya mendukungnya.
Penagihan
Mengunggah aset media ke ApsaraVideo VOD tidak dikenai biaya tambahan. Biaya terkait berasal dari sumber daya layanan Alibaba Cloud ApsaraVideo VOD yang Anda gunakan.
| Item penagihan | Deskripsi |
| Biaya penyimpanan | Biaya penyimpanan untuk file media setelah unggah, ditagih berdasarkan volume dan durasi penyimpanan. |
| Biaya trafik | Trafik unggah gratis (lalu lintas masuk dari klien ke ApsaraVideo VOD tidak dikenai biaya). Trafik pemutaran downstream ditagih secara terpisah. |
| Biaya transkoding | Jika transkoding dipicu setelah unggah, ditagih berdasarkan durasi file output dan spesifikasi transkoding. Tidak dikenai biaya jika tidak dilakukan transkoding. |
| Biaya akselerasi unggah | Saat Anda mengaktifkan dan menggunakan akselerasi unggah, ditagih tambahan berdasarkan trafik yang dipercepat. |
Untuk rincian penagihan, lihat Penagihan layanan dasar dan Paket sumber daya.