Media Enhancement API, yüksek kaliteli ve düşük gecikmeli resim iyileştirmeleri gerçekleştirmek için cihaz üzerinde GPU hızlandırmayı kullanan güçlü bir araçtır. Otomatik ton eşleme, bulanıklık giderme, gürültü giderme ve ölçek büyütme gibi özellikler buna dahildir.
API'yi başlatmadan önce proje bağımlılıklarınızı yapılandırmanız ve manifest dosyanızda donanım hızlandırma gereksinimlerini belirtmeniz gerekir. Bu yapılandırmaların atlanması, GLOBAL_INIT_FAILED çalışma zamanı hatalarının başlıca nedenidir.
Gradle bağımlılıkları
app/build.gradle.kts dosyanıza aşağıdaki bağımlılıkları ekleyin. Eşzamansız, engellenmeyen yürütmeyi kolaylaştırmak için Kotlin eş yordamlarını ve donanım yüzeyi işleme için Jetpack Media3'ü ekleyin.
dependencies {
// Google Play services Media Enhancement Library (Beta)
implementation("com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta09")
}
Google'ın Maven deposunda play-services-media-effect-enhancement ile ilgili paket ayrıntılarını inceleyin.
Geliştirme oturumlarını eşzamansız olarak yönetmek için Kotlin eş yordamlarını kullanmanızı da öneririz.
// Kotlin coroutines for asynchronous API handling
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-play-services:1.7.3")
Android manifest dosyasıyla ilgili şartlar
AndroidManifest.xml dosyanızın <application> etiketinin içine aşağıdaki öğeleri ekleyin:
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application>
<!-- 1. Google Play services version for runtime compatibility checks -->
<meta-data
android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />
<!-- 2. Declare OpenCL compute libraries for NPU/GPU neural acceleration -->
<uses-native-library android:name="libOpenCL.so" android:required="false" />
<uses-native-library android:name="libOpenCL-car.so" android:required="false" />
<uses-native-library android:name="libOpenCL-pixel.so" android:required="false" />
<!-- 3. Declare OpenGL ES for high-performance graphics rendering -->
<uses-native-library android:name="libGLESv2.so" android:required="false" />
<uses-native-library android:name="libGLESv3.so" android:required="false" />
</application>
</manifest>
OpenCL, medya iyileştirme görevleri için NPU ve GPU nöral hızlandırmayı etkinleştirmek üzere gereken yerel işlem kitaplıklarını sağlar. Bu kitaplıkları manifest dosyanızda beyan etmek, API'nin donanım hızlandırmadan yararlanması için ön koşuldur. Bu, yüksek kaliteli ve düşük gecikmeli iyileştirmeler yapmak için gereklidir. OpenCL hakkında daha fazla bilgi için OpenCL uygulamaları başlıklı makaleyi inceleyin.
OpenGL ES, medya iyileştirme çıktılarının yüksek performanslı oluşturulması için gereken yerel grafik kitaplıklarını sağlar. Oluşturma ardışık düzeninin, işlenen medyayı donanım hızlandırmalı yüzeylerde etkili bir şekilde gösterebilmesi için bu kitaplıkları manifest dosyanızda beyan etmeniz gerekir. OpenGL hakkında bilgi için OpenGL API belgelerine genel bakış başlıklı makaleyi inceleyin.
Darboğazları önlemek için Android oluşturma ardışık düzeni donanım hızlandırmalı olmalıdır. API 14 ve sonraki sürümleri hedefleyen uygulamalar için varsayılan olarak etkinleştirilmiş olsa da <activity> etiketlerinizde android:hardwareAccelerated="true" değerini açıkça ayarlayın.
Cihaz uyumluluğu ve modül kurulumu
Google Play Hizmetleri, ilk APK depolama alanınızdan tasarruf etmek için makine öğrenimi modellerini dinamik olarak sunar. Uygulama, iyileştirmeleri gerçekleştirmeden önce donanım desteğini doğrulamak ve gerekli model ağırlıklarının indirilip yerel olarak önbelleğe alınmasını sağlamak için EnhancementClient kullanmalıdır. Bu, cihaz başına tek seferlik bir işlemdir.
suspendCancellableCoroutine kullanarak, görev tabanlı istemci geri çağırmalarını standart Kotlin askıya alma işlevlerine sarmalayarak daha temiz ve sıralı bir yürütme sağlayabilirsiniz:
// Verifies if host hardware supports NPU/GPU acceleration. suspend fun EnhancementClient.isDeviceSupportedAsync(): Boolean = suspendCancellableCoroutine { continuation -> this.isDeviceSupported() .addOnSuccessListener { result -> continuation.resume(result) } .addOnFailureListener { exception -> continuation.resumeWithException(exception) } } // Verifies the presence of required neural network models. suspend fun EnhancementClient.isModuleInstalledAsync(): Boolean = suspendCancellableCoroutine { continuation -> this.isModuleInstalled() .addOnSuccessListener { result -> continuation.resume(result) } .addOnFailureListener { exception -> continuation.resumeWithException(exception) } }