ApsaraVideo VOD: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 ApsaraVideo Media SDK bergantung pada License Key dan file lisensi. Persyaratan konfigurasinya adalah sebagai berikut:

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

Lingkungan layanan ApsaraVideo Player SDK

Untuk memenuhi persyaratan kepatuhan global, ApsaraVideo Player 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 ApsaraVideo Player 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). Namun, 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 seperti berikut.

Integrasikan lisensi pada client web

1. Peroleh License Key dari Konsol.

   

2. Saat menginisialisasi player, masukkan field 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 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

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 tetap berlanjut, lihat FAQ about licenses untuk troubleshooting.

      • Untuk pengguna situs internasional (www.alibabacloud.com) dengan ApsaraVideo Player SDK V6.14.0 ke atas, konfigurasikan lisensi untuk lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Tanpa ApsaraVideo Player 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 player 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 ApsaraVideo Player SDK (wajib untuk lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))).

   ApsaraVideo Player 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 ApsaraVideo Player 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 player apa pun. Ini memastikan semua layanan berikutnya berjalan di lingkungan situs internasional.
      // Gunakan antarmuka AlivcBase terpadu 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 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 menunjukkan konfigurasinya:

      <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 ApsaraVideo Player SDK V6.14.0 ke atas, konfigurasikan lisensi untuk lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok)). Tanpa ApsaraVideo Player 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 player 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 ApsaraVideo Player SDK (wajib untuk lingkungan Global (tidak termasuk Tiongkok daratan, Hong Kong (Tiongkok), Makau (Tiongkok), dan Taiwan (Tiongkok))).

   ApsaraVideo Player 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 ApsaraVideo Player 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 player apa pun. Ini memastikan semua layanan berikutnya berjalan di lingkungan situs internasional.
      // Gunakan antarmuka AlivcBase terpadu 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 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 Integrate a license on Android atau Integrate a license on iOS.