ApsaraVideo VOD:Unduh file media

Skema Penggunaan

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

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

• Unduh offline menggunakan SDK pemutar: Cocok untuk skenario aplikasi kustom.

Skenario 1: Mengunduh dari konsol

Unduh satu file

Konsol ideal untuk mengunduh beberapa file guna validasi atau pengujian cepat.

1. Login ke Konsol ApsaraVideo VOD.

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

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

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

Unduh beberapa file

Gunakan fitur ekspor batch untuk mengekspor informasi aset media dari beberapa file.

1. Login ke Konsol ApsaraVideo VOD.

2. Di panel navigasi kiri, pilih Media Files, lalu pilih Audio/Video atau Image.

3. Gunakan filter atau fitur search untuk menemukan dan memilih file yang akan diekspor.

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

5. Tempelkan URL aset media ke browser atau alat unduh untuk memulai proses unduh.

Skema 2: Unduh menggunakan API

Dapatkan URL unduhan

Gunakan API berikut untuk mendapatkan URL unduhan file sumber, file yang telah dikodekan ulang, dan gambar mini.

Dapatkan URL unduhan secara batch

Lakukan operasi unduhan

Contoh SDK Python berikut mengotomatiskan proses unduhan. Contoh tambahan tersedia di Portal OpenAPI.

1. Siapkan lingkungan.

   Instal SDK Python VOD.

   pip install aliyun-python-sdk-vod

2. Dapatkan URL unduhan.

   Panggil operasi GetMezzanineInfo untuk mengambil 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 yang lebih rendah
   request.set_AuthTimeout(3600)  # Atur periode validitas URL menjadi 1 jam (3600 detik)
   
   # 2. Kirim permintaan dan dapatkan tanggapan
   response = client.do_action_with_exception(request)
   result = json.loads(response)
   
   # 3. Urai URL unduhan
   download_url = result['Mezzanine']['FileURL']
   print(f"URL unduhan file sumber: {download_url}")
   
   # (Opsional) Gunakan pustaka 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: Unduh offline menggunakan SDK pemutar

VOD mendukung caching video secara lokal di perangkat seluler untuk pemutaran offline dalam dua mode: unduhan standar dan unduhan aman.

• Unduhan standar: Video tidak dienkripsi dan dapat disalin serta diputar oleh pemutar apa pun. Cocok untuk konten publik atau skenario hak cipta rendah.

• Unduhan aman: Video dienkripsi dan hanya dapat diputar oleh SDK Pemutar Video Apsara yang terintegrasi dengan kunci yang sesuai. Cocok untuk kursus berbayar dan konten sensitif hak cipta.

Langkah-langkah

1. Konfigurasikan mode unduhan.

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

   2. Pilih unduhan standar atau aman. Untuk unduhan aman, hasilkan dan simpan kunci enkripsi secara aman pada halaman ini.

2. Integrasikan SDK pemutar.

   Integrasikan SDK Pemutar Video Apsara ke dalam proyek Android atau iOS Anda: Integrate the Android SDK, Integrate the iOS SDK.

3. Selesaikan unduhan video.

   Integrasikan modul unduhan video ke dalam proyek Android atau iOS Anda: Video download for Android, Video download for iOS.

4. Unduh beberapa video secara bersamaan.

   SDK Pemutar Video Apsara tidak mendukung pengunduhan beberapa video sekaligus dengan satu instans downloader. Buat instans AliMediaDownloader terpisah untuk setiap video. Saat mengunduh beberapa video, perhatikan batasan dan rekomendasi berikut:

   • Gunakan pola singleton untuk mengelola antrian unduhan, dan pertahankan pool tetap downloader aktif, misalnya tiga hingga lima, untuk pemrosesan konkuren.

   • Setelah tugas unduhan selesai, panggil stop() dan release() untuk melepaskan sumber daya downloader.

   • PlayAuth berlaku selama 3.000 detik. Sebelum memanggil prepare, pastikan kredensial masih berlaku. Jika kredensial telah kedaluwarsa, panggil updateSource() untuk memperbarui kredensial PlayAuth, lalu lanjutkan unduhan.

Penagihan

URL unduhan terbagi menjadi dua kategori:

• Alamat penyimpanan

  • Tanpa nama domain yang dipercepat, unduhan menggunakan alamat penyimpanan langsung dan dikenai biaya lalu lintas keluar.

• Alamat yang dipercepat:

  • Jika Anda mengonfigurasi nama domain yang dipercepat, URL unduhan menjadi URL yang dipercepat, memberikan unduhan lebih cepat dan dikenai biaya layanan akselerasi.

  • Jika Anda mengonfigurasi daftar hitam dan daftar putih, pembatasan seperti Perlindungan hotlink Referer dan Daftar hitam IP berlaku, sesuai dengan aturan pemutaran online.

FAQ

Mengapa video yang diunduh tidak bisa diputar?

Jika output yang dikodekan ulang menggunakan enkripsi (seperti Enkripsi HLS), file yang diunduh tetap terenkripsi. Gunakan SDK Pemutar Video Apsara untuk mendekripsi dan memutarnya. Enkripsi video.

Bagaimana cara mengunduh banyak file media?

Gunakan SearchMedia - Search Media Information dengan paging untuk mengambil URL file, lalu ikuti Skema 2: Unduh melalui API untuk mengunduh.

Bisakah saya menambahkan watermark secara dinamis saat mengunduh video?

ApsaraVideo VOD tidak mendukung penambahan watermark secara dinamis melalui API saat video diunduh. Untuk mengunduh video ber-watermark tetapi memutar video tanpa watermark, konfigurasikan versi ber-watermark dan versi tanpa watermark sebagai definisi yang berbeda. Lalu ikuti Skema 1 atau Skema 2 dalam topik ini untuk mendapatkan dan mengunduh file video dengan definisi yang Anda butuhkan.

Apakah kedaluwarsa URL memengaruhi unduhan yang sedang berlangsung?

Jika URL unduhan kedaluwarsa selama proses unduhan, unduhan tidak terganggu dan tidak melambat. Unduhan yang telah dimulai tetap berlanjut hingga selesai. Jika Anda meminta file lagi dan permintaan gagal atau unduhan menjadi lambat, panggil operasi GetPlayInfo untuk menghasilkan URL unduhan baru. Atur parameter OutputType ke oss, perpanjang periode validitas URL sesuai kebutuhan, lalu coba unduh kembali.