Android için kurulum kılavuzu

Bu sayfada MediaPipe'i kullanmak için geliştirme ortamınızı nasıl ayarlayacağınız gösterilmektedir Android uygulamalarınızdaki görevler.

Desteklenen cihazlar ve platformlar

MediaPipe Tasks ile Android uygulamaları oluşturmak için şunları gerektirir:

• Android Studio'da en az 2021.1.1 (Bumblebee) sürümünü veya uyumlu başka bir sürümü IDE.
• Android SDK 24 veya sonraki sürümler
• En azından minimum SDK sürümüne sahip Android cihaz. Android emülatörü tüm görevlerde kullanılamayabilir.

Geliştirici ortamı kurulumu

Bir Android uygulamasında MediaPipe görevi çalıştırmadan önce mevcut bir uygulamayı kullanabilir veya yerel makinenizde yeni bir Android Studio projesi oluşturabilirsiniz. MediaPipe, Google Analytics 4'teki Veri katmanınızı doldurun mantığını da içerir. Daha fazla bilgi için Android uygulama mimarisi, bkz. Uygulama rehberi mimari.

Android cihaz kurulumu

Geliştirici seçeneklerini ve USB üzerinden hata ayıklamayı fiziksel bir Android cihazda etkinleştirmeniz gerekir kontrol edin. öğrenmek istiyorsanız, Cihaz üzerindeki geliştiriciyi yapılandırma seçenekleri bulabilirsiniz.

Cihaz kamerası veya mikrofonu gerektirmeyen görevler için Fiziksel bir Android cihaz yerine Android cihaz emülatörü. Talimatlar için kurulum hakkında daha fazla bilgi için Android Emülatör'de uygulama çalıştırma Emülatör.

Örnek kod kurulumu

MediaPipe Örnekler deposu her MediaPipe görevi için örnek Android uygulamaları içerir. Web sitemiz g.co/newsinitiative/labs üzerinden projeyi derleyin ve çalıştırın.

Örnek kod projesini içe aktarmak ve derlemek için:

1. Android Studio'yu başlatın.
2. Android Studio'da Dosya > Yeni > Projeyi İçe Aktarın.
3. build.gradle dosyasını içeren örnek kod dizinine gidin ve bu dizini seçin. Örneğin: .../mediapipe/examples/text_classification/android/build.gradle
4. Android Studio, Gradle Senkronizasyonu isterse Tamam'ı seçin.
5. Android cihazınızın bilgisayarınıza ve geliştiricinize bağlı olduğundan emin olun etkinleştirildiğinden emin olun. Yeşil Run oku tıklayın.

Doğru dizini seçerseniz Android Studio yeni bir proje oluşturur ve inşa eder. Bu işlem, hızınıza bağlı olarak birkaç dakika sürebilir ve diğer projeler için Android Studio kullandıysanız. Derleme işlemi tamamlandığında Android Studio, BUILD SUCCESSFUL Çıkış Derleme durum paneli.

Projeyi çalıştırmak için:

1. Android Studio'da Çalıştır > Çalıştır....
2. 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; görüntü, metin ve ses için önceden oluşturulmuş üç kitaplık sağlar. İlgili içeriği oluşturmak için kullanılan .tflite model dosyası, Android'in öğe dizininde bulunmalıdır. modülünü kullanabilirsiniz. Uygulama tarafından kullanılan MediaPipe Görevine bağlı olarak bağımlılık listesine görüntü, metin veya ses kitaplığını da build.gradle dosyası yükleyin.

Üretken yapay zeka görevleri

MediaPipe Tasks Üretken Yapay Zeka Kitaplıkları, resim veya metin oluşturma. MediaPipe Tasks üretken yapay zeka kitaplıklarını Android Studio için bağımlılıkları build.gradle dosyanıza ekleyin.

Resim Oluşturucu

MediaPipe Image Generator görevi tasks-vision-image-generator kitaplığı. Bağımlılığı build.gradle dosyası:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}

LLM Çıkarım API'si

MediaPipe LLM Çıkarım görevi, tasks-genai içinde yer alır kitaplığını açar. Bağımlılığı build.gradle dosyanıza ekleyin:

dependencies {
    implementation 'com.google.mediapipe:tasks-genai:latest.release'
}

Vizyon görevleri

MediaPipe Tasks vizyon kitaplığı, resim veya video işleyen görevleri içerir giriş değerleridir. MediaPipe Tasks vizyon kitaplığını Android Studio'ya aktarmak için build.gradle dosyanıza aşağıdaki bağımlılıkları uygulayın:

dependencies {
    implementation 'com.google.mediapipe:tasks-vision:latest.release'
}

Metin görevleri

MediaPipe Tasks metin kitaplığı, metin biçiminde girin. MediaPipe Tasks metin kitaplığını Android Studio'ya aktarmak için build.gradle dosyanıza şu bağımlılıklar dahildir:

dependencies {
    implementation 'com.google.mediapipe:tasks-text:latest.release'
}

Sesle ilgili görevler

MediaPipe Tasks ses kitaplığı, ses girişlerini işleyen görevler içerir. Alıcı: MediaPipe Tasks ses kitaplığını Android Studio'ya aktarın, şunu ekleyin: build.gradle dosyanıza bağımlılıkları:

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.

Donanım hızlandırma

MediaPipe Tasks, çalışmak için grafik işlem birimlerinin (GPU'lar) modeller. Android cihazlarda, Yetki verilmiş kullanıcı kullanarak modellerinizin GPU ile hızlandırılmış yürütülmesi. Yetki verilmiş kullanıcılar şu işlemleri yapabilir: Modellerinizi GPU'da çalıştırmanızı sağlayan, MediaPipe için donanım sürücüleri daha yaygın olarak kullanılıyor.

BaseOptions aracılığıyla görev seçeneklerinde GPU yetkilendirmesini yapılandırın:

BaseOptions baseOptions = BaseOptions.builder().useGpu().build();

Sorun giderme

MediaPipe ile ilgili teknik sorular konusunda yardım almak için tartışma sayfasını ziyaret edin grup veya Yığın Destek için taşma: bir topluluk. Hataları bildirmek veya özellik isteğinde bulunmak için şurada sorun bildirin: GitHub'ı tıklayın.

Android geliştirme ortamınızı kurma konusunda yardım almak için Android geliştirici belgelerini inceleyin.