SDK Unggah Klien - ApsaraVideo VOD

ApsaraVideo VOD mendukung pengunggahan file media langsung dari perangkat seluler. Metode ini menghemat sumber daya server dengan menghilangkan kebutuhan transfer file perantara.

Ikhtisar Fitur

SDK Unggah Klien mendukung pengunggahan file lokal dan file online.

Fitur	Deskripsi	Catatan
Platform yang Didukung	Web, iOS, Android, dan WeChat mini program	Tidak tersedia
File Media	Untuk format yang didukung, lihat Format Media. Anda dapat mengunggah file lokal dan file online. File online diunggah menggunakan URL. Catatan Pengunggahan berbasis URL hanya didukung di wilayah China (Shanghai). Anda dapat merekam dan mengunggah video pendek. Anda dapat mengunggah beberapa file sekaligus dan mengelolanya, termasuk operasi tambah, hapus, batalkan, lanjutkan, jelajahi, dan bersihkan.	File lokal: hingga 48,8 TB dalam ukuran. File online: hingga 5 GB. Catatan Untuk mengunggah file online, enkode URL untuk mencegah kegagalan yang disebabkan oleh karakter khusus dalam URL.
Lokasi Penyimpanan	Anda dapat menggunakan alamat penyimpanan default atau menentukan satu.	Anda dapat mengubah alamat penyimpanan default. Untuk menentukan alamat penyimpanan, atur parameter StorageLocation saat Anda memanggil operasi untuk mendapatkan URL unggah dan kredensial.
Manajemen Aset Media	Mendukung konfigurasi metadata, seperti judul, tag, kategori, dan gambar mini.	Untuk mengonfigurasi metadata, atur Title, Tags, CateId, dan CoverURL saat Anda memanggil operasi untuk mendapatkan URL unggah dan kredensial.
Transcoding Audio dan Video	Anda dapat menentukan template transcoding atau alur kerja untuk mentranscode file audio dan video yang diunggah.	Untuk mentranscode file, atur TemplateGroupId dan WorkflowId saat Anda memanggil operasi untuk mendapatkan URL unggah dan kredensial.
Otorisasi Unggah	Mendukung metode URL unggah dan kredensial. Mendukung metode Token STS.	Kami merekomendasikan Anda menggunakan metode URL unggah dan kredensial. Baca Proses Unggah untuk memahami perbedaan antara kedua metode tersebut.
Kontrol Unggah	Anda dapat memulai, menghentikan, menjeda, dan melanjutkan unggahan.	Unggahan yang dapat dilanjutkan secara otomatis ditangani oleh SDK. Jika video gagal diunggah karena pengecualian, unggahan akan dilanjutkan dari titik waktu ketika dihentikan.
Percepatan Unggah	Untuk mengaktifkan percepatan unggah, submit a request on Yida.	Setelah fitur diaktifkan, konfigurasikan dengan mengatur bidang `AccelerateConfig` dalam parameter `UserData`.
Pergantian Tipe Jaringan	Anda dapat beralih antara jaringan seluler 3G atau 4G dan Wi-Fi.	Untuk mengurangi penggunaan data dalam jaringan 3G atau 4G, Anda dapat menjeda unggahan saat jaringan beralih ke 3G atau 4G dan melanjutkan unggahan saat jaringan beralih kembali ke Wi-Fi.
Notifikasi Peristiwa	Anda dapat mengonfigurasi callback untuk menerima notifikasi tentang peristiwa unggahan. Untuk notifikasi peristiwa yang didukung, lihat Pengunggahan Media.	Untuk informasi lebih lanjut tentang cara mengatur callback, lihat Konfigurasi Callback.

Proses Unggah

SDK Unggah Klien mengenkapsulasi logika SDK Object Storage Service (OSS) untuk pengunggahan objek. File langsung diunggah ke Bucket OSS untuk ApsaraVideo VOD, menghilangkan kebutuhan transfer file perantara melalui server.

Dalam hal ini, Anda harus mengotentikasi permintaan unggah dengan menyebarkan layanan otorisasi pada server aplikasi Anda. SDK Unggah Klien mendukung dua metode: Otorisasi Berbasis Token STS dan Otorisasi Berbasis Kredensial.

Kami merekomendasikan Anda menggunakan Otorisasi Berbasis Kredensial. Dibandingkan dengan Otorisasi Berbasis Token STS, ia memiliki konfigurasi yang lebih sederhana dan fleksibel, keamanan yang ditingkatkan, dan redundansi yang lebih tinggi, memungkinkan Anda mengontrol izin pada satu video dan menetapkan beberapa parameter respons.

Otorisasi Berbasis Kredensial

Gambar berikut menunjukkan proses lengkap untuk mengunggah file media menggunakan URL unggah dan kredensial unggah.

Menyebarkan layanan otorisasi pada server aplikasi Anda, seperti ApsaraVideo VOD SDK, untuk mendapatkan URL unggah dan kredensial.
Catatan
Referensi API
- CreateUploadVideo: mendapatkan URL unggah dan kredensial untuk file audio dan video.
- RefreshUploadVideo: Memperbarui URL unggah dan kredensial untuk file audio dan video.
- CreateUploadImage: mendapatkan URL unggah dan kredensial untuk file gambar.
- CreateUploadAttachedMedia: mendapatkan URL unggah dan kredensial untuk aset media tambahan.
Klien mengirim permintaan ke server aplikasi untuk meminta URL unggah dan kredensial unggah.
Server aplikasi mengirim permintaan ke ApsaraVideo VOD untuk meminta URL unggah dan kredensial.
ApsaraVideo VOD mengembalikan URL unggah dan kredensial.
Catatan
- ApsaraVideo VOD juga menghasilkan ID media, yang akan dirujuk dalam manajemen siklus hidup media dan pemrosesan media.
  - Untuk video, ID media dikembalikan dalam parameter VideoId.
  - Untuk gambar, ID media dikembalikan dalam parameter ImageId.
  - Untuk aset media tambahan, ID media dikembalikan dalam parameter MediaId.
- Anda juga dapat mengatur callback untuk berlangganan hasil unggahan.
Server aplikasi mengembalikan URL unggah dan kredensial ke klien.
Klien menggunakan URL unggah dan kredensial untuk menginisialisasi instance unggahan.
Klien membangun parameter unggahan untuk mengirim permintaan unggahan.
OSS mengembalikan hasil unggahan.

Otorisasi Berbasis Token STS

Gambar berikut menunjukkan proses lengkap untuk mengunggah file media menggunakan token STS.

Menyebarkan layanan otorisasi pada server aplikasi Anda, seperti STS SDK, untuk mendapatkan token STS sementara.
Catatan
Referensi API
AssumeRole: mendapatkan token STS untuk mengasumsikan peran Resource Access Management (RAM). Untuk informasi lebih lanjut, lihat Mendapatkan Token STS.
Klien mengirim permintaan ke server aplikasi untuk meminta token STS.
Server aplikasi mengirim permintaan ke STS untuk meminta token STS.
STS mengembalikan token.
Server aplikasi mengembalikan token STS ke klien.
Klien menggunakan token STS untuk meminta URL unggah dan kredensial dari ApsaraVideo VOD.
ApsaraVideo VOD mengembalikan URL unggah dan kredensial ke klien.
Klien membangun parameter unggahan untuk mengirim permintaan unggahan.
OSS mengembalikan hasil unggahan.

Integrasi Sisi Klien

Metode integrasi dan penggunaan bervariasi berdasarkan platform. Untuk informasi lebih lanjut, lihat topik-topik berikut: