All Products
Search
Document Center

Apsara Video SDK:FAQ Lisensi

Last Updated:Aug 05, 2026

Topik ini menjawab pertanyaan umum tentang penerapan, perpanjangan, penggunaan, dan modifikasi informasi aplikasi yang di-bind ke lisensi Anda.

Error lisensi Web Player SDK

Masalah: Terjadi error lisensi saat menggunakan Web Player SDK.

Solusi: Anda harus mengintegrasikan layanan lisensi jika menggunakan Web Player SDK v2.28.0 atau versi lebih baru. Lisensi yang baru dibeli tidak kompatibel dengan versi Web Player SDK sebelumnya. Untuk kinerja optimal, gunakan versi 2.29.1 atau lebih baru. Jika belum membeli lisensi Web Player SDK, beli lisensi baru di ApsaraVideo MediaBox SDK. Setelah pembelian, Anda harus meng-bind ulang lisensi.

Error lisensi Mobile Player SDK

Masalah: Pesan error seperti "License verify premium func:abr" mungkin muncul saat menggunakan Player SDK untuk mobile v7.0.0 atau versi lebih baru.

[7.0.0_43566760] [licenseManager] :license verify premium func: abr
[7.0.0_43566760] [licenseManager] :Premium LICENSE INFO NOT VALID!
[7.0.0_43566760] [ResolverManager] :httpdns get ip info timed out
[7.0.0_43566760] [analytics] :eventCode:5004, name: string:li_di * Can not found the business data *||* li_fri * success *|
[7.0.0_43566760] [licenseManager] :license verify premium sdk result is 6, errMsg: Can not found the business data
[7.0.0_43566760] [licenseManager] :
                                    +---------------------------------------------------------------------------------------------------+
                                    |--------------------------------- Premium license is invalid!!! ----------------------------------|
                                    |--------------------- Please provide correct license key before play, --------------------------|
                                    | you can visit 'https://www.alibabacloud.com/help/zh/apsara-video-sdk/user-guide/license/' for more info.|
                                    +---------------------------------------------------------------------------------------------------+
[7.0.0_43566760] [] :check premium failed
[7.0.0_43566760] [] :check premium function: ABR
[7.0.0_43566760] [licenseManager] :license verify premium func: abr
[7.0.0_43566760] [licenseManager] :Premium LICENSE INFO NOT VALID!
[7.0.0_43566760] [analytics] :eventCode:5004, name: string:li_di * Can not found the business data *||* li_fri * success *|

Solusi: Di Player SDK untuk mobile v7.0.0 dan versi lebih baru, fitur-fitur dibagi menjadi beberapa Edisi berbeda. Untuk menggunakan fitur Edisi Profesional seperti kebijakan ABR advanced, Anda harus membeli dan meng-bind lisensi Edisi Profesional. Untuk informasi selengkapnya, lihat Mendapatkan lisensi Player SDK.

Kedaluwarsa dan perpanjangan lisensi

Lihat tanggal kedaluwarsa lisensi

  1. Login ke Konsol ApsaraVideo VOD atau Konsol ApsaraVideo Live.

  2. Pada panel navigasi kiri, pilih SDK Management > My Licenses.

  3. Klik tab License Management, temukan pesanan lisensi yang di-bind ke aplikasi Anda, lalu periksa tanggal kedaluwarsanya pada kolom Expiration Date. Untuk memperpanjang lisensi, klik Renew pada kolom Actions.

Perpanjang lisensi

Untuk informasi lebih lanjut tentang perpanjangan lisensi, lihat Perpanjang lisensi.

Penting
  1. Jika tanggal kedaluwarsa dalam notifikasi SMS yang Anda terima berbeda dengan tanggal yang ditampilkan di Konsol, hal ini disebabkan periode validitas diperpanjang secara manual. Tanggal kedaluwarsa di Konsol yang berlaku. Anda dapat mengabaikan peringatan kedaluwarsa di halaman Renewal di Billing Management. Kami menyarankan agar Anda menonaktifkan fitur perpanjangan otomatis.

  2. Jika Anda memiliki pesanan lisensi lama yang mencakup bundel beberapa fitur SDK, Anda harus memperpanjang seluruh pesanan tersebut. Anda tidak dapat memperpanjang fitur-fitur secara terpisah. Ada dua cara untuk memperpanjang:

    1. Jika pesanan lisensi memiliki ID instans, klik Renew pada kolom Actions.

    2. Jika pesanan lisensi tidak memiliki ID instans, Anda tidak dapat menggunakan tombol Renew. Anda harus membeli lisensi baru di ApsaraVideo MediaBox SDK. Setelah pembelian, Anda harus meng-bind ulang lisensi.

Penyelesaian masalah error lisensi

Jika Anda mengalami kegagalan integrasi atau error lisensi lainnya, ikuti langkah-langkah berikut untuk pemecahan masalah:

  • Verifikasi bahwa otorisasi lisensi telah dikonfigurasi dengan benar di Konsol ApsaraVideo VOD atau ApsaraVideo Live.

    1. Login ke Konsol ApsaraVideo VOD atau Konsol ApsaraVideo Live.

    2. Pada panel navigasi kiri, pilih SDK Management > My Licenses.

    3. Klik tab Application Management, temukan aplikasi target, lalu klik Details. Halaman ini menampilkan informasi dasar aplikasi dan lisensi yang di-bind.

    4. Periksa apakah informasi berikut sudah benar:

      • Informasi dasar aplikasi: identifier aplikasi (seperti Package Name) dan package signature. Kami menyarankan untuk tidak meng-bind package signature.

      • Informasi lisensi yang di-bind: versi SDK, jenis otorisasi, tanggal kedaluwarsa, status, dan layanan bernilai tambah.

  • Verifikasi bahwa konfigurasi lisensi di proyek Anda sudah benar dan sesuai dengan informasi lisensi di Konsol.

    • Web: Periksa konfigurasi field license yang digunakan saat inisialisasi player.

      • domain: Pastikan domain halaman player Anda sesuai atau merupakan subdomain dari domain yang ditentukan saat Anda mengajukan lisensi.

      • key: Pastikan nilai License Key sesuai dengan nilai yang ditampilkan di Konsol.

    • Android: Periksa konfigurasi AndroidManifest.xml.

      • License key: Pastikan nilai com.aliyun.alivc_license.licensekey sesuai dengan kunci yang ditampilkan di Konsol.

      • license file: Pastikan nilai com.aliyun.alivc_license.licensefile sesuai dengan path penyimpanan file lisensi Anda.

      • Package ID: Pastikan applicationId di build.gradle sesuai dengan Package Name di Konsol.

      • package signature: Jika Anda meng-bind signature saat membuat lisensi di Konsol, pastikan signature yang dikonfigurasi di proyek Anda sesuai dengan yang ada di Konsol. Anda dapat menjalankan perintah berikut untuk mengecek signature paket Anda: keytool -v -list -keystore your.keystore.

    • iOS: Periksa konfigurasi Info.plist.

      • BundleId: Pastikan nilai CFBundleIdentifier sesuai dengan Bundle ID yang dikonfigurasi di Konsol.

      • License key: Pastikan nilai AlivcLicenseKey sesuai dengan kunci yang ditampilkan di Konsol.

      • license file: Pastikan nilai AlivcLicenseFile sesuai dengan path file lisensi dalam paket ipa Anda.

    • HarmonyOS: Periksa konfigurasi module.json5.

      • BundleId: Pastikan bundleName di app.json5 sesuai dengan BundleID HarmonyOS yang dikonfigurasi di Konsol.

      • License key: Pastikan nilai com.aliyun.alivc_license.licensekey sesuai dengan kunci yang ditampilkan di Konsol.

      • license file: Pastikan nilai com.aliyun.alivc_license.licensefile sesuai dengan path file lisensi dalam paket hap Anda.

Memperbarui file dan kunci lisensi

  • File lisensi: Kami menyarankan untuk memperbarui file lisensi. Setelah perpanjangan, tanggal kedaluwarsa dalam file lisensi akan diperbarui. Menggunakan file yang diperbarui meningkatkan tingkat keberhasilan otentikasi. Untuk aplikasi yang sudah dirilis, penggunaan file lisensi historis biasanya tidak memengaruhi fungsionalitas.

  • Kunci lisensi: Kunci ini tetap tidak berubah karena terikat secara unik ke UID Anda.

Memodifikasi ID aplikasi

Jika informasi aplikasi Anda berubah, Anda dapat memodifikasinya di Konsol.

Penting

Memodifikasi identifier aplikasi, seperti package name, akan membuat identifier asli tidak berlaku. Anda harus mengunduh kembali file lisensi dan mengganti file yang ada. Lakukan dengan hati-hati.

  1. Login ke Konsol ApsaraVideo VOD atau Konsol ApsaraVideo Live.

  2. Pada panel navigasi kiri, pilih SDK Management > My Licenses.

  3. Klik tab Application Management, temukan aplikasi target, lalu klik Edit.

    .

  4. Anda dapat memodifikasi nama aplikasi, platform, nilai MD5 signature aplikasi Android, dan identifier aplikasi seperti package name.

  5. Setelah mengonfirmasi perubahan, klik Modify untuk menyelesaikan modifikasi lisensi.

Memodifikasi signature MD5 Android

Memodifikasi signature MD5 dapat menyebabkan masalah produksi, jadi lakukan dengan hati-hati. Aplikasi yang menggunakan ApsaraVideo MediaBox SDK memerlukan file dan kunci lisensi untuk konfigurasi. Jika Anda mengubah pengaturan otorisasi seperti signature MD5, SDK pada versi aplikasi yang sudah dirilis mungkin gagal dalam otentikasi sehingga fitur menjadi tidak tersedia. Skenario umum meliputi:

  • Jika Anda mengubah signature MD5 aplikasi Android dari A ke B, versi aplikasi yang dikonfigurasi dengan signature A akan gagal. Dalam kasus ini, kami menyarankan membuat aplikasi baru yang menggunakan package name yang sama tetapi dikonfigurasi dengan signature B untuk versi aplikasi baru.

  • Jika Anda melepas binding signature, versi SDK lama akan gagal dalam otentikasi. Kami tidak menyarankan melepas binding signature jika aplikasi Anda pernah menggunakan versi SDK berikut:

    • ApsaraVideo MediaBox SDK: v1.6.0 dan versi sebelumnya

    • Player SDK: v5.5.1.0 dan versi sebelumnya

    • Live Streaming SDK: v4.4.8 dan versi sebelumnya

    • Short Video SDK: v3.35.0 dan versi sebelumnya

Memodifikasi modul, edisi, atau fitur yang diotorisasi

Untuk menambahkan modul SDK atau memodifikasi edisi atau fitur modul yang sudah ada, ajukan tiket.