Cara mengunduh file media - ApsaraVideo VOD

Anda dapat mengunduh file media yang disimpan di ApsaraVideo VOD ke disk lokal atau perangkat penyimpanan lainnya. Anda dapat menggunakan Konsol ApsaraVideo VOD, klien, atau operasi API untuk menanyakan URL unduhan berbagai file media. Topik ini menjelaskan jenis file media, tipe URL unduhan, batasan unduhan, dan metode penanyaan.

File Media

ApsaraVideo VOD dapat menghasilkan beberapa jenis file media, termasuk file mezzanine, file aliran yang telah dikodekan ulang, file snapshot video, dan file gambar yang diunggah. ApsaraVideo VOD memungkinkan Anda menanyakan dan mengunduh jenis file media berikut:

Audio atau Video
- File mezzanine yang diunggah ke ApsaraVideo VOD
- File aliran yang telah dikodekan ulang dalam definisi tertentu
Gambar
- File gambar yang diunggah ke ApsaraVideo VOD
- File gambar dari snapshot thumbnail dan sprite gambar yang dihasilkan secara otomatis oleh ApsaraVideo VOD selama pemrosesan snapshot
- File gambar dari snapshot normal, sprite gambar, dan snapshot asli yang membentuk sprite setelah Anda memanggil operasi SubmitSnapshotJob. Untuk informasi lebih lanjut, lihat SubmitSnapshotJob.

Jenis URL Unduhan

URL unduhan file media yang dapat Anda peroleh mencakup alamat penyimpanan dan URL CDN. Anda akan dikenakan biaya manajemen aset media untuk unduhan dari URL sumber OSS. Biaya ini adalah hasil dari lalu lintas keluar OSS. Anda akan dikenakan biaya lalu lintas CDN untuk unduhan dari URL CDN. Biaya ini adalah hasil dari akselerasi CDN.

Alamat Penyimpanan
- Secara default, URL unduhan setiap file media adalah URL OSS. Untuk informasi lebih lanjut, lihat Kelola Bucket Penyimpanan.
- Jika nama domain untuk CDN dikonfigurasi, URL unduhan setiap file media adalah URL CDN. Anda dapat memaksa mengembalikan URL OSS dari file mezzanine atau file aliran yang telah dikodekan ulang sebagai URL unduhan. Untuk mendapatkan URL OSS, Anda dapat mengatur parameter OutputType ke oss untuk mendapatkan URL unduhan. Untuk informasi lebih lanjut, lihat GetMezzanineInfo dan GetPlayInfo. URL unduhan file mezzanine yang disimpan di bucket input adalah URL OSS meskipun nama domain untuk CDN dikonfigurasi. Nama bucket input dimulai dengan in-.
URL CDN
Jika nama domain untuk CDN dikonfigurasi, URL unduhan setiap file media adalah URL CDN. Untuk informasi lebih lanjut, lihat Tambahkan Nama Domain untuk CDN.

Batasan

Jika layanan keamanan media seperti perlindungan hotlink dan enkripsi video dikonfigurasi, unduhan file media dibatasi meskipun URL unduhan diperoleh.

Jika layanan kontrol akses dikonfigurasi, unduhan dari URL CDN dibatasi oleh kebijakan seperti perlindungan hotlink berbasis Referer dan daftar hitam atau putih alamat IP. Batasan tersebut sama dengan batasan untuk pemutaran online. Namun, batasan ini tidak berlaku untuk unduhan dari alamat penyimpanan.
Jika enkripsi video dikonfigurasi, semua file aliran yang telah dikodekan ulang yang diunduh dienkripsi, baik diunduh dari URL OSS maupun URL CDN. Anda harus mendekripsi file aliran yang telah dikodekan ulang untuk pemutaran. Untuk informasi lebih lanjut, lihat bagian "Enkripsi Video" dari topik Gambaran Umum.
Jika penyimpanan OSS pribadi digunakan, URL unduhan memiliki periode validitas. Jika URL unduhan kedaluwarsa, Anda harus memperolehnya kembali. Kami merekomendasikan Anda menetapkan periode validitas panjang untuk URL unduhan.
Jika penandatanganan URL diaktifkan untuk nama domain CDN, URL unduhan memiliki periode validitas. Jika URL unduhan kedaluwarsa, Anda harus memperolehnya kembali. Kami merekomendasikan Anda menetapkan periode validitas panjang untuk URL unduhan.

Gunakan konsol untuk memperoleh URL unduhan

Lihat URL Unduhan
Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Media Files > Audio/Video atau Image. Pada halaman yang muncul, temukan file yang ingin Anda kelola dan klik Manage di kolom Tindakan. Di halaman detail, peroleh URL unduhan.
Ekspor URL Unduhan
- File audio dan video aliran yang telah dikodekan ulang:
  Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Media Files > Audio/Video. Pada halaman Audio/Video, klik ikon di sudut kanan atas. Sistem mengekspor URL unduhan untuk 200 file video dan audio pertama yang dikodekan ulang dalam setiap definisi berdasarkan kondisi filter yang ditentukan.
- File gambar yang diunggah ke ApsaraVideo VOD:
  Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Media Files > Image. Pada halaman Gambar, klik ikon di sudut kanan atas. Sistem mengekspor URL unduhan dari 100 gambar pertama berdasarkan kondisi filter yang ditentukan.

Gunakan API atau SDK untuk memperoleh URL unduhan

Anda dapat mengunduh file mezzanine audio dan video, file aliran yang telah dikodekan ulang, file snapshot yang dihasilkan secara otomatis, dan file gambar. Anda dapat menggunakan operasi berikut untuk memperoleh URL unduhan file yang diperlukan dan mengunduh URL tersebut.

Operasi	Deskripsi	Referensi
GetMezzanineInfo	Menanyakan URL unduhan file mezzanine. Dalam objek Mezzanine yang dikembalikan, parameter `FileURL` menunjukkan URL unduhan file mezzanine.	GetMezzanineInfo
GetPlayInfo	Menanyakan URL streaming file aliran yang telah dikodekan ulang. Dalam objek PlayInfo yang dikembalikan, parameter `PlayURL` menunjukkan URL streaming file aliran yang telah dikodekan ulang.	GetPlayInfo
GetVideoInfo	Menanyakan informasi video. Dalam objek Video yang dikembalikan, parameter `CoverURL` menunjukkan URL thumbnail, dan parameter `Snapshots` menunjukkan array URL dari snapshot yang diambil secara otomatis.	GetVideoInfo
GetImageInfo	Menanyakan informasi gambar. Dalam objek ImageInfo yang dikembalikan, parameter `URL` menunjukkan URL gambar.	GetImageInfo
SearchMedia	Menanyakan informasi aset media. Jika tipe aset media diatur ke video atau audio, informasi aset media dikembalikan dalam objek Video atau Audio. Dalam objek tersebut, parameter `CoverURL` menunjukkan URL thumbnail, parameter `Snapshots` menunjukkan array URL dari snapshot video, dan parameter `SpriteSnapshots` menunjukkan array URL dari sprite snapshot yang diambil secara otomatis. Jika tipe aset media diatur ke gambar, informasi aset media dikembalikan dalam objek Image. Dalam objek tersebut, parameter `URL` menunjukkan URL gambar.	SearchMedia
ListSnapshots	Menanyakan informasi snapshot. Dalam objek MediaSnapshot yang dikembalikan, parameter `Snapshots` menunjukkan array URL dari snapshot tipe yang ditentukan oleh parameter `SnapshotType`.	ListSnapshots

Catatan Penggunaan:

Kami merekomendasikan Anda memanggil operasi API menggunakan ApsaraVideo VOD SDK. Ini membantu Anda memperoleh informasi aset media secara efisien. Untuk informasi lebih lanjut tentang ApsaraVideo VOD SDK, lihat Catatan Penggunaan. Untuk informasi lebih lanjut tentang operasi API, lihat bagian Contoh SDK dari referensi API.
Anda juga dapat mengirim permintaan melalui HTTP atau HTTPS. Untuk informasi lebih lanjut, lihat Sintaks Permintaan.

Unduhan Klien

ApsaraVideo Player SDK menyediakan fitur unduh untuk memungkinkan pengguna menyimpan file aliran audio dan video di terminal seluler mereka dan menonton aliran secara offline. Anda dapat mengaktifkan atau menonaktifkan fitur ini. Mode unduhan Normal dan Terenkripsi didukung.

Pengaturan Unduhan

Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Download. Pada halaman Unduhan, konfigurasikan parameter. Untuk informasi lebih lanjut, lihat Konfigurasikan Pengaturan Unduhan.

Unduhan Normal: Dalam mode ini, file audio dan video yang diunduh tidak terenkripsi. File dapat disalin dan diputar menggunakan pemain. Berhati-hatilah saat menyetel mode unduhan ke Normal.
Unduhan Aman: Dalam mode ini, file audio dan video yang diunduh dienkripsi menggunakan file kunci. File hanya dapat didekripsi menggunakan file kunci yang sama. Ini melindungi hak cipta video. Anda harus menggunakan ApsaraVideo Player SDK untuk mendekripsi dan memutar file audio dan video yang diunduh. Konsol ApsaraVideo VOD menyediakan alat untuk menghasilkan kunci privat untuk enkripsi.

ApsaraVideo Player SDK

Baik ApsaraVideo Player SDK untuk iOS maupun ApsaraVideo Player SDK untuk Android mendukung fitur unduhan aman. Untuk informasi lebih lanjut, lihat Implementasi ApsaraVideo Player SDK untuk iOS dan Implementasi ApsaraVideo Player SDK untuk Android.