Jika aset media berupa file online atau perlu diunggah/migrasikan secara otomatis pada waktu tertentu, Anda dapat memanggil operasi API terkait dari Intelligent Media Services (IMS) untuk mendapatkan URL unggah dan kredensial unggah aset media tersebut. Selanjutnya, panggil operasi API Object Storage Service (OSS) untuk mengunggah aset media. Topik ini menjelaskan cara mengunggah aset media dengan memanggil operasi API OSS.
Prasyarat
Anda telah mempelajari format file yang didukung. Untuk informasi lebih lanjut, lihat bagian "Format File yang Didukung" pada topik Ikhtisar.
OSS telah diaktifkan. Untuk informasi lebih lanjut, lihat Aktifkan OSS.
Informasi latar belakang
Sebelum memanggil operasi API OSS untuk mengunggah aset media, Anda harus mendapatkan URL unggah dan kredensial unggah aset media tersebut. URL unggah adalah alamat penyimpanan OSS di IMS. Kredensial unggah adalah kredensial otorisasi yang digunakan untuk menyelesaikan proses pengunggahan. URL unggah dan kredensial unggah diterbitkan oleh IMS untuk menjamin keamanan dan otorisasi selama pengunggahan aset media, mencegah pengunggahan file jahat. Saat IMS menerbitkan URL unggah dan kredensial unggah, ID aset media secara otomatis dibuat untuk manajemen siklus hidup aset media berikutnya atau pemrosesan media.
Catatan penggunaan
Anda dapat mengunggah file audio atau video dengan ukuran hingga 5 GB.
Ekstensi nama file tidak peka huruf besar/kecil selama pengunggahan. Jika ekstensi nama file tidak didukung atau format file yang diunggah tidak sesuai dengan kredensial unggah, file gagal diunggah.
Langkah 1: Dapatkan URL unggah dan kredensial unggah aset media
Anda dapat mengintegrasikan SDK server atau membuat permintaan HTTP/HTTPS untuk memanggil operasi CreateUploadMedia guna mendapatkan URL unggah dan kredensial unggah aset media. Kami merekomendasikan integrasi SDK server. Untuk informasi lebih lanjut, lihat Sintaks Permintaan dan Metode Tanda Tangan V2 untuk API RPC.
URL unggah dan kredensial unggah hanya berlaku untuk satu aset media. Jika digunakan untuk aset media lain, aset media asli akan ditimpa.
Jika Anda berulang kali mendapatkan URL unggah dan kredensial unggah aset media, hasil yang diperoleh setiap kali akan berbeda.
URL unggah ditetapkan otomatis oleh IMS dan tidak dapat disesuaikan.
Masa berlaku kredensial unggah adalah 3.000 detik. Jika ukuran file video besar, kredensial unggah mungkin kedaluwarsa selama pengunggahan. Dalam hal ini, Anda dapat memanggil operasi RefreshUploadMedia untuk menyegarkan kredensial unggah. Setelah disegarkan, masa berlaku kredensial unggah baru tetap 3.000 detik, sedangkan URL unggah tetap tidak berubah.
Ukuran gambar dan aset media tambahan seperti file subtitle dan font relatif kecil. Setelah kredensial unggah gambar atau aset media tambahan kedaluwarsa, Anda harus mendapatkan ulang kredensial unggah.
Langkah 2: Panggil operasi API OSS untuk mengunggah aset media
Setelah URL unggah dan kredensial unggah aset media didekode Base64, panggil operasi API OSS terkait untuk mengunggah aset media. Untuk informasi lebih lanjut, lihat Header HTTP Umum dan Unggah Objek ke Bucket OSS.