FAQ lisensi Push SDK, Short Video SDK, Player SDK, dan Beauty Effects SDK - ApsaraVideo VOD

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

Error lisensi pada pemutar web

Masalah: Terjadi error lisensi saat Anda menggunakan Player SDK untuk Web.

Solusi: Integrasi dengan Player SDK untuk Web v2.28.0 atau versi lebih baru memerlukan lisensi. Lisensi yang baru dibeli tidak kompatibel dengan versi Player SDK untuk Web sebelumnya. Untuk memastikan fungsionalitas penuh, kami menyarankan Anda melakukan upgrade ke v2.29.1 atau versi lebih baru. Jika Anda belum membeli lisensi Player SDK, kunjungi halaman pembelian ApsaraVideo MediaBox SDK untuk membeli lisensi baru. Setelah pembelian, Anda harus bind it ke aplikasi Anda.

Error lisensi pada pemutar seluler

Masalah: Saat Anda menggunakan Player SDK untuk klien seluler v7.0.0 atau versi lebih baru, muncul pesan error seperti "License verify premium func:abr".

Solusi: Player SDK v7.0.0 dan versi lebih baru tersedia dalam beberapa edisi. Untuk menggunakan fitur lanjutan seperti kebijakan ABR tingkat lanjut, Anda harus membeli dan bind lisensi Edisi Profesional. Untuk informasi lebih lanjut, lihat Mendapatkan lisensi ApsaraVideo Player SDK.

Periksa masa berlaku lisensi dan perpanjang

Periksa tanggal kedaluwarsa lisensi

Login ke Konsol ApsaraVideo VOD atau Konsol ApsaraVideo Live.
Pada panel navigasi kiri, pilih SDK Management > My Licenses.
Klik tab License Management, temukan pesanan lisensi yang di-bind ke aplikasi Anda, lalu lihat tanggal kedaluwarsanya pada kolom Expiration Date.

Perpanjang lisensi

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

Penting

Jika tanggal kedaluwarsa lisensi dalam pesan teks yang Anda terima berbeda dengan tanggal yang ditampilkan di konsol, hal ini disebabkan periode validitas diperpanjang secara manual karena alasan historis. Tanggal kedaluwarsa di konsol yang berlaku. Anda dapat mengabaikan notifikasi kedaluwarsa di halaman Renewal pada Konsol Penagihan dan Manajemen Biaya. Kami menyarankan menonaktifkan fitur perpanjangan otomatis.
Jika pesanan lisensi historis Anda mencakup beberapa fitur SDK, Anda harus memperpanjang seluruh pesanan lisensi tersebut. Anda tidak dapat memperpanjang satu fitur saja secara terpisah. Terdapat dua metode perpanjangan:
1. Jika pesanan lisensi memiliki ID instans, Anda dapat mengklik Renew pada kolom Actions.
2. Jika pesanan lisensi tidak memiliki ID instans, Anda tidak dapat menggunakan tombol Renew. Anda harus membeli lisensi baru di halaman pembelian ApsaraVideo MediaBox SDK, lalu bind it ke aplikasi Anda.

Cara troubleshooting error lisensi

Jika Anda mengalami error selama integrasi lisensi, ikuti langkah-langkah troubleshooting berikut:

Verifikasi bahwa otorisasi lisensi telah dikonfigurasi dengan benar di Konsol ApsaraVideo VOD atau Konsol 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. Informasi dasar aplikasi dan lisensi yang di-bind akan ditampilkan.
4. Verifikasi bahwa informasi berikut benar:
  - Informasi dasar: Periksa identifier aplikasi (seperti package name) dan signature paket. Kami menyarankan agar tidak meng-bind signature paket.
  - Informasi lisensi: Periksa versi SDK, tipe otorisasi, tanggal kedaluwarsa, status lisensi, dan layanan bernilai tambah yang dibeli.
Verifikasi bahwa konfigurasi lisensi dalam proyek Anda benar dan konsisten dengan informasi lisensi di konsol.
- Untuk aplikasi web, periksa konfigurasi field license selama inisialisasi pemutar.
  - domain: Domain halaman tempat pemutar Anda di-host. Ini harus merupakan domain yang Anda tentukan saat mengajukan lisensi, atau salah satu subdomain-nya.
  - key: Nilai kunci lisensi. Ini harus sesuai dengan kunci lisensi yang ditampilkan di konsol.
- Android: Periksa konfigurasi di AndroidManifest.xml.
  - LicenseKey: Pastikan nilai com.aliyun.alivc_license.licensekey sesuai dengan kunci yang ditampilkan di konsol.
  - File lisensi: Pastikan nilai com.aliyun.alivc_license.licensefile sesuai dengan path tempat file lisensi Anda disimpan.
  - Package ID: Pastikan applicationId di build.gradle sesuai dengan Package Name di konsol.
  - Signature paket: Jika Anda meng-bind signature saat membuat lisensi di konsol, pastikan signature yang dikonfigurasi di proyek Anda sesuai dengan yang di-bind di konsol. Jalankan perintah berikut untuk mengecek signature paket Anda: keytool -v -list -keystore your.keystore.
- iOS: Periksa konfigurasi Info.plist.
  - Bundle ID: Pastikan nilai CFBundleIdentifier sesuai dengan Bundle ID yang dikonfigurasi di konsol.
  - License Key: Pastikan nilai AlivcLicenseKey sesuai dengan yang ditampilkan di konsol.
  - File lisensi: Pastikan nilai AlivcLicenseFile sesuai dengan path file lisensi dalam paket ipa.
- HarmonyOS: Konfigurasi utama yang perlu diperiksa ada di file module.json5.
  - BundleId: bundleName di app.json5 harus sesuai dengan BundleID HarmonyOS yang dikonfigurasi di konsol.
  - LicenseKey: Nilai com.aliyun.alivc_license.licensekey harus sesuai dengan kunci lisensi yang ditampilkan di konsol.
  - File lisensi: Nilai com.aliyun.alivc_license.licensefile harus sesuai dengan path file lisensi dalam paket hap.

Pembaruan file dan kunci lisensi

file lisensi: Kami menyarankan memperbarui file lisensi. Setelah perpanjangan, tanggal kedaluwarsa dalam file lisensi diperbarui. Mengintegrasikan file lisensi yang diperbarui dapat meningkatkan tingkat keberhasilan otentikasi. Dalam kebanyakan kasus, penggunaan file lisensi lama pada aplikasi yang sudah dipublikasikan tidak memengaruhi fungsionalitasnya.
kunci lisensi: Kunci lisensi tetap tidak berubah. Setiap kunci lisensi dipetakan secara unik ke user ID (UID).

Cara mengubah ID aplikasi

Jika informasi aplikasi Anda berubah, ubah di konsol.

Penting

Memodifikasi identifier aplikasi (seperti Package Name) akan menyebabkan otentikasi gagal untuk aplikasi yang menggunakan identifier lama. Anda harus mengunduh ulang dan mengganti file sertifikat lisensi. Lakukan dengan hati-hati.

Login ke konsol ApsaraVideo VOD.
Pada panel navigasi kiri, pilih .
Klik tab Application Management. Temukan aplikasi target dan klik Edit.
Anda dapat mengubah nama aplikasi, platform, Hash MD5 signature aplikasi Android, dan identifier aplikasi seperti package name.
Klik Modify untuk menyimpan perubahan.

Ubah signature paket Android

Ubah signature paket dengan hati-hati untuk mencegah kegagalan layanan online. Saat Anda menggunakan ApsaraVideo MediaBox SDK, aplikasi Anda memerlukan file dan kunci lisensi untuk konfigurasi. Jika Anda mengubah pengaturan otorisasi, seperti signature paket, otentikasi SDK dapat gagal untuk versi aplikasi yang sudah dipublikasikan, sehingga menyebabkan fitur berhenti berfungsi. Skenario umum meliputi:

Jika Anda mengubah signature paket aplikasi Android dari A ke B, versi aplikasi yang menggunakan signature A akan berhenti berfungsi. Dalam kasus ini, kami menyarankan membuat aplikasi baru dengan package name yang sama tetapi menggunakan signature B untuk versi aplikasi baru.
Jika Anda melepas binding signature paket, otentikasi dapat gagal untuk versi SDK lama. Kami tidak menyarankan melepas binding signature jika aplikasi Anda menggunakan salah satu versi SDK berikut:
- ApsaraVideo MediaBox SDK: v1.6.0 dan versi sebelumnya
- Player SDK: v5.5.1.0 dan versi sebelumnya
- Push SDK: v4.4.8 dan versi sebelumnya
- Short Video SDK: v3.35.0 dan versi sebelumnya

Ubah modul, edisi, atau fitur yang diotorisasi

Konsol tidak mendukung modifikasi konfigurasi lisensi. Jika Anda perlu menambahkan modul SDK, atau mengubah edisi atau fitur modul SDK yang sudah ada, ajukan tiket.