ApsaraVideo VOD：Mengunduh file media

Skenario

• Unduh dari Konsol: Cocok untuk validasi cepat atau ekspor sementara sejumlah kecil file.

• Unduh menggunakan API: Cocok untuk pemrosesan batch otomatis terhadap file.

• Unduh offline menggunakan client SDK: Cocok untuk skenario pemutaran dengan cache dan perlindungan hak cipta.

Skenario 1: Mengunduh dari konsol

Mengunduh satu file

Konsol menyediakan cara langsung untuk mengunduh file. Metode ini ideal untuk mengunduh sejumlah kecil file atau untuk tujuan pengujian.

1. Login ke ApsaraVideo VOD console.

2. Pada panel navigasi di sebelah kiri, pilih Media Files > Audio/Video untuk membuka halaman daftar Audio/Video.

3. Pada kolom Actions untuk file yang dituju, klik Manage. Pada tab Video URL (atau Audio URL), temukan definisi yang diinginkan lalu klik Copy di kolom Actions.

4. Tempelkan URL yang telah disalin ke browser atau alat unduhan untuk memulai proses unduh.

Mengunduh beberapa file

Untuk mengunduh beberapa aset media, Anda dapat menggunakan fitur ekspor batch di Konsol guna mengekspor informasi aset media tersebut.

1. Login ke ApsaraVideo VOD console.

2. Pada panel navigasi di sebelah kiri, pilih Media Files. Berdasarkan jenis file, pilih Audio/Video atau Image untuk membuka halaman daftar yang sesuai.

3. Pada halaman daftar, gunakan fitur filter atau search untuk menemukan dan memilih file media yang ingin diekspor.

4. Klik ikon di pojok kanan atas halaman untuk mengekspor informasi aset media.

5. Tempelkan URL aset media ke browser atau alat unduhan untuk mengunduh file tersebut.

Skenario 2: Mengunduh menggunakan API

Mendapatkan URL unduhan

API menyediakan cara fleksibel untuk memperoleh URL unduhan berbagai sumber daya media, seperti file sumber, file yang telah dikodekan ulang, dan gambar mini. Tabel berikut mencantumkan API untuk memperoleh URL unduhan berbagai jenis file media.

Menjalankan operasi unduhan

Anda dapat mengintegrasikan fitur unduhan ke dalam aplikasi menggunakan API untuk pemrosesan otomatis. Kode berikut menunjukkan contoh penggunaan Python SDK.

1. Persiapkan lingkungan.

   Instal VOD Python SDK.

   pip install aliyun-python-sdk-vod

2. Dapatkan URL unduhan.

   Panggil operasi GetMezzanineInfo untuk mendapatkan informasi file sumber.

   import json
   from aliyunsdkcore.client import AcsClient
   from aliyunsdkvod.request.v20170321 import GetMezzanineInfoRequest
   
   # Inisialisasi klien
   # Ganti dengan ID AccessKey, Rahasia AccessKey, dan ID wilayah Anda
   client = AcsClient('YOUR_ACCESS_KEY_ID', 'YOUR_ACCESS_KEY_SECRET', 'cn-shanghai')
   
   # 1. Buat permintaan
   request = GetMezzanineInfoRequest()
   request.set_accept_format('json')
   request.set_VideoId("YOUR_VIDEO_ID") # Ganti dengan ID video Anda
   request.set_OutputType("oss")  # Direkomendasikan: Mengembalikan alamat penyimpanan OSS untuk biaya lebih rendah
   request.set_AuthTimeout(3600)  # Atur periode validitas URL menjadi 1 jam (3600 detik)
   
   # 2. Kirim permintaan dan dapatkan respons
   response = client.do_action_with_exception(request)
   result = json.loads(response)
   
   # 3. Ekstrak URL unduhan
   download_url = result['Mezzanine']['FileURL']
   print(f"URL unduhan file sumber: {download_url}")
   
   # (Opsional) Gunakan library requests untuk mengunduh file
   import requests
   print("Memulai pengunduhan file...")
   file_response = requests.get(download_url, stream=True)
   if file_response.status_code == 200:
       with open('downloaded_video.mp4', 'wb') as f:
           for chunk in file_response.iter_content(chunk_size=8192):
               f.write(chunk)
       print("File berhasil diunduh: downloaded_video.mp4")
   else:
       print(f"Pengunduhan gagal. Kode status: {file_response.status_code}")
       print(f"Pesan kesalahan: {file_response.text}")

Skema 3: Unduhan offline menggunakan client SDK

Untuk skenario aplikasi seluler, ApsaraVideo VOD mendukung caching video secara lokal untuk pemutaran offline. Unduhan offline tersedia dalam dua mode: unduhan standar dan unduhan aman.

• Unduhan standar: File video yang diunduh tidak dienkripsi dan dapat disalin serta diputar secara bebas. Mode ini cocok untuk konten publik atau skenario dengan persyaratan hak cipta yang rendah.

• Unduhan aman: File video yang diunduh dienkripsi dan hanya dapat didekripsi serta diputar oleh ApsaraVideo Player SDK yang memiliki kunci dekripsi yang sesuai. Mode ini cocok untuk skenario yang melibatkan konten sensitif terhadap hak cipta, seperti kursus berbayar dan konten eksklusif.

Langkah-langkah

1. Konfigurasikan metode unduhan.

   1. Login ke ApsaraVideo VOD console. Buka Configuration Management > CDN Configuration > Download Settings.

   2. Pilih unduhan standar atau unduhan aman sesuai kebutuhan Anda. Jika memilih unduhan aman, Anda harus menghasilkan dan menyimpan kunci enkripsi secara aman pada halaman ini.

2. Integrasikan SDK pemutar.

   Integrasikan ApsaraVideo Player SDK ke dalam proyek Android atau iOS Anda. Untuk informasi lebih lanjut, lihat Integrasikan SDK untuk Android dan Integrasikan SDK untuk iOS.

3. Selesaikan pengunduhan video.

   Integrasikan modul unduhan video ke dalam proyek Android atau iOS Anda. Untuk informasi lebih lanjut, lihat Unduhan video untuk Android dan Unduhan video untuk iOS.

Penagihan

URL unduhan untuk file media terbagi menjadi dua kategori:

• Alamat penyimpanan

  • Jika nama domain yang dipercepat belum dikonfigurasi, alamat penyimpanan aset media akan digunakan. Proses ini dikenai biaya untuk lalu lintas keluar dari penyimpanan.

• Alamat yang dipercepat:

  • Jika Anda telah mengonfigurasi nama domain yang dipercepat, kecepatan akses akan lebih tinggi. URL unduhan berupa alamat yang dipercepat, dan dikenai biaya untuk layanan akselerasi.

  • Jika Anda telah mengonfigurasi daftar hitam dan daftar putih, akses dibatasi oleh kebijakan seperti Perlindungan hotlink dan Daftar hitam IP. Pembatasan ini konsisten dengan aturan untuk pemutaran online.

FAQ

Mengapa video yang diunduh tidak bisa diputar?

Jika enkripsi video, seperti Enkripsi HLS, diaktifkan untuk file output yang telah dikodekan ulang, file yang diunduh tetap dalam keadaan terenkripsi. Anda harus menggunakan ApsaraVideo Player SDK untuk mendekripsi dan memutarnya. Untuk informasi lebih lanjut, lihat Enkripsi video.

Bagaimana cara mengunduh banyak file media?

Anda dapat memanggil operasi SearchMedia untuk mengambil informasi file media secara bertahap (paginated), lalu mengunduh file tersebut seperti yang dijelaskan dalam Skema 2: Unduh menggunakan API.