Apsara Video SDK:Integrasikan lisensi

Prasyarat

Anda telah mengajukan permohonan lisensi dan memperoleh file lisensi serta License Key. Untuk informasi lebih lanjut, lihat Manage a license.

Alur autentikasi

Seperti ditunjukkan pada gambar sebelumnya, autentikasi lisensi Apsara Video SDK bergantung pada License Key dan file lisensi. Persyaratan konfigurasinya adalah sebagai berikut:

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

Lingkungan layanan Pemutar Video Apsara SDK

Untuk memenuhi persyaratan kepatuhan global, Pemutar Video Apsara SDK versi V6.14.0 ke atas menyediakan beberapa lingkungan layanan yang menjaga layanan tetap terlokalisasi dan sesuai regulasi. Lingkungan yang Anda pilih menentukan pusat layanan mana yang mendukung autentikasi lisensi dan data kualitas pemutaran Pemutar Video Apsara SDK. Pilih lingkungan layanan yang sesuai dengan kebutuhan Anda.

Pengguna Alibaba Cloud International Website (www.alibabacloud.com) hanya dapat menggunakan lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) (node Singapura). Versi V6.14.0 ke atas secara default menggunakan lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Perbarui konfigurasi ke lingkungan situs internasional sebagai berikut.

Integrasikan lisensi pada klien web

1. Peroleh License Key dari Konsol.

   Di panel navigasi kiri, pilih SDK Management > My Licenses. Pada tab License Management, temukan bidang License Key dan salin nilainya.

2. 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
     }
   });

3. Jika tidak ada 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

1. Konfigurasikan lisensi.

   1. (Direkomendasikan) Salin file sertifikat ke direktori assets dalam proyek Android Studio Anda.

      Catatan

      Anda dapat menempatkan file sertifikat di lokasi lain pada perangkat, tetapi pastikan 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 (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))) sesuai dengan path file aktual.

   2. Dalam file AndroidManifest.xml, tambahkan node <meta-data>.

      Penting

      • Jika verifikasi gagal setelah Anda mengonfigurasi lisensi, periksa apakah node <meta-data> ditempatkan di bawah elemen <application> dan apakah nama node <meta-data> sudah benar. Jika masalah berlanjut, lihat FAQ about licenses untuk troubleshooting.

      • Untuk pengguna situs internasional (www.alibabacloud.com) dengan Pemutar Video Apsara SDK versi V6.14.0 ke atas, konfigurasikan lisensi untuk lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Tanpa Pemutar Video Apsara SDK, cukup konfigurasikan lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok).

      • Anda dapat mengintegrasikan dua set lisensi: satu untuk Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) dan satu untuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Atur lingkungan layanan pemutar setiap kali aplikasi dimulai. Anda tidak dapat mengganti lingkungan selama waktu proses.

      // 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****"/>  <!-- TODO: Setel nilai LicenseKey Anda. -->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Setel path file lisensi Anda. -->
      
      
      // Konfigurasikan lisensi untuk lingkungan Global (tidak termasuk 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****"/>  <!-- TODO: Setel nilai LicenseKey Anda. -->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile_SEA"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Setel path file lisensi Anda. -->

2. Konfigurasikan lingkungan layanan untuk Pemutar Video Apsara SDK (wajib untuk lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))).

   Pemutar Video Apsara SDK mendukung pemilihan lingkungan layanan mulai dari V6.14.0. Versi V6.14.0 ke atas secara default menggunakan lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Untuk menggunakan lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)), yang saat ini merupakan satu-satunya lingkungan yang tersedia bagi pengguna situs internasional, gunakan salah satu metode berikut untuk mengalihkan Pemutar Video Apsara SDK ke lingkungan situs internasional. Jika tidak, autentikasi lisensi akan gagal. Lewati langkah ini untuk versi lain dan SDK lainnya.

   1. Metode 1: Panggil API berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional.

      // Jika Anda menggunakan lingkungan Global (tidak termasuk 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. 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 Pemutar Video Apsara SDK versi V7.6.0 ke atas, 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"/>  

      Contoh berikut menampilkan konfigurasi:

      <manifest xmlns:android="http://schemas.android.com/apk/res/android">
          <application
              ...>
              <!-- Konfigurasi lainnya -->
      
              <meta-data
                  android:name="com.aliyun.alivc_license.licensekey_SEA"
                  android:value="xxx" />
              <meta-data
                  android:name="com.aliyun.alivc_license.licensefile_SEA"
                  android:value="assets/SEALicense.crt" />
      
              <meta-data
                  android:name="com.aliyun.alivc_env"
                  android:value="SEA"/>
      
          </application>
      
      </manifest>

Integrasikan lisensi pada iOS

1. Konfigurasikan lisensi.

   1. Salin file sertifikat AliVideoCert-********.crt ke dalam proyek Xcode Anda. Tempatkan di direktori AppSupportFiles (direkomendasikan), sandbox, atau path lainnya. Di Target Membership, pilih proyek saat ini.

      Dalam file Info.plist proyek Anda, tambahkan dua item konfigurasi berikut:

      • AlivcLicenseFile (String): Atur ke nama file sertifikat, misalnya, license.crt.

      • AlivcLicenseKey (String): Atur ke nilai License Key yang Anda peroleh.

   2. Buka file Info.plist. Atur AlivcLicenseKey dan AlivcLicenseFile (untuk lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) atau AlivcLicenseKey_SEA dan AlivcLicenseFile_SEA (untuk lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))) ke License Key dan path file lisensi yang Anda peroleh di Manage a license.

      Penting

      • Untuk pengguna situs internasional (www.alibabacloud.com) dengan Pemutar Video Apsara SDK versi V6.14.0 ke atas, konfigurasikan lisensi untuk lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Tanpa Pemutar Video Apsara SDK, cukup konfigurasikan lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok).

      • Anda dapat mengintegrasikan dua set lisensi: satu untuk Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)) dan satu untuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Atur lingkungan layanan pemutar setiap kali aplikasi dimulai. Anda tidak dapat mengganti lingkungan selama waktu proses.

      // 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 (tidak termasuk 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>

2. Konfigurasikan lingkungan layanan untuk Pemutar Video Apsara SDK (wajib untuk lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))).

   Pemutar Video Apsara SDK mendukung pemilihan lingkungan layanan mulai dari V6.14.0. Versi V6.14.0 ke atas secara default menggunakan lingkungan Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok). Untuk menggunakan lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)), yang saat ini merupakan satu-satunya lingkungan yang tersedia bagi pengguna situs internasional, gunakan salah satu metode berikut untuk mengalihkan Pemutar Video Apsara SDK ke lingkungan situs internasional. Jika tidak, autentikasi lisensi akan gagal. Lewati langkah ini untuk versi lain dan SDK lainnya.

   1. Metode 1: Panggil API berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional.

      // Jika Anda menggunakan lingkungan Global (tidak termasuk 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. 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 Pemutar Video Apsara SDK versi V7.6.0 ke atas, 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>

      Anda juga harus menambahkan file sertifikat SEALicense.crt ke direktori AppSupportFiles dalam proyek Anda. Dalam file Info.plist, konfigurasikan pasangan kunci-nilai berikut:

      • AlivcLicenseFile_SEA: Atur ke SEALicense.crt

      • AlivcLicenseKey_SEA: Atur ke License Key Anda

Integrasikan lisensi pada Flutter

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