全部产品
Search
文档中心

ApsaraVideo VOD:Unduh offline

更新时间:Jan 21, 2026

ApsaraVideo VOD menyediakan fitur unduh offline untuk skenario seluler, memungkinkan pengguna akhir menyimpan cache video di perangkat lokal mereka untuk ditonton secara offline.

Mode unduh

ApsaraVideo VOD menyediakan dua mode unduh untuk skenario seluler: unduh aman dan unduh standar. Perbedaan keduanya dijelaskan sebagai berikut:

  • Unduh aman (Direkomendasikan): Memungkinkan pengguna akhir menyimpan cache video di perangkat lokal mereka untuk ditonton menggunakan ApsaraVideo Player untuk seluler. File video yang diunduh dienkripsi dengan file kunci yang dihasilkan dan hanya dapat didekripsi serta diputar oleh ApsaraVideo Player. Video tidak dapat ditonton menggunakan pemutar pihak ketiga atau tanpa dekripsi.

  • Unduh standar: Memungkinkan pengguna akhir menyimpan cache video di perangkat lokal mereka untuk ditonton menggunakan ApsaraVideo Player untuk seluler. File video yang diunduh tidak dienkripsi sehingga dapat disalin dan diputar menggunakan pemutar apa pun. Gunakan mode ini dengan hati-hati.

Unduh aman memastikan bahwa video yang diunduh dienkripsi dan hanya dapat diputar oleh aplikasi tertentu. Anda dapat menentukan aplikasi tersebut dengan memberikan ID uniknya saat menghasilkan file kunci di Konsol ApsaraVideo VOD. Mode ini lebih aman dan andal dibandingkan unduh standar, sehingga ideal untuk skenario yang memerlukan perlindungan hak cipta video. Kami merekomendasikan penggunaan unduh aman dalam sebagian besar skenario.

Batasan

Fitur unduh offline terintegrasi ke dalam SDK ApsaraVideo Player. Untuk menggunakannya, Anda harus mengintegrasikan SDK ApsaraVideo Player dan menyelesaikan konfigurasi kode. Semua SDK ApsaraVideo Player mendukung unduh offline, kecuali SDK Pemutar ApsaraVideo untuk web. Untuk informasi lebih lanjut tentang metode konfigurasi, lihat topik berikut:

Mengaktifkan unduh offline

Aktifkan unduhan standar

Setelah mengaktifkan unduh standar, pengguna akhir dapat menggunakan ApsaraVideo Player untuk seluler guna menyimpan cache video di perangkat lokal mereka untuk ditonton secara offline. File video yang diunduh tidak dienkripsi dan dapat disalin serta diputar di pemutar apa pun. Gunakan mode ini dengan hati-hati.

  1. Masuk ke Konsol ApsaraVideo VOD.

  2. Di panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Download Settings.

  3. Aktifkan sakelar untuk fitur unduh. Jika fitur sudah diaktifkan, klik Modify. Atur Download Mode ke Normal Download, lalu klik OK.

Mengaktifkan unduh aman

Setelah mengaktifkan unduh aman, pengguna akhir dapat menggunakan ApsaraVideo Player untuk seluler guna menyimpan cache video di perangkat lokal mereka untuk ditonton secara offline. File video yang diunduh dienkripsi dengan file kunci yang dihasilkan. File tersebut hanya dapat didekripsi dan diputar di ApsaraVideo Player dan tidak dapat ditonton di pemutar pihak ketiga.

  1. Masuk ke Konsol ApsaraVideo VOD.

  2. Di panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Download Settings.

  3. Aktifkan sakelar untuk fitur unduh. Jika fitur sudah diaktifkan, klik Modify. Atur Download Mode ke Secure Download, lalu klik OK.

  4. Di area Get the key, masukkan ID aplikasi unik dan kunci privat dekripsi offline, lalu klik Generate and Download Key.

    Setelah mengonfigurasi unduh aman, video offline harus didekripsi dengan kunci sebelum dapat diputar.

    Kunci privat enkripsi video offline adalah file biner yang dihasilkan berdasarkan ID aplikasi unik dan kunci privat dekripsi offline yang Anda masukkan. Kunci ini dihasilkan menggunakan algoritma privat dan tersedia untuk diunduh. Setelah mengunduh kunci tersebut, simpan secara aman di aplikasi client. SDK ApsaraVideo Player menggunakan kunci ini selama proses unduh dan pemutaran video offline.

    Catatan

    Anda dapat menghasilkan beberapa kunci untuk client yang berbeda.

    Parameter name

    Description

    Unique app ID

    • Android: Nilai SHA-1 dari file keystore. Nilai SHA-1 yang diperoleh harus berupa string yang mengandung tanda titik dua (:).

    • iOS: App Bundle ID.

    • Windows: Nomor seri sertifikat penandatanganan digital.

    Untuk informasi lebih lanjut tentang cara memperoleh ID aplikasi unik, lihat Obtain the unique app ID.

    Offline decryption private key

    String kunci privat kustom. String harus terdiri dari 16 hingga 32 karakter dan mengandung kombinasi huruf serta angka. String harus mencakup huruf kapital, huruf kecil, dan angka.

  5. Simpan file kunci yang dihasilkan ke aplikasi client dan konfigurasikan file kunci tersebut di SDK ApsaraVideo Player.

Obtain the unique app ID

Android

Informasi signature aplikasi Android adalah nilai SHA-1 dari file keystore. Anda dapat menggunakan fitur signingReport di Android Studio untuk menghasilkan laporan penandatanganan dan memperoleh informasi signature tersebut.

iOS

Ini adalah Bundle ID aplikasi iOS.

Menonaktifkan video saat offline

Setelah mengaktifkan fitur unduh offline, Anda dapat menonaktifkan unduh offline untuk video tertentu guna mencegah video tersebut diunduh menggunakan ApsaraVideo Player.

Catatan
  • Anda hanya dapat menonaktifkan unduh offline untuk video ketika status videonya adalah Normal.

  • Fitur ini hanya mencegah video diunduh menggunakan ApsaraVideo Player, bukan melalui browser lain atau pemutar pihak ketiga.

  1. Masuk ke Konsol ApsaraVideo VOD.

  2. Di panel navigasi sebelah kiri, pilih Media Files > Audio/Video.

  3. Di kolom Actions video target, klik More dan pilih Disable Download.

  4. Pada kotak dialog yang muncul, klik OK.

Referensi

Untuk informasi lebih lanjut tentang cara mengunduh aset media di ApsaraVideo VOD, lihat Download media files.