integrasikan lisensi SDK Android iOS web HarmonyOS Pemutar Video Apsara - ApsaraVideo VOD

Lisensi ApsaraVideo Media SDK terikat pada identifier aplikasi untuk mengotorisasi pemanggilan SDK. Setelah memperoleh lisensi, integrasikan ke Push SDK, Short Video SDK, ApsaraVideo Player SDK, atau Queen SDK guna menyelesaikan otorisasi pada klien web, Android dan iOS.

Prasyarat

File lisensi dan License Key yang diperoleh dari Kelola lisensi.

Alur autentikasi

Autentikasi lisensi bergantung pada License Key dan file lisensi.

Item

Wajib

Deskripsi

License Key

Digunakan untuk meminta pembaruan file lisensi.

SDK memeriksa pembaruan selama inisialisasi dan setiap 15 menit selama waktu proses.

License file

Tidak. Konfigurasi yang Direkomendasikan

Berfungsi sebagai fallback untuk autentikasi ketika permintaan sertifikat dari sisi server gagal, misalnya saat terjadi gangguan jaringan.

File sertifikat menyimpan izin yang diaktifkan dan periode validitas. Perbarui file ini saat izin berubah agar tetap andal di lingkungan jaringan lemah.

Catatan

Perubahan izin biasanya mencakup aktivasi layanan baru, pengaktifan layanan bernilai tambah, atau perpanjangan layanan.
Native ApsaraVideo Player SDK V7.6.0 dan versi lebih baru memerlukan file lisensi.
Klien web tidak memerlukan file lisensi.
Untuk perpanjangan, sertifikat diperbarui secara online otomatis, tetapi perbarui file lokal agar pemeriksaan periode validitas berhasil.

Untuk melewatkan file lisensi bawaan, abaikan konfigurasi LicenseFile dalam langkah-langkah spesifik platform di bawah ini.

Catatan

Tanpa file sertifikat bawaan, autentikasi sepenuhnya bergantung pada server. Fluktuasi jaringan dapat menyebabkan ketidakstabilan, dan pengguna pertama kali harus menunggu hingga unduhan sertifikat selesai sebelum autentikasi berhasil.

Lingkungan layanan ApsaraVideo Player SDK

ApsaraVideo Player SDK V6.14.0 dan versi lebih baru menyediakan beberapa lingkungan layanan untuk kepatuhan global. Lingkungan yang dipilih menentukan pusat layanan mana yang menangani autentikasi lisensi dan data kualitas pemutaran.

Pengguna Alibaba Cloud International Website (www.alibabacloud.com) hanya dapat menggunakan lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) (node Singapura). Namun, V6.14.0 dan versi lebih baru secara default menggunakan lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Perbarui konfigurasi ke lingkungan situs internasional seperti berikut.

Lingkungan	Deskripsi
Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)	Lingkungan Alibaba Cloud China Website (www.aliyun.com) (default). Menggunakan node Shanghai, Tiongkok untuk melayani pengguna di Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok).
Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))	Lingkungan Alibaba Cloud International Website. Menggunakan node Singapura untuk kepatuhan dan kinerja di wilayah luar Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok).

Integrasikan lisensi pada klien web

Peroleh License Key dari Konsol.

Saat menginisialisasi pemutar, masukkan bidang license yang mencakup Nama domain terdaftar dan License Key:

var player = new Aliplayer({
  license: {
    domain: "example.com", // Nama domain yang Anda masukkan saat mengajukan lisensi
    key: "example-key" // License Key yang dapat Anda lihat di Konsol setelah pengajuan berhasil
  }
});

Jika tidak muncul pesan error setelah inisialisasi, berarti lisensi telah berhasil dikonfigurasi.
Catatan
Domain halaman harus sesuai atau merupakan subdomain dari domain yang didaftarkan dalam pengajuan lisensi Anda. Jika tidak, verifikasi akan gagal.

Integrasikan lisensi pada Android

Konfigurasikan lisensi.
1. (Direkomendasikan) Salin file sertifikat ke direktori assets dalam proyek Android Studio Anda.
  Catatan
  Anda juga dapat menyalin file sertifikat ke lokasi lain di Perangkat. Namun, pastikan nilai com.aliyun.alivc_license.licensefile (untuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) atau com.aliyun.alivc_license.licensefile_SEA (untuk Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))) sesuai dengan path file lisensi.
2. Dalam file AndroidManifest.xml, tambahkan node <meta-data>.
  Penting
  - Jika autentikasi gagal setelah Anda mengonfigurasi lisensi, periksa apakah elemen <meta-data> telah ditambahkan di bawah elemen <application> dan apakah nama dalam elemen <meta-data> sudah benar. Jika masalah tetap berlanjut, lihat FAQ tentang lisensi untuk troubleshooting.
  - Untuk pengguna Alibaba Cloud International Website (www.alibabacloud.com), jika Anda menggunakan ApsaraVideo Player SDK V6.14.0 atau versi lebih baru, konfigurasikan lisensi untuk lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Jika Anda tidak menggunakan ApsaraVideo Player SDK, cukup konfigurasikan lisensi untuk lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok).
  - Anda dapat mengintegrasikan dua set lisensi: satu untuk lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) dan satu untuk lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Setelah mengintegrasikan lisensi, tentukan lingkungan operasi pemutar dengan mengonfigurasi lingkungan layanannya setiap kali aplikasi dimulai. Anda tidak dapat mengganti lingkungan saat pemutar sedang Berjalan.
```
// Konfigurasikan lisensi untuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok) (konfigurasi default situs Tiongkok)
<meta-data
    android:name="com.aliyun.alivc_license.licensekey"
    android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/>  
<meta-data
    android:name="com.aliyun.alivc_license.licensefile"
    android:value="assets/cert/release.crt"/>  


// Konfigurasikan lisensi untuk lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Tambahkan _SEA secara manual di akhir nama.
<meta-data
    android:name="com.aliyun.alivc_license.licensekey_SEA"
    android:value="f6b6foIVziMaUHaRqgDyheb8fcf014af39535d0a32720****"/>  
<meta-data
    android:name="com.aliyun.alivc_license.licensefile_SEA"
    android:value="assets/cert/release.crt"/>  
```
Konfigurasikan lingkungan layanan untuk ApsaraVideo Player SDK (wajib untuk lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))).
ApsaraVideo Player SDK V6.14.0 dan versi lebih baru secara default menggunakan lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Pengguna Alibaba Cloud International Website harus beralih ke lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) menggunakan salah satu metode berikut. Jika tidak, autentikasi lisensi akan gagal. Untuk versi lain dan skenario penggunaan SDK, abaikan langkah ini.
1. Metode 1: Panggil API berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional.
```
// Jika Anda menggunakan lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)), pastikan Anda memanggil antarmuka berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional sebelum memanggil API pemutar apa pun. Hal ini memastikan semua layanan selanjutnya berjalan di lingkungan situs internasional.
// Gunakan antarmuka terpadu AlivcBase untuk mengatur lingkungan situs internasional. Anda tidak dapat mengubah lingkungan selama waktu proses.
AlivcBase.getEnvironmentManager().setGlobalEnvironment(AlivcEnv.GlobalEnv.ENV_SEA);
```
2. Metode 2 (Direkomendasikan): Untuk ApsaraVideo Player SDK V7.6.0 dan versi lebih baru, konfigurasikan lingkungan situs internasional menggunakan metode XML.
  Dalam file AndroidManifest.xml, tambahkan node <meta-data>.
```
<meta-data
  android:name="com.aliyun.alivc_env"
  android:value="SEA"/>  
```
  Gambar berikut menunjukkan contoh konfigurasi:

Integrasikan lisensi pada iOS

Konfigurasikan lisensi.
1. Dalam proyek Xcode Anda, salin file sertifikat AliVideoCert-********.crt ke dalam proyek. Kami menyarankan menempatkannya di direktori AppSupportFiles. Anda juga dapat menempatkannya di sandbox atau path lain. Di Target Membership, pilih proyek saat ini.
2. Buka file Info.plist. Atur AlivcLicenseKey dan AlivcLicenseFile (untuk lingkungan Tiongkok) atau AlivcLicenseKey_SEA dan AlivcLicenseFile_SEA (untuk lingkungan Internasional) ke License Key dan path file lisensi yang diperoleh dari Kelola lisensi.
  Penting
  - Untuk pengguna Alibaba Cloud International Website (www.alibabacloud.com), jika Anda menggunakan ApsaraVideo Player SDK V6.14.0 atau versi lebih baru, konfigurasikan lisensi untuk lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Jika Anda tidak menggunakan ApsaraVideo Player SDK, cukup konfigurasikan lisensi untuk lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok).
  - Anda dapat mengintegrasikan dua set lisensi: satu untuk lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) dan satu untuk lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Setelah mengintegrasikan lisensi, tentukan lingkungan operasi pemutar dengan mengonfigurasi lingkungan layanannya setiap kali aplikasi dimulai. Anda tidak dapat mengganti lingkungan saat pemutar sedang Berjalan.
```
// Konfigurasikan lisensi untuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok) (konfigurasi default)
<key>AlivcLicenseFile</key>
<string>XXX</string>
<key>AlivcLicenseKey</key>
<string>foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****</string>


// Konfigurasikan lisensi untuk lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Tambahkan _SEA secara manual di akhir nama kunci.
<key>AlivcLicenseFile_SEA</key>
<string>XXX</string>
<key>AlivcLicenseKey_SEA</key>
<string>f6b6efoIVziMaUHaRqgDyhb8fcf014af39535d0a32072****</string>
```
Konfigurasikan lingkungan layanan untuk ApsaraVideo Player SDK (wajib untuk lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))).
ApsaraVideo Player SDK V6.14.0 dan versi lebih baru secara default menggunakan lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Pengguna Alibaba Cloud International Website harus beralih ke lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) menggunakan salah satu metode berikut. Jika tidak, autentikasi lisensi akan gagal. Untuk versi lain dan skenario penggunaan SDK, abaikan langkah ini.
1. Metode 1: Panggil API berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional.
```
// Jika Anda menggunakan lingkungan Global (kecuali Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)), pastikan Anda memanggil antarmuka berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional sebelum memanggil API pemutar apa pun. Hal ini memastikan semua layanan selanjutnya berjalan di lingkungan situs internasional.
// Gunakan antarmuka terpadu AlivcBase untuk mengatur lingkungan situs internasional. Anda tidak dapat mengubah lingkungan selama waktu proses.
AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;
```
2. Metode 2 (Direkomendasikan): Untuk ApsaraVideo Player SDK V7.6.0 dan versi lebih baru, konfigurasikan lingkungan situs internasional menggunakan metode Info.Plist.
  Buka file Info.plist dan atur AlivcEnv ke SEA.
```
// Konfigurasikan lingkungan saat ini sebagai lingkungan situs internasional.
<key>AlivcEnv</key>
<string>SEA</string>
```
  Gambar berikut menunjukkan contoh konfigurasi:

Integrasikan lisensi pada Flutter

Untuk aplikasi Flutter, integrasikan lisensi pada setiap platform yang didukung: Integrasikan lisensi pada Android atau Integrasikan lisensi pada iOS.