SDK video pendek memerlukan lisensi. Pelajari cara mendapatkan, menggunakan, dan memperbarui lisensi.
Pembaruan layanan lisensi
Mulai dari versi 3.29.0, SDK video pendek menggunakan layanan lisensi terintegrasi yang disediakan oleh ApsaraVideo for MediaBox. Lisensi ApsaraVideo for MediaBox mengotorisasi beberapa SDK: Push SDK, SDK video pendek, ApsaraVideo Player SDK, dan Queen SDK. Setiap lisensi dapat di-bind ke maksimal satu aplikasi Android dan satu aplikasi iOS. Pembaruan ini juga mengubah metode integrasi SDK.
Versi SDK video pendek | Metode integrasi |
Integrasi baru | Integrasikan versi 3.29.0 atau yang lebih baru dengan mengikuti dokumentasi terbaru.
|
Peningkatan versi SDK | Jika Anda menggunakan versi sebelum 3.29.0, Anda dapat terus menggunakannya hingga lisensi berakhir. Untuk meningkatkan ke versi 3.29.0 atau yang lebih baru, panggil API registrasi untuk mengintegrasikan LicenseKey dan LicenseFile.
|
Otorisasi lisensi
Langkah 1: Buat aplikasi
Buka halaman My Authorizations di Konsol ApsaraVideo VOD. Di tab Application Management, klik Create Application.
Masukkan informasi aplikasi. Aplikasi dikategorikan berdasarkan platform: Web atau Mobile.
Web: Masukkan Application Name dan Web Domain yang sesuai. Pilih I understand and agree to the compliance commitments (klik View Statement untuk detail), lalu klik Create.

Panduan domain Web
Contoh domain yang valid:
aliyun.com. Untuk mencakup beberapa subdomain, sepertipc.aliyun.comdanmobile.aliyun.com, masukkan hanya nama domain utamaaliyun.com.Hindari format berikut:
Termasuk awalan protokol:
http://aliyun.comatauhttps://aliyun.com.Termasuk path atau subhalaman:
aliyun.com/indexataualiyun.com/login.Menggunakan domain wildcard:
*.aliyun.comatau.aliyun.com.
Mobile: Pilih platform, masukkan Application Name, dan berikan Android package name, Bundle ID iOS, serta HarmonyOS Bundle ID untuk membuat aplikasi.
HarmonyOS Bundle ID dapat ditemukan di bidang
bundleNamepada fileapp.json5proyek Anda. Setelah memasukkan informasi, centang kotak Compliance Commitment dan klik Create.
Ikatkan tanda tangan aplikasi Android
Bidang ini wajib diisi jika Anda memilih Android untuk Platform Type dan memilih Bind Signature.
Binding signature meningkatkan keamanan dengan mencegah aplikasi lain yang memiliki nama paket yang sama menggunakan lisensi tersebut.
Versi SDK yang lebih baru tidak memerlukan binding signature, termasuk ApsaraVideo MediaBox v1.7.0 dan yang lebih baru, player SDK v5.5.2 dan yang lebih baru, live streaming SDK v4.4.9 dan yang lebih baru, serta SDK video pendek v3.36.0 dan yang lebih baru.
Anda dapat memperoleh nilai MD5 dari signature aplikasi Android Anda dengan dua cara:
Jalankan perintah
keytool -v -list -keystore your.keystoreuntuk melihat nilai MD5 dari signature yang sesuai.Dari Android Studio: Klik Gradle di sidebar kanan dan navigasikan ke Tasks > android > signingReport untuk aplikasi. Ubah semua huruf dalam nilai MD5 yang dihasilkan menjadi huruf kecil dan hapus tanda titik dua.
Langkah 2: Beli lisensi
Jika Anda telah membeli lisensi, lanjutkan ke Langkah 3: Mengikat Lisensi.
Edisi Standar dan Edisi Profesional player SDK dikirim dalam paket SDK yang sama dan dibedakan berdasarkan jenis lisensi. Setelah Anda membeli lisensi Edisi Profesional dan meng-bind-nya ke aplikasi Anda, Anda dapat menggunakan fitur Edisi Profesional.
Kembali ke halaman My Authorizations, pilih tab Order Instances, lalu klik Purchase License.
Di halaman pembelian ApsaraVideo MediaBox, pilih SDK dan modul fungsi berdasarkan kebutuhan bisnis Anda (hak SDK tidak dapat digabung dalam satu pembelian), lalu selesaikan pembelian.
Saat membeli lisensi player SDK, pastikan platform yang Anda pilih sesuai dengan jenis platform aplikasi Anda. Ketidaksesuaian menyebabkan kegagalan binding lisensi.
CatatanManfaat SDK hanya dapat dibeli secara terpisah. Misalnya, Player SDK Edisi Standar dapat dibeli secara terpisah. Di halaman pembelian MediaBox Audio and Video SDK, pilih versi setiap modul SDK sesuai kebutuhan. Setelah pemilihan selesai, konfirmasi jumlah pembelian dan biaya yang harus dibayar, lalu klik Buy Now untuk menyelesaikan pembayaran.
Setelah pembayaran berhasil, kembali ke tab Order Instances untuk melihat instans pesanan baru Anda.
Langkah 3: Bind lisensi
Kembali ke halaman My Authorizations, pilih tab License Management, lalu klik Bind License.
Di halaman Bind License, pilih aplikasi dan pesanan lisensi SDK yang akan di-bind. Setiap pesanan lisensi dapat di-bind ke satu aplikasi, mencakup platform Web atau Mobile.
Di bagian Authorized Platforms, pilih platform yang ingin Anda otorisasi, seperti Android. Lisensi mobile hanya berlaku untuk aplikasi mobile.
Setelah mengonfirmasi informasi, klik Bind.
Setelah binding berhasil, kembali ke tab License Management untuk melihat nama aplikasi yang di-bind dan informasi otorisasinya.
Langkah 4: Dapatkan informasi otorisasi
Di tab License Management, temukan aplikasi target. License Key Anda ditampilkan di bagian atas halaman. Klik tombol copy untuk menyalin kunci tersebut. Tautan Download Certificate tersedia di bawah setiap nama aplikasi dalam daftar.
Setelah mengonfirmasi detail otorisasi, klik Download Certificate untuk menyimpan file lisensi ke mesin lokal Anda. Simpan juga license key untuk digunakan saat integrasi aplikasi. Untuk petunjuk mengonfigurasi file lisensi, lihat Integrasikan lisensi.
Perbarui lisensi
Periksa masa berlaku lisensi
Lisensi berakhir setelah periode tertentu. Kriteria kedaluwarsa berbeda berdasarkan versi SDK, dengan versi 3.29.0 sebagai batas pemisah.
Versi sebelum 3.29.0:
API mengembalikan kode kesalahan
ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001).Salah satu pesan berikut muncul di log:
License disabled due to no network access for 30 days. Please renew or re-obtain authorization.
License disabled. Please renew or re-obtain authorization.
Invalid license (package name/signature or bundle ID not registered on the official website of the short video SDK). The 7-day trial period has expired and the license is disabled.
Versi 3.29.0 dan yang lebih baru:
API mengembalikan kode kesalahan
ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001).Salah satu pesan berikut muncul di log:
License expired. Please renew or re-obtain authorization.
Lisensi belum diinisialisasi. Lakukan integrasi dengan mengikuti Inisialisasi SDK (Android) atau Inisialisasi SDK (iOS).
Invalid license (package name/signature or bundle ID not registered on the official website of the short video SDK). Please obtain a new authorization.
Value-added service 'xxx' has expired. Please renew or re-obtain authorization. ('xxx' adalah placeholder untuk layanan bernilai tambah spesifik.)
Invalid use of value-added service 'xxx'. Please obtain a license for the service before use. ('xxx' adalah placeholder untuk layanan bernilai tambah spesifik.)
Perbarui lisensi
Perbarui lisensi Anda sebelum kedaluwarsa untuk mencegah gangguan layanan. Dua situasi dapat mencegah Anda memperbarui langsung dari halaman License Management:
ID instans kosong — Kolom ID instans untuk pesanan di halaman License Management kosong.
Kesalahan konsol saat perpanjangan — Pesan kesalahan merah muncul di bagian bawah halaman perpanjangan: Order configuration parameters do not meet validation criteria. Please reconfigure the product! Hal ini mencegah Anda menyelesaikan perpanjangan dengan mengklik Buy Now.
Jika Anda mengalami salah satu situasi tersebut, beli lisensi baru dan bind ke aplikasi Anda, atau kirim tiket Alibaba Cloud untuk perpanjangan.
Dalam kebanyakan kasus, perbarui lisensi Anda langsung dari halaman License Management (Metode 1). Jika ID instans pesanan lisensi Anda kosong atau terjadi kesalahan konsol saat perpanjangan, gunakan Metode 2 sebagai gantinya.
Metode 1: Perbarui dari halaman License Management (direkomendasikan)
Perpanjangan berlaku untuk seluruh pesanan lisensi. Jika pesanan lisensi Anda mencakup beberapa hak SDK, semuanya diperbarui bersama. Anda tidak dapat mengubah konfigurasi selama perpanjangan. Jika Anda memiliki pertanyaan, kirim tiket Alibaba Cloud.
Buka halaman My Authorizations di Konsol ApsaraVideo VOD.
Pilih tab License Management, lalu temukan dan simpan ID instans yang di-bind ke aplikasi target.

Jika ID instans kosong atau terjadi kesalahan di konsol saat perpanjangan, gunakan Metode 2: Beli lisensi baru dan bind aplikasi atau kirim tiket Alibaba Cloud untuk perpanjangan.
Buka halaman Renewals di Konsol Expenses and Costs. Cari ID instans yang disimpan, temukan pesanan, lalu klik Renew di kolom Actions.
Di halaman perpanjangan ApsaraVideo MediaBox, konfirmasi konfigurasi saat ini dan durasi perpanjangan, lalu klik Buy Now untuk menyelesaikan perpanjangan.

(Direkomendasikan) Aktifkan auto-renewal untuk mencegah kedaluwarsa.
Metode 2: Beli lisensi baru dan bind aplikasi
Jika ID instans kosong untuk lisensi SDK yang Anda beli atau terjadi kesalahan saat perpanjangan, Anda harus membeli lisensi baru dari halaman pembelian ApsaraVideo MediaBox sebelum lisensi saat ini kedaluwarsa. Setelah pembelian, ikuti petunjuk di Langkah 3: Bind lisensi untuk mencegah gangguan layanan.