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 |
|
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 |
| 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 |
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.
CatatanReferensi 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.
CatatanApsaraVideo 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.
CatatanReferensi 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: