Mengintegrasikan lisensi untuk Push SDK, SDK video pendek, ApsaraVideo Player SDK, atau Queen SDK - ApsaraVideo VOD

Lisensi untuk ApsaraVideo MediaBox SDK terikat pada identitas aplikasi, yang memberi otorisasi kepada aplikasi untuk memanggil SDK. Setelah mendapatkan lisensi SDK, Anda harus mengintegrasikan lisensi ke dalam Push SDK, SDK video pendek, ApsaraVideo Player SDK, atau Queen SDK yang sesuai untuk menyelesaikan proses otorisasi. Topik ini menjelaskan cara mengintegrasikan lisensi pada klien Web, Android, dan iOS.

Prasyarat

Anda telah meminta lisensi dan menerima file lisensi serta kunci lisensi. Untuk informasi lebih lanjut, lihat Mengelola lisensi.

Alur otorisasi

Seperti ditunjukkan pada gambar sebelumnya, alur otorisasi lisensi untuk ApsaraVideo MediaBox SDK bergantung pada LicenseKey dan file lisensi. Persyaratan konfigurasi adalah sebagai berikut:

Item

Diperlukan

Deskripsi

LicenseKey

Digunakan untuk meminta pembaruan file lisensi.

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

File lisensi

Tidak, tetapi direkomendasikan.

File sertifikat digunakan untuk otorisasi ketika sertifikat tidak dapat diminta dengan sukses dari server. Hal ini dapat terjadi dalam skenario ekstrem, seperti ketika masalah jaringan mencegah sertifikat diunduh.

File sertifikat berisi izin yang diberikan dan periode validitas. Untuk meningkatkan tingkat keberhasilan otorisasi dalam kondisi jaringan lemah, perbarui file sertifikat bawaan saat izin berubah.

Catatan

Izin biasanya berubah ketika Anda mengaktifkan layanan baru, mengaktifkan layanan bernilai tambah, atau memperpanjang layanan.
Anda tidak perlu mengonfigurasi file lisensi untuk klien web.

Jika Anda tidak ingin menggunakan file lisensi bawaan karena alasan khusus, Anda dapat membiarkan konfigurasi terkait LicenseFile kosong. Untuk informasi lebih lanjut, lihat bagian berikutnya.

Catatan

Jika Anda tidak mengonfigurasi file sertifikat bawaan, otorisasi sepenuhnya bergantung pada server. Ini dapat menyebabkan otorisasi menjadi tidak stabil akibat ketidakstabilan jaringan. Selain itu, pengguna mungkin perlu menunggu sertifikat diunduh sebelum mereka dapat diotorisasi saat pertama kali menggunakan aplikasi. Waktu yang dibutuhkan tergantung pada kondisi jaringan pengguna.

Lingkungan layanan ApsaraVideo Player SDK

Untuk memenuhi persyaratan kepatuhan global, ApsaraVideo Player SDK V6.14.0 dan versi lebih baru menyediakan berbagai opsi lingkungan untuk memastikan lokalisasi layanan dan kepatuhan. Berdasarkan lingkungan layanan yang dipilih, data otorisasi lisensi dan layanan kualitas pemutaran untuk ApsaraVideo Player SDK ditangani oleh pusat layanan yang sesuai. Anda dapat memilih lingkungan layanan sesuai kebutuhan.

Pengguna Situs Internasional Alibaba Cloud hanya dapat menggunakan lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) (node Singapura). ApsaraVideo Player SDK V6.14.0 dan versi lebih baru menggunakan konfigurasi lingkungan Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok) secara default. Untuk memastikan proses otorisasi lisensi berjalan lancar, Anda harus memperbarui konfigurasi ApsaraVideo Player SDK ke lingkungan situs internasional seperti yang dijelaskan di bawah ini.

Lingkungan	Deskripsi
Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)	Situs China (aliyun.com) lingkungan (default). Layanan disediakan melalui node Alibaba Cloud di Shanghai, Tiongkok, untuk memenuhi kebutuhan akses dan otorisasi pengguna di Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok).
Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))	Situs internasional (alibabacloud.com) lingkungan: Lingkungan yang dirancang untuk pengguna situs internasional yang menyediakan layanan dari node Singapura untuk memenuhi persyaratan kepatuhan dan performa wilayah tertentu.

Mengintegrasikan lisensi pada klien web

Dapatkan License Key dari Konsol.

Saat menginisialisasi pemain, lewati bidang `license`, yang mencakup nama domain terdaftar dan License Key.

var player = new Aliplayer({
  license: {
    domain: "example.com", // Nama domain yang Anda masukkan saat meminta lisensi
    key: "example-key" // License Key yang ditampilkan di Konsol setelah permintaan disetujui
  }
});

Setelah pemain diinisialisasi, jika tidak ada kesalahan yang dilaporkan, lisensi telah dikonfigurasi.
Catatan
Pastikan nama domain halaman tempat pemain berada sama dengan nama domain yang Anda masukkan saat meminta lisensi, atau merupakan subdomain dari nama domain tersebut. Jika tidak, verifikasi lisensi akan gagal.

Mengintegrasikan lisensi pada klien Android

Konfigurasikan lisensi.
1. (Direkomendasikan) Salin file sertifikat ke folder `assets` proyek Android Studio Anda.
  Catatan
  Anda juga dapat menyalin file sertifikat ke lokasi lain di perangkat. Namun, pastikan nilai dari com.aliyun.alivc_license.licensefile (Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) atau com.aliyun.alivc_license.licensefile_SEA (Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))) pada langkah berikutnya sama dengan jalur file lisensi.
2. Tambahkan node <meta-data> ke file `AndroidManifest.xml`.
  Penting
  - Jika verifikasi gagal setelah mengonfigurasi lisensi, periksa apakah node <meta-data> berada di bawah elemen <application> dan apakah nama <meta-data> benar. Jika masalah berlanjut, lihat FAQ tentang lisensi untuk pemecahan masalah.
  - Untuk pengguna situs internasional, jika Anda menggunakan ApsaraVideo Player SDK V6.14.0 atau lebih baru, Anda harus mengonfigurasi lisensi untuk lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Jika Anda tidak menggunakan ApsaraVideo Player SDK, Anda hanya dapat mengonfigurasi lisensi untuk lingkungan Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok).
  - Anda dapat mengintegrasikan dua set lisensi sekaligus (satu untuk lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) dan satu untuk lingkungan Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Kemudian, setiap kali aplikasi dimulai, Anda dapat menentukan lingkungan waktu proses untuk pemain dengan mengonfigurasi lingkungan layanan ApsaraVideo Player SDK. Anda tidak dapat beralih lingkungan saat pemain sedang berjalan.
```
// Konfigurasikan lisensi untuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok) (konfigurasi default situs China)
<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 (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Secara manual tambahkan _SEA 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 (diperlukan jika Anda menggunakan lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))).
ApsaraVideo Player SDK V6.14.0 dan versi lebih baru memungkinkan Anda memilih lingkungan layanan. Konfigurasi default adalah untuk lingkungan Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Untuk menggunakan lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) (saat ini, pengguna situs internasional hanya dapat menggunakan lingkungan ini), Anda harus menggunakan salah satu metode berikut untuk memperbarui konfigurasi ApsaraVideo Player SDK ke lingkungan situs internasional. Jika tidak, otorisasi lisensi untuk ApsaraVideo Player SDK akan gagal. Untuk versi SDK lainnya dan skenario lainnya, Anda dapat melewati langkah ini.
1. Metode 1: Panggil metode berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional.
```
// Saat menggunakan lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)), pastikan untuk memanggil antarmuka berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional sebelum memanggil API pemain apa pun. Ini memastikan bahwa semua layanan berikutnya berjalan di lingkungan situs internasional.
// Gunakan antarmuka AlivcBase yang seragam untuk mengatur lingkungan situs internasional. Lingkungan tidak dapat diubah 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, Anda dapat mengonfigurasi lingkungan situs internasional menggunakan metode XML.
  Tambahkan node <meta-data> ke file AndroidManifest.xml.
```
<meta-data
  android:name="com.aliyun.alivc_env"
  android:value="SEA"/>  
```
  Gambar berikut menunjukkan contoh konfigurasi.

Mengintegrasikan lisensi pada klien iOS

Konfigurasikan lisensi.
1. Tambahkan file sertifikat AliVideoCert-********.crt ke proyek Xcode Anda. Kami merekomendasikan menempatkannya di folder AppSupportFiles, tetapi Anda juga dapat menempatkannya di sandbox atau jalur lain. Di Target Membership, pilih proyek saat ini.
2. Buka `Info.plist`. Atur AlivcLicenseKey dan AlivcLicenseFile untuk lingkungan Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok), atau AlivcLicenseKey_SEA dan AlivcLicenseFile_SEA untuk lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)), ke License Key dan jalur file lisensi yang diperoleh dari Mengelola lisensi.
  Penting
  - Untuk pengguna situs internasional, jika Anda menggunakan ApsaraVideo Player SDK V6.14.0 atau lebih baru, Anda harus mengonfigurasi lisensi untuk lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Jika Anda tidak menggunakan ApsaraVideo Player SDK, Anda hanya dapat mengonfigurasi lisensi untuk lingkungan Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok).
  - Anda dapat mengintegrasikan dua set lisensi sekaligus (satu untuk lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) dan satu untuk lingkungan Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Kemudian, setiap kali aplikasi dimulai, Anda dapat menentukan lingkungan waktu proses untuk pemain dengan mengonfigurasi lingkungan layanan pemain. Anda tidak dapat beralih lingkungan saat pemain sedang berjalan.
```
// Konfigurasikan lisensi untuk Daratan Tiongkok, 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 (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Secara manual tambahkan _SEA di akhir kunci.
<key>AlivcLicenseFile_SEA</key>
<string>XXX</string>
<key>AlivcLicenseKey_SEA</key>
<string>f6b6efoIVziMaUHaRqgDyhb8fcf014af39535d0a32072****</string>
```
Konfigurasikan lingkungan layanan untuk ApsaraVideo Player SDK (diperlukan jika Anda menggunakan lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))).
ApsaraVideo Player SDK V6.14.0 dan versi lebih baru memungkinkan Anda memilih lingkungan layanan. Konfigurasi default adalah untuk lingkungan Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Untuk menggunakan lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) (saat ini, pengguna situs internasional hanya dapat menggunakan lingkungan ini), Anda harus menggunakan salah satu metode berikut untuk memperbarui konfigurasi ApsaraVideo Player SDK ke lingkungan situs internasional. Jika tidak, otorisasi lisensi untuk ApsaraVideo Player SDK akan gagal. Untuk versi SDK lainnya dan skenario lainnya, Anda dapat melewati langkah ini.
1. Metode 1: Panggil metode berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional.
```
// Saat menggunakan lingkungan Global (tidak termasuk Daratan Tiongkok, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)), pastikan untuk memanggil antarmuka berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional sebelum memanggil API pemain apa pun. Ini memastikan bahwa semua layanan berikutnya berjalan di lingkungan situs internasional.
// Gunakan antarmuka AlivcBase yang seragam untuk mengatur lingkungan situs internasional. Lingkungan tidak dapat diubah selama waktu proses.
AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;
```
2. Metode 2 (Direkomendasikan): Untuk ApsaraVideo Player SDK V7.6.0 dan versi lebih baru, Anda dapat mengonfigurasi lingkungan situs internasional menggunakan metode Info.plist.
  Buka file Info.plist dan atur AlivcEnv ke SEA.
```
// Atur lingkungan saat ini ke lingkungan situs internasional.
<key>AlivcEnv</key>
<string>SEA</string>
```
  Gambar berikut menunjukkan contoh konfigurasi.

Mengintegrasikan lisensi pada klien Flutter

Flutter adalah solusi lintas platform yang dikembangkan oleh Google. Oleh karena itu, untuk klien Flutter, Anda harus mengintegrasikan lisensi untuk Android dan iOS, atau mengintegrasikan lisensi yang sesuai berdasarkan skenario bisnis Anda. Untuk informasi lebih lanjut, lihat Mengintegrasikan lisensi pada klien Android atau Mengintegrasikan lisensi pada klien iOS.