Android için kurulum kılavuzu

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.