All Products
Search

This Product

    ApsaraVideo Live:Integrasikan Queen SDK untuk iOS

    Document Center

    ApsaraVideo Live:Integrasikan Queen SDK untuk iOS

    Last Updated:Feb 07, 2026

    Queen SDK adalah fitur efek retouching yang disediakan oleh tim video Alibaba Cloud. SDK ini mendukung berbagai layanan kustomisasi personalisasi, seperti retouching gambar, retouching wajah, chroma key, stiker, makeup, deteksi gerakan tangan, pembentukan tubuh, tata rambut, dan tulisan AR. SDK ini berlaku untuk skenario seperti ApsaraVideo Live, konferensi video, dan produksi video pendek. Topik ini menjelaskan cara mengintegrasikan Queen SDK untuk iOS guna mengimplementasikan fitur retouching.

    Prasyarat

    Tabel berikut mencantumkan persyaratan lingkungan pengembangan.

    Kategori

    Deskripsi

    Versi sistem

    Mendukung iOS 9.0 dan versi yang lebih baru.

    Versi macOS High Sierra

    Mendukung macOS High Sierra 10.13 dan versi yang lebih baru.

    Versi Xcode

    Mendukung Xcode 9.0 dan versi yang lebih baru. Unduh Xcode.

    Perangkat iOS

    Perangkat seluler dengan arsitektur armv7 atau arm64, seperti iPad atau iPhone. Tidak termasuk Mac yang mendukung arsitektur arm64.

    Metode integrasi

    SDK mendukung integrasi melalui pod maupun lokal. Pilih metode integrasi yang paling sesuai dengan kebutuhan Anda.

    Integrasi Pod

    Untuk mengintegrasikan menggunakan pod, ikuti langkah-langkah berikut:

    pod 'Queen', '6.1.0-official-pro'

    Integrasi lokal

    1. Unduh dan ekstrak proyek contoh untuk memperoleh framework berikut.

      queen.framework
opencv2.framework
      Penting

      Versi lite tidak memerlukan opencv2.framework.

    2. Buka Xcode. Di target proyek, pada tab General, tambahkan framework tersebut di bagian Frameworks, Libraries, and Embedded Content. Atur properti Embed framework yang ditambahkan menjadi Embed & Sign.

    3. Di target proyek, pada tab Build Settings, cari ENABLE_BITCODE lalu atur nilainya menjadi NO.

    4. Tambahkan mnn.metallib dari queen.framework ke direktori proyek. Langkah ini hanya diperlukan untuk versi full dan ultimate.

    Konfigurasi lisensi

    Anda harus memperoleh lisensi terlebih dahulu. Untuk informasi selengkapnya, lihat Memperoleh Lisensi Queen SDK. Setelah memperoleh lisensi, konfigurasikan LicenseKey dan LicenseFile (file sertifikat) dalam proyek sebagai berikut.

    Catatan

    • Jika Anda mengintegrasikan Queen SDK untuk ApsaraVideo Live dan SDK video pendek untuk ApsaraVideo VOD secara bersamaan, LicenseKey dan LicenseFile (file sertifikat)-nya sama. Cukup konfigurasikan satu kali saja. Gunakan file sertifikat terbaru.

    • Jika versi SDK yang Anda beli berubah atau memerlukan perpanjangan (masa berlaku SDK habis), perbarui file sertifikat tersebut dengan cara berikut:

      1. Peroleh lisensi baru. Untuk petunjuknya, lihat Memperoleh Lisensi Queen SDK. Untuk memperoleh file sertifikat terbaru, kirim email.

      2. Setelah memperoleh sertifikat terbaru, perbarui dengan mengikuti langkah-langkah konfigurasi lisensi dalam topik ini.

    Impor file sertifikat ke dalam proyek aplikasi, lalu tambahkan dua Key ke file Info.plist.

    • Key pertama adalah AlivcLicenseKey. Nilainya adalah LicenseKey, contohnya: MoCTfuQ391Z01****8f8745e23c8a457a8ff8d5faedc1****.

    • Key kedua adalah AlivcLicenseFile. Nilainya adalah path file sertifikat (relatif terhadap mainBundle), contohnya: AliVideoCert_164933454****.crt.

    Referensi

    Item

    Tautan

    Proyek contoh

    Proyek contoh

    Proyek demo di GitHub

    Proyek demo

    Contoh integrasi vendor SDK umum untuk pengembang.