全部产品
Search
文档中心

Apsara Video SDK:FAQ Lisensi

更新时间:Nov 10, 2025

Topik ini menjelaskan masalah umum dan solusi terkait penerapan, perpanjangan, penggunaan, serta modifikasi informasi pengikatan lisensi.

Apa yang harus dilakukan jika terjadi kesalahan lisensi di Player SDK untuk Web

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

Solusi: Jika Anda menggunakan Web Player SDK V2.28.0 atau versi yang lebih baru, Anda harus membeli lisensi. Lisensi tersebut tidak kompatibel dengan versi Web Player SDK sebelum 2.28.0. Kami menyarankan Anda menggunakan Web Player SDK V2.29.1 atau versi yang lebih baru untuk menghindari gangguan layanan. Jika Anda belum membeli lisensi Web Player SDK, Anda dapat membeli lisensi baru di atau halaman ApsaraVideo MediaBox SDK. Setelah pembelian, Anda harus mengikat ulang lisensi.

Apa yang harus dilakukan jika terjadi kesalahan lisensi di Player SDK untuk seluler

Masalah: Muncul kesalahan seperti "License verify premium func:abr" saat Anda menggunakan Player SDK untuk seluler V7.0.0 atau versi yang lebih baru.

image

Solusi: Player SDK untuk seluler V7.0.0 dan versi yang lebih baru menyediakan fitur dalam berbagai Edisi. Untuk menggunakan fitur Edisi Profesional, seperti kebijakan bitrate adaptif lanjutan (ABR), Anda harus membeli dan mengikat lisensi Edisi Profesional. Untuk informasi lebih lanjut, lihat Mendapatkan lisensi untuk Player SDK.

Cara melihat tanggal kedaluwarsa lisensi dan memperpanjang lisensi

View the license expiration date

  1. Masuk ke konsol ApsaraVideo VOD.

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

  3. Klik tab License Management. Temukan pesanan lisensi yang dikaitkan dengan aplikasi Anda dan lihat tanggal kedaluwarsa lisensi pada kolom Expiration Date.image

Renew the license

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

Penting
  1. Jika tanggal kedaluwarsa lisensi dalam notifikasi SMS yang Anda terima berbeda dengan tanggal kedaluwarsa di konsol, hal ini disebabkan oleh periode validitas yang diperpanjang secara manual karena alasan historis. Tanggal di konsol yang berlaku. Abaikan prompt kedaluwarsa di halaman Perpanjangan di Biaya dan Pengeluaran. Kami menyarankan agar Anda menonaktifkan fitur perpanjangan otomatis.

  2. Jika pesanan lisensi historis Anda merupakan paket yang menggabungkan beberapa fitur kit pengembangan perangkat lunak (SDK), Anda harus memperpanjang seluruh pesanan lisensi tersebut. Anda tidak dapat memperpanjang fitur-fitur tertentu secara terpisah. Anda dapat memperpanjang lisensi dengan salah satu cara berikut:

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

    2. Jika ID instans pada pesanan lisensi kosong, Anda tidak dapat memperpanjang lisensi menggunakan tombol Renew. Anda harus membeli pesanan lisensi baru dari atau halaman MediaBox Audio/Video SDK, lalu lakukan Pengikatan Lisensi lagi.

Cara memecahkan masalah kesalahan lisensi

Jika integrasi lisensi gagal atau terjadi kesalahan, Anda dapat memecahkan masalah tersebut sebagai berikut:

  • Periksa apakah konfigurasi otorisasi lisensi di konsol ApsaraVideo VOD atau ApsaraVideo Live sudah benar.

    1. Masuk ke konsol ApsaraVideo VOD.

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

    3. Klik tab Application Management, temukan aplikasi yang dituju, lalu klik Edit. Informasi dasar aplikasi dan lisensi yang dikaitkan akan ditampilkan.

    4. Periksa apakah informasi berikut sudah benar.

      • Informasi dasar aplikasi: Identifier aplikasi (seperti Nama Paket) dan tanda tangan paket. Kami menyarankan agar Anda tidak mengikat tanda tangan paket.

      • Informasi lisensi yang dikaitkan: Versi SDK, jenis otorisasi, tanggal kedaluwarsa, status, dan layanan bernilai tambah.

      image

  • Periksa apakah konfigurasi lisensi di proyek Anda sudah benar dan sesuai dengan informasi lisensi di konsol.

    • Web: Periksa konfigurasi bidang license dalam kode inisialisasi pemutar.

      • domain: Periksa apakah nama domain halaman tempat pemutar Anda berada sama atau merupakan subdomain dari nama domain yang Anda tentukan saat mengajukan lisensi.

      • key: Periksa apakah nilai License Key sama dengan yang ditampilkan di konsol.

    • Android: Periksa konfigurasi AndroidManifest.xml.

      • LicenseKey: Periksa apakah nilai com.aliyun.alivc_license.licensekey sama dengan yang ditampilkan di konsol.

      • File sertifikat: Periksa apakah nilai com.aliyun.alivc_license.licensefile sama dengan jalur tempat file sertifikat Anda disimpan.

      • ID Paket: Periksa apakah applicationId di build.gradle sama dengan Nama Paket di konsol.

      • Tanda tangan paket: Jika Anda mengikat tanda tangan saat membuat lisensi di konsol, pastikan tanda tangan yang dikonfigurasi di proyek sama dengan yang dikaitkan di konsol. Anda dapat menjalankan perintah berikut untuk mengecek tanda tangan paket Anda: keytool -v -list -keystore your.keystore.

    • iOS: Periksa konfigurasi Info.plist.

      • Bundle ID: Periksa apakah nilai CFBundleIdentifier sama dengan Bundle ID yang Anda konfigurasi di konsol.

      • LicenseKey: Periksa apakah nilai AlivcLicenseKey sama dengan yang ditampilkan di konsol.

      • File sertifikat: Periksa apakah nilai AlivcLicenseFile sama dengan jalur file sertifikat di paket ipa Anda.

    • HarmonyOS: Periksa konfigurasi module.json5.

      • BundleId: Periksa apakah nilai bundleName dalam file app.json5 sama dengan BundleID HarmonyOS yang dikonfigurasi di konsol Anda.

      • LicenseKey: Periksa apakah nilai com.aliyun.alivc_license.licensekey sama dengan yang ditampilkan di konsol.

      • File sertifikat: Periksa apakah nilai com.aliyun.alivc_license.licensefile sama dengan jalur file sertifikat di paket hap Anda.

Apakah saya perlu memperbarui file dan kunci lisensi setelah membeli dan mengotorisasi lisensi baru?

  • File lisensi: Kami menyarankan agar Anda memperbarui file tersebut. Setelah perpanjangan, tanggal kedaluwarsa dalam file lisensi diperbarui. Menggunakan file lisensi yang diperbarui dapat meningkatkan tingkat keberhasilan autentikasi. Secara umum, menggunakan file lisensi historis dalam aplikasi yang telah dirilis tidak memengaruhi fungsionalitasnya.

  • Kunci Lisensi: Kunci tersebut tetap tidak berubah. Kunci Lisensi memiliki pemetaan satu-ke-satu dengan UID.

Cara mengubah ID aplikasi

Jika informasi aplikasi Anda berubah, Anda dapat mengubahnya di konsol.

Penting

Modifikasi identifier aplikasi, seperti nama paket, akan menyebabkan autentikasi gagal untuk aplikasi yang menggunakan identifier asli. Anda harus mengunduh ulang file sertifikat lisensi dan mengganti file yang ada. Lakukan dengan hati-hati.

  1. Masuk ke konsol .

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

  3. Klik tab Manajemen Aplikasi, temukan aplikasi yang dituju, lalu klik Edit.

  4. Anda dapat mengubah nama aplikasi, platform, Hash MD5 tanda tangan aplikasi Android, dan identifier aplikasi seperti nama paket.

  5. Setelah mengonfirmasi perubahan, klik Modify.

Ubah Hash MD5 tanda tangan aplikasi Android

Ubah Hash MD5 tanda tangan dengan hati-hati untuk mencegah gangguan layanan. Aplikasi yang mengintegrasikan ApsaraVideo MediaBox SDK memerlukan file dan kunci lisensi. Jika Anda mengubah konfigurasi otorisasi, seperti Hash MD5 tanda tangan, SDK dalam versi aplikasi yang telah dirilis mungkin gagal dalam pemeriksaan otorisasi. Hal ini dapat menyebabkan fitur tidak berfungsi. Skenario umum sebagai berikut:

  • Jika Anda mengubah Hash MD5 tanda tangan untuk aplikasi Android dari A menjadi B, aplikasi yang dikonfigurasi dengan "Hash MD5=A" akan mengalami gangguan. Dalam kasus ini, buat aplikasi terpisah. Gunakan nama paket yang sama dan atur "Hash MD5=B" untuk versi baru.

  • Jika Anda melepas ikatan tanda tangan, versi SDK lama tidak dapat lolos pemeriksaan otorisasi. Jangan lepaskan ikatan tanda tangan 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

    • Push SDK: V4.4.8 dan versi sebelumnya

    • Short video SDK: V3.35.0 dan versi sebelumnya

Cara mengubah modul, versi, dan fitur yang diotorisasi

Konsol saat ini tidak mendukung peningkatan atau penurunan konfigurasi. Untuk menambahkan modul SDK atau mengubah versi atau fitur modul SDK yang sudah ada, Anda dapat membuat Tiket.