Bu sayfada, Android uygulamalarınızda MediaPipe Görevleri'ni kullanmak için geliştirme ortamınızı nasıl kuracağınız gösterilmektedir.
Desteklenen cihazlar ve platformlar
MediaPipe Tasks ile Android uygulamaları oluşturmak için geliştirme ortamınız aşağıdakileri gerektirir:
- Önerilen en az 2021.1.1 (Bumblebee) sürümüne veya uyumlu başka bir IDE'ye sahip Android Studio.
- Android SDK 24 veya sonraki sürümü
- En azından minimum SDK sürümüne sahip Android cihaz. Bir Android emülatörü tüm görevlerde çalışmayabilir.
Geliştirici ortamı kurulumu
Bir Android uygulamasında MediaPipe görevi çalıştırmadan önce mevcut bir uygulamanızın olması veya yerel makinenizde yeni bir Android Studio projesi oluşturmanız gerekir. MediaPipe, uygulamanızın uygulama verilerini ve iş mantığını içeren Veri katmanına uygundur. Android uygulama mimarisi hakkında daha fazla bilgi için Uygulama mimarisi rehberine bakın.
Android cihaz kurulumu
Fiziksel bir Android cihazı kullanarak uygulamanızı test etmeden önce Geliştirici seçeneklerini ve USB üzerinden hata ayıklamayı etkinleştirmeniz gerekir. Cihazınızı Geliştirici seçenekleriyle yapılandırma talimatları için Cihaz üzerinde geliştirici seçeneklerini yapılandırma bölümüne bakın.
Cihaz kamerası veya mikrofonu gerektirmeyen görevler için fiziksel bir Android cihaz yerine Android cihaz emülatörü kullanabilirsiniz. Android Emülatörü ayarlama talimatları için Uygulamaları Android Emülatör'de çalıştırma konusuna bakın.
Örnek kod kurulumu
MediaPipe Örnekler deposu, her MediaPipe görevi için örnek Android uygulamaları içerir. Örnek koddan proje oluşturabilir, projeyi derleyip çalıştırabilirsiniz.
Örnek kod projesini içe aktarmak ve derlemek için:
- Android Studio'yu başlatın.
- Android Studio'dan Dosya > Yeni > Projeyi İçe Aktar'ı seçin.
build.gradle
dosyasını içeren örnek kod dizinine gidin ve ilgili dizini seçin. Örneğin:.../mediapipe/examples/text_classification/android/build.gradle
- Android Studio bir Gradle Senkronizasyonu isterse Tamam'ı seçin.
- Android cihazınızın bilgisayarınıza bağlı olduğundan ve geliştirici modunun etkin olduğundan emin olun. Yeşil renkli
Run
okunu tıklayın.
Doğru dizini seçerseniz Android Studio yeni bir proje oluşturur ve onu oluşturur. Bu işlem, bilgisayarınızın hızına ve başka projeler için Android Studio kullanıp kullanmadığınıza bağlı olarak birkaç dakika sürebilir. Derleme tamamlandığında Android Studio, Çıktı Derleme durum panelinde bir BUILD SUCCESSFUL
mesajı görüntüler.
Projeyi yürütmek için:
- Android Studio'da, Çalıştır > Çalıştır... seçeneğini belirleyerek projeyi çalıştırın.
- Uygulamayı test etmek için bağlı bir Android cihazı (veya emülatörü) seçin.
MediaPipe Görevleri bağımlılıkları
MediaPipe Tasks; vizyon, metin ve ses için önceden oluşturulmuş üç kitaplık sağlar. .tflite
model dosyası, modeli kullanan Android modülünün öğe dizininde bulunmalıdır. Uygulama tarafından kullanılan MediaPipe Görevine bağlı olarak vizyon, metin veya ses kitaplığını build.gradle
dosyası içindeki bağımlılık listesine ekleyin.
Üretken yapay zeka görevleri
MediaPipe Tasks Generative AI kitaplıkları, görüntü veya metin oluşturma işlemlerini yapan görevler içerir. Android Studio'da MediaPipe Tasks Generative AI kitaplıklarını içe aktarmak için bağımlılıkları build.gradle
dosyanıza ekleyin.
Resim Oluşturma Aracı
MediaPipe Resim Oluşturucu görevi, tasks-vision-image-generator
kitaplığında yer alır. Bağımlılığı build.gradle
dosyanıza ekleyin:
dependencies {
implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}
LLM Inference API'si
MediaPipe LLM Çıkarımı görevi, tasks-genai
kitaplığında yer alır. Bağımlılığı build.gradle
dosyanıza ekleyin:
dependencies {
implementation 'com.google.mediapipe:tasks-genai:latest.release'
}
Görüş görevleri
MediaPipe Tasks vizyon kitaplığı, görüntü veya video girişlerini işleyen görevleri içerir. MediaPipe Tasks vizyon kitaplığını Android Studio'da içe aktarmak için build.gradle
dosyanıza aşağıdaki bağımlılıkları ekleyin:
dependencies {
implementation 'com.google.mediapipe:tasks-vision:latest.release'
}
Metin görevleri
MediaPipe Tasks metin kitaplığı, dil verilerini metin biçiminde işleyen görevleri içerir. MediaPipe Tasks metin kitaplığını Android Studio'da içe aktarmak için build.gradle
dosyanıza aşağıdaki bağımlılıkları ekleyin:
dependencies {
implementation 'com.google.mediapipe:tasks-text:latest.release'
}
Sesli görevler
MediaPipe Tasks ses kitaplığı, ses girişlerini işleyen görevleri içerir. MediaPipe Tasks ses kitaplığını Android Studio'da içe aktarmak için aşağıdaki bağımlılıkları build.gradle
dosyanıza ekleyin:
dependencies {
implementation 'com.google.mediapipe:tasks-audio:latest.release'
}
BaseOptions yapılandırması
BaseOptions
, MediaPipe Görev API'lerinin genel yapılandırılmasına olanak tanır.
Seçenek adı | Açıklama | Kabul edilen değerler |
---|---|---|
modelAssetBuffer |
Doğrudan ByteBuffer veya MappedByteBuffer olarak model öğe dosyası içeriği. |
Dize olarak ByteBuffer veya MappedByteBuffer |
modelAssetPath |
Android uygulama öğeleri klasöründeki bir model öğesi dosyasının model yolu. | Dize olarak dosya yolu |
modelAssetFileDescriptor |
Bir model öğesi dosyasının yerel dosya açıklayıcı tam sayısı. | Dosya açıklayıcıyı belirten tam sayı |
Delegate |
MediaPipe ardışık düzenini çalıştırmak için cihaz yetkisi verilen bir cihaz üzerinden donanım hızlandırmayı etkinleştirir. Varsayılan değer: CPU . |
[CPU ,GPU ] |
Donanım hızlandırma
MediaPipe Tasks, makine öğrenimi modellerini çalıştırmak için grafik işleme birimlerinin (GPU) kullanımını destekler. Android cihazlarda, yetki verilmiş bir kullanıcı kullanarak modellerinizin GPU ile hızlandırılmış yürütmesinin kullanımını etkinleştirebilirsiniz. Temsilciler, MediaPipe için donanım sürücüleri görevi görür ve modellerinizi standart CPU işlemcileri yerine GPU işlemcilerde çalıştırmanıza olanak tanır.
BaseOptions
aracılığıyla görev seçeneklerinde GPU yetkilisini yapılandırın:
BaseOptions baseOptions = BaseOptions.builder().useGpu().build();
Sorun giderme
MediaPipe ile ilgili teknik sorularla ilgili yardım almak için tartışma grubunu veya Stack Overflow'u ziyaret ederek topluluktan destek alın. Hataları bildirmek veya özellik isteği göndermek için GitHub'da sorun bildirin.
Android geliştirme ortamınızı kurma konusunda yardım almak için Android geliştirici belgelerini inceleyin.