全部产品
Search
文档中心

ApsaraVideo VOD:Memperoleh dan memperbarui informasi aset media

更新时间:Feb 10, 2026

Setelah mengunggah atau memproses file media, Anda dapat memperoleh informasi aset media melalui konsol atau API. Topik ini menjelaskan cara memperoleh informasi aset media menggunakan konsol, API, dan SDK.

Skenario 1: Memperoleh dan memperbarui menggunakan API

Informasi aset media merupakan kumpulan data terstruktur yang mendeskripsikan file media. Untuk memenuhi berbagai kebutuhan skenario bisnis, ApsaraVideo VOD mengkategorikan informasi aset media ke dalam beberapa tipe. Setiap tipe dapat diperoleh dan diperbarui secara independen menggunakan API yang berbeda:

Tipe informasi

API untuk memperoleh informasi

API untuk memperbarui informasi

Skenario

Informasi dasar

Memperoleh informasi audio/video tunggal

Memperoleh informasi audio/video secara batch

Memperoleh informasi gambar tunggal

Mengubah informasi audio/video tunggal

Mengubah informasi audio/video secara batch

Memperbarui informasi gambar secara batch

Memperoleh informasi dasar aset media (judul, durasi, status) untuk ditampilkan di aplikasi. Memperbarui properti aset media (judul, deskripsi, thumbnail, ID kategori, tag) guna meningkatkan manajemen konten.

Informasi file sumber

Memperoleh informasi file sumber

Informasi file sumber adalah metadata yang diekstraksi dari file itu sendiri dan tidak mendukung pembaruan.

Memperoleh alamat dan parameter file asli yang diunggah. Hal ini sering digunakan untuk pengarsipan, pemrosesan sekunder, atau troubleshooting.

Informasi pemutaran

Memperoleh alamat pemutaran audio/video

Informasi pemutaran tidak mendukung pembaruan. Namun, Anda dapat melakukan transkode untuk menghasilkan aliran audio/video baru. Kirim pekerjaan transkoding media

Memperoleh alamat pemutaran (termasuk autentikasi). Ini merupakan inti dari fungsionalitas pemutaran video.

Catatan

Anda dapat menggunakan SDK sisi server untuk memanggil API guna memperoleh dan memperbarui informasi aset media. Untuk informasi selengkapnya, lihat Panduan pengguna SDK VOD.

Skenario 2: Memperoleh dan memperbarui menggunakan konsol

Konsol menyediakan antarmuka intuitif untuk melihat dan mengelola informasi detail setiap aset media. Metode ini cocok untuk manajemen operasional harian atau verifikasi cepat selama pengembangan.

  1. Masuk ke Konsol ApsaraVideo VOD.

  2. Pada bilah navigasi kiri Konsol VOD, pilih Media Files. Lalu klik Audio/Video, Image, atau Short Video Material untuk mengakses halaman yang sesuai.

  3. Klik Manage untuk melihat detail aset media.

管理

Bagian berikut menggunakan file audio/video sebagai contoh:

Informasi dasar

Pada tab Informasi Dasar, Anda dapat melihat atau mengubah informasi seperti judul, deskripsi, klasifikasi, tag, dan thumbnail audio atau video. Setelah selesai mengedit informasi, klik Save.

基础信息

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter

Deskripsi

Cover

Unggah gambar atau pilih tangkapan video untuk mengaturnya sebagai thumbnail video default.

Catatan

Unggah thumbnail kustom. Hanya format JPG atau PNG yang didukung, dengan ukuran maksimum 1 MB dan resolusi tidak melebihi 1920 × 1080.

Name

Nama audio/video. Nama ini terlihat di jendela pemutar selama pemutaran. Panjangnya harus 1 hingga 128 byte.

Description

Deskripsi detail audio/video. Panjangnya harus 0 hingga 1024 byte.

Categories

Konfigurasikan kategorisasi video di manajemen kategorisasi. Untuk informasi selengkapnya, lihat Kategorisasi aset media.

Tag

Tambahkan beberapa tag untuk setiap audio/video. Hanya karakter Tionghoa, huruf Inggris, angka, dan garis bawah yang didukung. Masukkan koma, titik koma, atau tekan Enter untuk menyelesaikan entri tag tunggal.

URL Video

Pada tab URL Video, Anda dapat melihat URL file sumber dan aliran yang telah dikodekan ulang dalam berbagai format dan definisi. Resolusi dan bitrate setiap aliran juga ditampilkan.

11

Tabel berikut menjelaskan fitur-fiturnya.

Fitur

Deskripsi

Copy

Salin alamat pemutaran definisi saat ini ke browser atau pemutar untuk pratinjau.

Preview

Pratinjau video dengan definisi saat ini langsung di konsol.

Delete

Hapus video dengan definisi yang sesuai.

Delete All

Purge semua file yang telah dikodekan ulang (tidak termasuk file asli). Setelah dipurge, file tidak dapat dipulihkan. Gunakan dengan hati-hati.

Kode pemutar web

Pada tab Kode Pemutar Web, Anda dapat memperoleh kode HTML atau JavaScript untuk setiap video. Anda juga dapat menggunakan tool konfigurasi cepat untuk mengatur parameter pemutar, seperti ukuran pemutar dan pengaturan putar otomatis. Tool ini secara otomatis memperbarui parameter yang sesuai dalam potongan kode guna meningkatkan efisiensi pengembangan Anda.

Catatan
  • Tab Web Player Code hanya ditampilkan untuk file video.

  • Kami menyarankan Anda menggunakan versi terbaru Web Player untuk integrasi. Untuk informasi selengkapnya, lihat Web player.

web播放器