ApsaraVideo VOD:Unggah dari klien

Metode 1: URL dan kredensial unggah (direkomendasikan)

Metode ini menyediakan konfigurasi lebih sederhana, keamanan lebih tinggi dengan kontrol izin per video, serta parameter respons yang lebih fleksibel. Metode ini cocok untuk sebagian besar skenario unggah klien.

Tahap 1: Memperoleh URL dan kredensial unggah

Klien mengirim permintaan HTTP ke AppServer Anda dengan metadata media (seperti Title, FileName, CateId, Tags). AppServer Anda menggunakan AK/SK-nya untuk memanggil CreateUploadVideo pada VOD, yang mengembalikan tiga nilai utama: UploadAuth (token unggah sementara), UploadAddress (jalur target OSS, dikodekan Base64), dan VideoId (pengidentifikasi media unik). AppServer Anda meneruskan nilai-nilai ini ke klien.

Tahap 2: Membuat parameter unggah dan mengunggah langsung ke OSS

Klien menginisialisasi unggah SDK dengan UploadAuth, UploadAddress, dan VideoId, beserta jalur file lokal. SDK secara otomatis mengurai UploadAddress untuk memperoleh Endpoint OSS dan Object Key, lalu mengunggah file langsung ke OSS. Proses ini mendukung unggah multi-bagian dan unggah yang dapat dilanjutkan. File dikirim langsung dari klien ke OSS tanpa melewati server Anda.

Tahap 3: Hasil unggah

Setelah OSS menyelesaikan unggah, SDK memicu callback onUploadSucceed, yang membawa VideoId. VOD secara otomatis mendeteksi penyelesaian unggah dan memicu pipeline transkoding dan pemrosesan berdasarkan TemplateGroupId atau WorkflowId yang telah Anda konfigurasi. Anda juga dapat mengonfigurasi callback event (HTTP atau MNS) untuk menerima notifikasi event FileUploadComplete.

Metode 2: Token STS

Tahap 1: Memperoleh kredensial sementara STS

Klien meminta kredensial sementara dari AppServer Anda. AppServer Anda menggunakan AK/SK-nya untuk memanggil AssumeRole pada STS, memperoleh serangkaian AccessKeyId, AccessKeySecret, dan SecurityToken berdurasi terbatas (masa berlaku: 900 hingga 3.600 detik), yang dikembalikan ke klien.

Tahap 2: Memperoleh kredensial unggah dan mengunggah (SDK menangani secara otomatis)

Klien menginisialisasi unggah SDK dengan Token STS. SDK secara otomatis membawa Token STS untuk memanggil CreateUploadVideo (dengan Title, FileName, dan parameter lainnya), memperoleh UploadAuth, UploadAddress, dan VideoId, lalu secara otomatis menjalankan unggah multi-bagian. Seluruh proses ini transparan bagi developer — tidak diperlukan pemanggilan API VOD secara manual.

Tahap 3: Hasil unggah

Sama seperti Metode 1 — SDK memicu onUploadSucceed dengan VideoId, dan VOD memproses file secara otomatis.

Unggah multi-bagian

Unggah multi-bagian membagi file besar menjadi bagian-bagian lebih kecil dan mengunggahnya secara paralel. Hal ini meningkatkan kecepatan dan keandalan unggah untuk file media besar, karena kegagalan jaringan hanya memerlukan pengulangan bagian yang gagal, bukan mengunggah ulang seluruh file. Unggah multi-bagian diaktifkan secara default di semua unggah SDK klien dan tidak memerlukan konfigurasi tambahan.

Unggah yang dapat dilanjutkan

Unggah yang dapat dilanjutkan memungkinkan SDK melanjutkan unggah yang terputus dari bagian terakhir yang berhasil diunggah, bukan memulai dari awal. Saat unggah terputus karena pemutusan jaringan, aplikasi masuk latar belakang, atau perangkat tidur, SDK menyimpan data checkpoint secara internal. Setelah koneksi dipulihkan dan aplikasi dilanjutkan, SDK secara otomatis melanjutkan dari checkpoint tanpa intervensi developer.

Kontrol unggah

Unggah SDK menyediakan API terprogram untuk memulai, menghentikan, menjeda, dan melanjutkan unggah individual. Fitur ini berguna saat Anda perlu menghormati tindakan yang diprakarsai pengguna, seperti membatalkan unggah saat pengguna berpindah halaman, atau mengelola konkurensi unggah dalam skenario batch. Anda mengontrol seluruh siklus hidup unggah sepenuhnya melalui pemanggilan metode SDK.

Callback progres

SDK menyediakan callback progres terperinci yang melaporkan persentase data yang telah diunggah untuk setiap file. Gunakan callback ini untuk memperbarui bilah progres, menampilkan kecepatan unggah, atau memicu logika kondisional, seperti menonaktifkan elemen UI tertentu selama unggah berlangsung. Callback progres dipicu secara berkala selama unggah, memberikan visibilitas real-time terhadap status transfer.

Peralihan jaringan

Klien seluler sering berpindah antara jaringan Wi-Fi dan jaringan seluler. SDK mendukung penjedaan dan pelanjutan unggah untuk menangani transisi ini. Untuk menghindari penggunaan data seluler, panggil metode pause saat perangkat beralih ke jaringan seluler dan panggil metode resume saat Wi-Fi dipulihkan. Aplikasi Anda harus mengimplementasikan logika deteksi transisi jaringan.

Unggah batch

SDK mengelola antrian unggah yang mendukung penambahan, penghapusan, pembatalan, pelanjutan, dan traversal beberapa file. Anda dapat mengosongkan seluruh antrian atau memanipulasi entri individual. Unggah batch berguna dalam skenario di mana pengguna memilih beberapa file media sekaligus, seperti unggah galeri foto, dan SDK menjadwalkannya secara berurutan atau paralel berdasarkan sumber daya yang tersedia.

Dukungan metadata

Saat memperoleh kredensial unggah, Anda dapat melampirkan metadata ke aset media yang sedang diunggah. Bidang metadata yang didukung mencakup Title, Tags, CateId, CoverURL, TemplateGroupId, dan WorkflowId. Menetapkan metadata pada tahap kredensial memastikan bahwa aset media langsung dikaitkan dengan kategori, tag, dan alur kerja pemrosesan yang tepat setelah unggah selesai, sehingga menghilangkan kebutuhan pemanggilan API terpisah untuk memperbarui properti media.

Kepatuhan privasi

Unggah SDK klien dirancang untuk disematkan dalam aplikasi yang didistribusikan melalui toko aplikasi. SDK tidak mengumpulkan data pribadi apa pun. Untuk persyaratan kepatuhan saat mendistribusikan aplikasi dengan integrasi SDK, lihat Perjanjian Layanan.

Penagihan

Unggah SDK klien itu sendiri gratis digunakan. Biaya terkait dengan sumber daya ApsaraVideo VOD yang dikonsumsi selama dan setelah unggah: