Queen SDK adalah SDK Retouching pintar yang dikembangkan oleh tim video cloud Alibaba. SDK ini menyediakan berbagai fitur, termasuk retouching gambar, retouching wajah, chroma key, stiker, makeup, pengenalan gerakan (gesture recognition), pembentukan tubuh (body shaping), tata rambut (hairdressing), dan penulisan augmented reality (AR). Fitur-fitur tersebut dapat digunakan dalam skenario live streaming, konferensi video, dan produksi video pendek. Topik ini menjelaskan cara mengintegrasikan Queen SDK untuk Android guna membantu Anda menerapkan fitur retouching.
Prasyarat
Lingkungan pengembangan telah disiapkan. Tabel berikut menjelaskan persyaratan lingkungan pengembangan.
Item | Deskripsi |
Android | Android 4.3 atau versi lebih baru. |
Java | Java 1.7 atau versi lebih baru. |
API LEVEL | Android API level 18 atau versi lebih baru. |
Android Studio | Android Studio 2.3 atau versi lebih baru. Untuk mengunduh Android Studio, kunjungi Android Studio. |
Panduan integrasi
(Direkomendasikan) Integrasikan SDK menggunakan dependensi Maven
Tambahkan repositori Maven Alibaba Cloud ke file build.gradle proyek Anda.
allprojects { repositories { google() jcenter() maven { url "https://maven.aliyun.com/repository/releases" } } }Tambahkan dependensi Queen SDK ke file build.gradle aplikasi Anda.
// Paket Queen SDK. implementation "com.aliyun.maliang.android:queen:6.8.1-official-pro" // Opsional. Komponen menu Queen SDK. implementation "com.aliyun.maliang.android:queen_menu:6.8.1-official-pro-tiny" // Unduh sumber daya menu. implementation "com.aliyun.maliang.android:queen_menu:6.8.1-official-pro" // Kemas sumber daya menu di mesin lokal Anda.
Pustaka fitur retouching dan pustaka SDK Alibaba Cloud seperti Alibaba Cloud Real-Time Communication (RTC) SDK mungkin berisi file duplikat. Akibatnya, aplikasi Anda mungkin gagal dikemas. Dalam kasus ini, tambahkan parameter packagingOptions ke file build.gradle proyek Anda untuk menghindari konflik file, seperti yang ditunjukkan pada kode berikut. Jika tidak ada file duplikat, Anda tidak perlu menambahkan parameter ini.
android {
...
compileSdkVersion ...
...
packagingOptions {
pickFirst '**/libMNN.so' // Jika terdapat file libMNN.so duplikat, tambahkan baris kode ini.
pickFirst '**/libMNN_CL.so' // Jika terdapat file libMNN_CL.so duplikat, tambahkan baris kode ini.
pickFirst '**/libc++_shared.so' // Jika terdapat file libc++_shared.so duplikat, tambahkan baris kode ini.
}
...
}Integrasikan SDK secara manual
Unduh dan ekstrak paket Queen SDK.
Salin file .aar yang diekstrak dari paket SDK ke folder libs proyek Anda.
Tambahkan dependensi pada paket AAR menggunakan Gradle.
dependencies { implementation fileTree(include: ['*.aar'], dir: 'libs') }Tambahkan dependensi berikut ke kode:
dependencies { implementation files('libs/alivc-livepusher-lib-release.aar') }Klik Sync Now untuk mengompilasi proyek.
Konfigurasi izin
Anda harus mengonfigurasi izin aplikasi dalam file AndroidManifest.xml terlebih dahulu. Untuk mengintegrasikan Queen SDK untuk Android, izin berikut diperlukan:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.CAMERA" />Izin perlu diminta saat runtime pada Android 6.0 atau versi lebih baru. Contoh kode berikut menunjukkan cara mengonfigurasi izin:
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
== PackageManager.PERMISSION_GRANTED) {
// Anda telah memperoleh izin.
//...
} else {
// Anda belum memiliki izin ini. Ajukan permohonan izin.
// PERMISSION_REQUEST_CODE menentukan kode permohonan izin. Anda dapat mengatur kode ini ke angka apa pun.
ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.CAMERA}, PERMISSION_REQUEST_CODE);
}Konfigurasi lisensi
Pastikan Anda telah memperoleh lisensi untuk Queen SDK sebelumnya. Untuk informasi selengkapnya, lihat Memperoleh lisensi Queen SDK. Setelah memperoleh lisensi, lakukan langkah-langkah berikut untuk mengonfigurasi kunci lisensi dan file lisensi dalam proyek Anda:
Jika Anda mengintegrasikan Queen SDK dari ApsaraVideo Live dan SDK video pendek dari ApsaraVideo VOD secara bersamaan, kedua SDK tersebut menggunakan kunci lisensi dan file lisensi yang sama. Anda hanya perlu mengonfigurasi lisensi satu kali. Pastikan untuk menggunakan file lisensi terbaru.
Jika SDK yang Anda beli diperbarui atau perlu diperpanjang, Anda juga harus memperbarui lisensi. Ikuti langkah-langkah berikut untuk memperbarui lisensi:
Peroleh lisensi terbaru. Untuk informasi selengkapnya, lihat Memperoleh lisensi Queen SDK.
Setelah memperoleh lisensi terbaru, konfigurasikan ulang lisensi tersebut.
Impor lisensi ke folder assets proyek Anda, lalu tambahkan dua entri meta-data di bawah node application dalam file AndroidManifest.xml. Contoh kode berikut memberikan ilustrasi:
com.aliyun.alivc_license.licensekey adalah entri metadata yang menentukan kunci lisensi.
<application
android:icon="@drawable/icon"
android:label="@string/app_name" >
<meta-data
android:name="com.aliyun.alivc_license.licensekey"
android:value="Your LicenseKey"/> // Masukkan kunci lisensi yang Anda peroleh.
<meta-data
android:name="com.aliyun.alivc_license.licensefile"
android:value="Your LicenseFile Path"/> // Masukkan path file lisensi relatif terhadap folder assets. Contoh: alivc_license/AliVideoCert.crt.
...
</application>Referensi
Item | Referensi |
Proyek contoh | Proyek contoh berisi kode lengkap untuk integrasi SDK, dan folder assets berisi semua sumber daya gambar demo. |
Panduan cepat | Paket panduan cepat meningkatkan efisiensi integrasi Queen SDK. Paket ini memberikan penjelasan rinci tentang integrasi serta panduan untuk membantu Anda mengatasi masalah umum. |
Kode integrasi dengan SDK dari vendor umum |