ApsaraVideo VOD：Unduh 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 player SDK: Cocok untuk skenario aplikasi kustom.

Skenario 1: Unduh dari Konsol

Unduh satu file

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

1. Masuk ke Konsol ApsaraVideo VOD.

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

3. Temukan file target, lalu klik Manage di kolom Actions. Pilih tab Video URL atau Audio URL. Di kolom Actions untuk definisi yang diinginkan, klik Copy.

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

Unduh beberapa file

Konsol menyediakan fitur ekspor batch untuk informasi aset media ketika Anda perlu mengunduh beberapa file sekaligus.

1. Masuk ke Konsol ApsaraVideo VOD.

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

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 memulai proses unduh.

Skenario 2: Unduh menggunakan API

Memperoleh 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.

Memperoleh URL unduhan secara batch

Lakukan operasi unduhan

Anda dapat mengintegrasikan fitur unduhan ke dalam aplikasi menggunakan API untuk mengotomatiskan proses tersebut. Kode berikut memberikan contoh menggunakan SDK Python. Untuk contoh SDK lainnya, lihat Portal OpenAPI.

1. Persiapkan lingkungan.

   Instal VOD Python SDK.

   pip install aliyun-python-sdk-vod

2. Peroleh URL unduhan.

   Panggil operasi GetMezzanineInfo untuk mengambil informasi file sumber.

   import json
   from aliyunsdkcore.client import AcsClient
   from aliyunsdkvod.request.v20170321 import GetMezzanineInfoRequest
   
   # Inisialisasi client
   # 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. Uraikan 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}")

Skenario 3: Unduh offline menggunakan client SDK

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

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

• Unduhan aman: File video yang diunduh dienkripsi. File tersebut hanya dapat didekripsi dan diputar oleh ApsaraVideo Player SDK yang diintegrasikan dengan kunci yang sama. Mode ini cocok untuk skenario sensitif terhadap hak cipta, seperti kursus berbayar dan konten eksklusif.

Langkah-langkah

1. Konfigurasikan mode unduhan.

   1. Masuk ke Konsol ApsaraVideo VOD. Buka Configuration Management > CDN Configuration > Download Settings.

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

2. Integrasikan player SDK.

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

3. Selesaikan pengunduhan video.

   Integrasikan modul pengunduhan video ke dalam proyek Android atau iOS Anda. Untuk informasi selengkapnya, lihat Pengunduhan video untuk Android dan Pengunduhan video untuk iOS.

Penagihan

URL unduhan file media terbagi menjadi dua kategori berikut:

• Alamat penyimpanan

  • Jika Anda tidak mengonfigurasi nama domain yang dipercepat, sistem akan langsung menggunakan alamat penyimpanan aset media dan dikenakan biaya lalu lintas keluar.

• Alamat yang dipercepat:

  • Ketika Anda mengonfigurasi nama domain yang dipercepat, Anda dapat mencapai kecepatan akses yang lebih cepat. URL unduhan menjadi URL yang dipercepat, dan Anda akan dikenakan biaya untuk layanan akselerasi.

  • Jika Anda mengonfigurasi daftar hitam dan daftar putih, Anda tunduk pada pembatasan seperti kebijakan Perlindungan hotlink Referer dan Daftar hitam IP, yang sejalan dengan aturan pemutaran online.

FAQ

Mengapa saya tidak bisa memutar video yang diunduh?

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

Bagaimana cara mengunduh banyak file media?

Ambil informasi file media dengan paging menggunakan SearchMedia - Cari Informasi Media, lalu ikuti Skenario 2: Unduh melalui API untuk mengunduh.