Anda dapat mengunggah file media dari server aplikasi ke bucket Object Storage Service (OSS) yang dialokasikan untuk ApsaraVideo VOD. ApsaraVideo VOD menyediakan SDK unggah server untuk berbagai bahasa pemrograman umum beserta demo. SDK ini mengenkapsulasi logika untuk mendapatkan URL unggah dan kredensial, sehingga Anda hanya perlu melakukan konfigurasi sederhana sebelum memulai unggahan. Topik ini menjelaskan skenario, proses unggah, serta penggunaan SDK unggah server.
Skema
Gunakan SDK unggah server jika ingin melakukan unggahan otomatis atau mengunggah sejumlah besar file video atau media online. Untuk mengunggah file media online, unduh terlebih dahulu file tersebut ke server aplikasi, lalu unggah ke ApsaraVideo VOD dari server aplikasi.
Fitur | Deskripsi | Catatan |
Bahasa Pemrograman | Java, Python, PHP, C, dan C++ didukung. | Untuk bahasa pemrograman lainnya, gunakan SDK OSS. Lihat Unggah menggunakan OSS SDK. |
File Media yang Didukung | Lihat Ikhtisar Unggah Media untuk informasi tentang format file media yang didukung. Anda dapat mengunggah file lokal dan file online. File online diunggah menggunakan URL. |
Catatan Kodekan URL saat mengunggah file media menggunakan URL untuk mencegah kegagalan akibat karakter khusus dalam URL. |
Alamat Penyimpanan | Gunakan alamat penyimpanan default atau tentukan alamat penyimpanan kustom. | Ubah alamat penyimpanan default sesuai kebutuhan. Lihat Kelola Bucket Penyimpanan. Unggah berbasis URL hanya didukung di wilayah China (Shanghai). Tentukan alamat penyimpanan dengan mengatur parameter StorageLocation saat memanggil operasi API untuk mendapatkan URL unggah dan kredensial. |
Unggah melalui Jaringan Internal | Jika menggunakan instance Elastic Compute Service (ECS), tentukan wilayah tempat instance ECS berada dalam logika unggah. Jika wilayah instance ECS sama dengan wilayah penyimpanan ApsaraVideo VOD, file akan diunggah melalui jaringan internal, mempercepat unggahan dan mengurangi lalu lintas Internet. | API ApsaraVideo VOD hanya dapat dipanggil menggunakan nama domain publik. Gunakan instance ECS yang dapat mengakses Internet untuk menerapkan skrip unggah. |
Pengelolaan Aset Media | Konfigurasikan metadata media seperti judul, tag, kategori, dan gambar mini. | Atur parameter seperti Title, Tags, CateId, dan CoverURL saat memanggil operasi untuk mendapatkan URL unggah dan kredensial. |
Transkoding Audio dan Video | Tentukan template transkoding atau alur kerja untuk mentranskode file audio dan video yang diunggah. Anda juga dapat mengunggah file tanpa transkoding. | Atur parameter seperti TemplateGroupId dan WorkflowId saat memanggil operasi untuk mendapatkan URL unggah dan kredensial. |
Kontrol Unggah | Konfigurasikan bilah kemajuan unggah dan gunakan callback kemajuan default atau kustom. Fitur unggah yang dapat dilanjutkan hanya didukung untuk SDK unggah server Java. | Bilah kemajuan unggah tidak dapat dikonfigurasi untuk file M3U8. |
Notifikasi Acara | Konfigurasikan callback untuk menerima notifikasi acara unggah. Lihat Ikhtisar Unggah Media untuk informasi lebih lanjut. | Lihat Konfigurasikan Callback untuk panduan lebih lanjut. |
Otorisasi Unggah | Berikan izin unggah menggunakan kredensial unggah dengan pasangan AccessKey dari akun Alibaba Cloud atau pengguna RAM yang berwenang. Izin unggah juga dapat diberikan menggunakan Token Layanan Keamanan (STS). | Jika menggunakan token STS, implementasikan layanan untuk mendapatkan token tersebut. |
Akselerasi Unggah | Aktifkan fitur akselerasi unggah dengan mengajukan tiket melalui atau submit a ticket. | Setelah aktivasi, konfigurasikan fitur ini dengan mengatur |
ApsaraVideo VOD menyediakan operasi API berikut untuk mendapatkan URL unggah dan kredensial:
Proses unggah
SDK unggah server mengenkapsulasi logika untuk mendapatkan URL unggah, kredensial, dan logika unggah OSS. Anda hanya perlu melakukan konfigurasi sederhana sebelum menggunakan SDK untuk memulai unggahan. Gambar berikut menunjukkan proses unggah lengkap.
Proses Unggah
Integrasikan SDK unggah server ke server aplikasi Anda dan selesaikan pengaturan unggah, seperti konfigurasi pasangan AccessKey, jalur file, alamat penyimpanan, informasi aset media, pengaturan transkoding, dan kontrol unggah.
Server aplikasi menggunakan SDK unggah server untuk memanggil operasi API guna mendapatkan URL unggah, kredensial unggah, dan informasi aset media.
CatatanSebagai alternatif, Anda dapat membuat permintaan HTTP atau HTTPS untuk mendapatkan URL unggah dan kredensial. Namun, metode ini memerlukan pembuatan tanda tangan dan berpotensi menyebabkan kesalahan. ApsaraVideo VOD menyediakan operasi berikut terkait URL unggah dan kredensial:
ApsaraVideo VOD mengembalikan URL unggah, kredensial unggah, dan ID media ke server aplikasi.
CatatanApsaraVideo VOD menghasilkan ID media saat mengembalikan URL unggah dan kredensial. ID media digunakan untuk manajemen siklus hidup 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.Catat ID media yang dikembalikan karena diperlukan untuk tugas selanjutnya, seperti manajemen aset media, pemutaran audio dan video, dan pemrosesan media.
Server aplikasi memulai unggahan berdasarkan logika unggah OSS yang dienkapsulasi oleh SDK unggah server.
Klien OSS mengembalikan hasil unggah.
CatatanAnda juga dapat mengonfigurasi callback terlebih dahulu untuk mendengarkan hasil unggah.
Referensi
Prosedur integrasi dan penggunaan SDK unggah server bervariasi berdasarkan bahasa pemrograman. Lihat topik berikut untuk informasi lebih lanjut:
Perbedaan antara SDK unggah server dan SDK operasi server
SDK unggah server dan SDK operasi server yang disediakan oleh ApsaraVideo VOD memiliki perbedaan. SDK unggah server mengenkapsulasi logika unggah lengkap, sehingga Anda dapat langsung mengintegrasikan SDK dan memulai unggahan. SDK operasi server mencakup semua fitur ApsaraVideo VOD tetapi hanya mengenkapsulasi logika untuk mendapatkan URL unggah dan kredensial. Jika menggunakan SDK operasi server, Anda harus mengembangkan logika unggah sendiri, seperti mendapatkan URL unggah dan kredensial dari ApsaraVideo VOD, mendekode URL dan kredensial yang dienkripsi Base64, serta menggunakan OSS untuk mengunggah file. Lihat Server SDK Reference untuk informasi lebih lanjut.