Cara mendapatkan lisensi SDK video pendek - ApsaraVideo VOD

SDK video pendek memerlukan lisensi untuk otorisasi. Topik ini menjelaskan cara mendapatkan dan menggunakan lisensi tersebut.

Pembaruan layanan lisensi

Mulai dari versi V3.29.0, SDK video pendek menggunakan layanan lisensi ApsaraVideo MediaBox SDK. Lisensi ApsaraVideo MediaBox SDK mengotorisasi berbagai SDK, seperti Push SDK, SDK video pendek, ApsaraVideo Player SDK, dan Queen SDK. Lisensi ini diikat ke satu aplikasi—Anda dapat mengikat satu lisensi ke satu aplikasi Android dan satu aplikasi iOS. Metode integrasi SDK video pendek juga berubah seiring pembaruan ini.

Versi SDK video pendek

Metode integrasi

Integrasi baru

Jika Anda pengguna baru V3.29.0 atau versi yang lebih baru, integrasikan versi terbaru dengan mengikuti petunjuk dalam dokumentasi resmi.

Untuk informasi tentang cara mengintegrasikan SDK untuk Android, lihat Inisialisasi SDK.
Untuk informasi tentang cara mengintegrasikan SDK untuk iOS, lihat Inisialisasi SDK.

Peningkatan SDK

Jika Anda telah mengintegrasikan versi sebelum 3.29.0, Anda dapat terus menggunakan versi lama SDK selama periode validitas lisensi. Jika ingin meningkatkan ke V3.29.0 atau versi yang lebih baru, Anda harus memanggil API pendaftaran untuk mengintegrasikan LicenseKey dan LicenseFile ke dalam SDK.

Untuk informasi tentang cara mengintegrasikan SDK untuk Android, lihat Inisialisasi SDK.
Untuk informasi tentang cara mengintegrasikan SDK untuk iOS, lihat Inisialisasi SDK.

Otorisasi lisensi

Langkah 1: Buat aplikasi

Buka My Authorization di konsol VOD, pilih tab Application Management, lalu klik Create Application.
Isi informasi aplikasi. Aplikasi dikategorikan berdasarkan Platform Type: Web dan Mobile.
1. Web: Masukkan Application Name dan Web Domain Name untuk membuat aplikasi.
  Catatan tentang nama domain web
  - Format standar: aliyun.com.
    Penting
    Untuk mencakup beberapa subdomain, seperti pc.aliyun.com dan mobile.aliyun.com, cukup masukkan nama domain utama aliyun.com.
  - Format yang salah (jangan gunakan format berikut):
    - Termasuk protokol: http://aliyun.com atau https://aliyun.com.
    - Termasuk path atau subhalaman: aliyun.com/index atau aliyun.com/login.
    - Menggunakan nama domain wildcard: *.aliyun.com atau .aliyun.com.
2. Mobile: Masukkan Application Name, Package Name Android, BundleID iOS, dan HarmonyOS BundleID untuk membuat aplikasi.
  Sambungkan tanda tangan aplikasi Android
  Catatan
  Jika Anda memilih Android sebagai Platform Type dan memilih Attach Signature, bidang ini wajib diisi.
  Menyambungkan tanda tangan meningkatkan keamanan dan mencegah lisensi digunakan oleh aplikasi lain dengan nama paket yang sama.
  Versi SDK yang lebih baru tidak mengharuskan penyambungan tanda tangan. Ini mencakup MediaBox audio dan video SDK v1.7.0 ke atas, Player SDK v5.5.2 ke atas, Push SDK v4.4.9 ke atas, dan SDK video pendek v3.36.0 ke atas.
  Dapatkan Hash MD5 dari tanda tangan aplikasi Android dengan salah satu cara berikut:
  - Melalui command line: Jalankan keytool -v -list -keystore your.keystore untuk melihat Hash MD5 tanda tangan yang sesuai.
  - Melalui Android Studio: Di sidebar kanan, klik Gradle. Temukan aplikasi yang sesuai, lalu buka Tasks > android > signingReport untuk mendapatkan hash. Ubah semua huruf dalam Hash MD5 menjadi huruf kecil dan hapus tanda titik dua.

Langkah 2: Beli lisensi

Catatan

Jika Anda sudah membeli lisensi, lewati ke Langkah 3: Sambungkan lisensi.

Kembali ke halaman My Licenses, pilih tab Order Instance, lalu klik Purchase License.
Di halaman pembelian Audio and Video Terminal SDK, pilih SDK dan modul fungsional sesuai kebutuhan (fitur SDK tidak dapat dibeli secara kombinasi). Setelah mengonfirmasi pilihan, lanjutkan pembelian lisensi.
Penting
Seperti yang ditunjukkan pada gambar, fitur SDK hanya dapat dibeli secara individual. Misalnya, Anda dapat membeli Player SDK Edisi Standar secara terpisah.
Setelah pembayaran berhasil, kembali ke tab Order Instance. Anda dapat melihat instance pesanan yang baru dibeli.

Langkah 3: Sambungkan lisensi

Kembali ke halaman My Authorization, pilih tab License Management, lalu klik License Binding.
Di halaman Attach License, pilih aplikasi dan pesanan lisensi SDK yang sesuai untuk disambungkan. Setelah mengonfirmasi informasi, klik Attach.
Catatan
Setiap pesanan lisensi hanya dapat disambungkan ke satu aplikasi, baik aplikasi web maupun mobile.
Setelah lisensi disambungkan, kembali ke tab License Management. Anda dapat melihat nama aplikasi dan informasi otorisasinya.

Langkah 4: Dapatkan informasi otorisasi

Di tab License Management, temukan aplikasi target.
Pastikan informasi otorisasi sudah benar. Klik Download Certificate untuk mengunduh file sertifikat lisensi ke perangkat lokal Anda. Simpan License Key untuk digunakan saat mengintegrasikan lisensi ke dalam aplikasi. Untuk petunjuk konfigurasi file lisensi, lihat Integrasikan lisensi.

Perpanjang lisensi

Periksa masa kedaluwarsa lisensi

Lisensi SDK video pendek memiliki tanggal kedaluwarsa. Kriteria penentuan kedaluwarsa lisensi berbeda-beda tergantung versi SDK.

Versi sebelum 3.29.0:
- Nilai ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001) dikembalikan.
- Salah satu pesan berikut muncul di log:
  - Tidak ada jaringan selama 30 hari. Lisensi dinonaktifkan. Harap perpanjang atau dapatkan otorisasi baru.
  - Lisensi dinonaktifkan. Harap perpanjang atau dapatkan otorisasi baru.
  - Lisensi tidak valid (nama paket dan tanda tangan/BundleID tidak terdaftar di situs resmi SDK video pendek). Masa uji coba 7 hari telah berakhir, dan lisensi dinonaktifkan.
V3.29.0 dan versi yang lebih baru:
- Nilai ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001) dikembalikan.
- Salah satu pesan berikut muncul di log:
  - Lisensi telah kedaluwarsa. Harap perpanjang atau dapatkan otorisasi baru.
  - Lisensi belum diinisialisasi. Untuk informasi selengkapnya, lihat Inisialisasi SDK (Android) atau Inisialisasi SDK (iOS).
  - Lisensi tidak valid (nama paket dan tanda tangan/BundleID tidak terdaftar di situs resmi SDK video pendek). Harap dapatkan otorisasi baru.
  - Layanan bernilai tambah: xxx telah kedaluwarsa. Harap perpanjang atau dapatkan otorisasi baru. (xxx menunjukkan layanan bernilai tambah tertentu.)
  - Layanan bernilai tambah: xxx tidak valid. Harap dapatkan lisensi untuk layanan bernilai tambah yang sesuai sebelum digunakan. (xxx menunjukkan layanan bernilai tambah tertentu.)

Metode perpanjangan lisensi

Metode 1: Perpanjang dari halaman Manajemen Lisensi

Buka halaman My Authorization di konsol ApsaraVideo VOD.
Klik tab License Management. Temukan dan simpan ID instans yang disambungkan ke aplikasi target.
Penting
1. Jika ID instans kosong atau terjadi kesalahan saat perpanjangan, Anda harus menggunakan Metode 2: Beli lisensi baru dan sambungkan ke aplikasi atau ajukan tiket untuk memperpanjang.
2. Perpanjangan berlaku untuk seluruh pesanan lisensi. Jika pesanan lisensi Anda mencakup beberapa fitur SDK, semua fitur tersebut akan diperpanjang bersamaan. Peningkatan dan penurunan spesifikasi tidak didukung selama perpanjangan. Jika Anda memiliki pertanyaan, ajukan tiket.
Buka halaman Perpanjangan di konsol Biaya dan Pengeluaran. Cari pesanan menggunakan ID instans yang disimpan. Temukan pesanan tersebut dan klik Renew di kolom Actions.
Di halaman perpanjangan untuk Audio and Video Terminal SDK, pastikan konfigurasi dan durasi langganan Anda sudah benar. Lalu, klik Buy Now untuk menyelesaikan perpanjangan. Kami menyarankan Anda mengaktifkan Auto-renewal untuk mencegah gangguan layanan akibat lisensi kedaluwarsa.

Metode 2: Beli lisensi baru dan sambungkan ke aplikasi

Jika Anda membeli lisensi SDK tetapi ID instance pesanan yang sesuai kosong, atau terjadi kesalahan saat perpanjangan, Anda harus membeli lisensi baru dari halaman MediaBox Audio and Video SDK sebelum lisensi Anda saat ini kedaluwarsa. Setelah pembelian, sambungkan lisensi baru ke aplikasi Anda untuk mencegah gangguan bisnis akibat kegagalan pemanggilan SDK.