iOS için kurulum kılavuzu

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

Desteklenen cihazlar ve platformlar

MediaPipe Tasks ile iOS uygulamaları oluşturmak için geliştirme ortamınız şunları gerektirir:

• macOS Mojave 10.14.3 veya daha yeni bir sürüm.

• Xcode 10.3 veya üzeri.

• En az iOS 12.0 yüklü iOS cihaz. Alternatif olarak, bir iOS simülatörü Bu, cihaz kamerasının gerekli olmadığı uygulamalarda geçerli olur.

Geliştirici ortamı kurulumu

Bir iOS uygulamasında MediaPipe görevi çalıştırmadan önce mevcut Xcode projesini kullanın veya yerel makinenizde yeni bir tane oluşturun.

MediaPipe Görevleri yalnızca CocoaPods ile yüklenebilir. Başlamadan önce CocoaPods 1.12.1 veya sonraki bir sürümü yüklemeniz gerekir. Örneğin, CocoaPods'u macOS'e yükleme talimatları için CocoaPods'un kurulumuna rehberini inceleyin.

Örnek kod kurulumu

MediaPipe Örnekler deposu, MediaPipe görevleri için örnek iOS uygulamaları içerir.

Örnek koddan proje oluşturabilir, projeyi derleyebilir ve görevi görebilir. Aşağıdaki adımlar Text Sınıflandırıcı görevi görebilir.

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

1. Terminali açın, MediaPipe Örnek deposunu klonlayın ve TextClassifier.xcodeproj ve Podfile içeren dizin.

   git clone https://github.com/google-ai-edge/mediapipe-samples
   cd mediapipe/examples/text_classification/ios
   

2. CocoaPods'u kullanarak MediaPipe Görevleri'ni yükleme:

   pod install
   

   Bu komut, örnekte bir TextClassifier.xcworkspace dosyası oluşturur proje dizinini oluşturur.

3. TextClassifier.xcworkspace dosyasını çift tıklayarak projeyi şurada açın: Xcode'a gidin. TextClassifier.xcodeproj dosyası zaten açıksa kapatın TextClassifier.xcworkspace dosyasını açmadan önce.

4. TextClassifier şemasını ve ardından fiziksel bir iOS cihazı seçin. simülatörünü kullanabilirsiniz. Fiziksel bir iOS kullanırken kullanıyorsanız, cihazın Mac'inize bağlı olduğundan emin olun.

5. Projenizin araç çubuğunda Run düğmesini tıklayın.

Xcode'da uygulama çalıştırma hakkında daha fazla talimat için bkz. Derleme ve çalıştırma uygulamasında gösterilir.

MediaPipe Görevleri bağımlılıkları

MediaPipe Tasks, vizyon ve metin için önceden oluşturulmuş iki kitaplık sağlar. İlgili içeriği oluşturmak için kullanılan .tflite model dosyası, şu iOS uygulaması paketinde bulunmalıdır: modeli kullanır. MediaPipe Tas'a bağlı olarak, görüntü veya metin ekleyin kitaplığını CocoaPods'daki kapsül listesine eklemek için Podfile kullanın. İlgili talimatlar için Uygulamanız için gerekli kapsüllerle bir Podfile oluşturmak için CocoaPods'da bulabilirsiniz.

Üretken yapay zeka görevleri

MediaPipe Tasks Üretken Yapay Zeka Kitaplıkları, resim veya metin oluşturma. MediaPipe Tasks Generative AI kitaplığını yüklemek için MediaPipeTasksGenAI ve MediaPipeTasksGenAIC kapsülün içinde uygulamanızın hedefine kalan kısmı Podfile.

LLM Çıkarım API'si

MediaPipe LLM Çıkarım görevi, MediaPipeTasksGenAI içinde yer alır ve MediaPipeTasksGenAIC kapsül.

target 'MyLlmInferenceApp' do
  use_frameworks!
  pod 'MediaPipeTasksGenAI'
  pod 'MediaPipeTasksGenAIC'
end

Vizyon görevleri

MediaPipe Tasks vizyon kitaplığı, resim veya video işleyen görevleri içerir giriş değerleridir. MediaPipe Tasks vizyon kitaplığını yüklemek için MediaPipeTasksVision kapsülünü Podfile içinde uygulamanızın hedefine ekleyin.

target 'MyAppWithMediaPipeTasksVision' do
  use_frameworks!
  pod 'MediaPipeTasksVision'
end

Metin görevleri

MediaPipe Tasks metin kitaplığı, metin biçiminde girin. MediaPipe Tasks metin kitaplığını yüklemek için Podfile içinde uygulamanızın hedefine MediaPipeTasksText kapsülü

target 'MyAppWithMediaPipeTasksText' do
  use_frameworks!
  pod 'MediaPipeTasksText'
end

Test hedeflerini yapılandırın

Uygulamanızın bir test hedefi varsa Podfile'ınızın aşağıdaki uygulamalardan faydalanabilirsiniz. MediaPipe görev kitaplığı.

En basit uygulama, test hedefinin iç içe yerleştirilmediğinden emin olmaktır. Bunlar, MediaPipe görev kapsülünü ekleyen ana uygulama hedefidir.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

Test hedefinin ana uygulama hedefi içine yerleştirilmesi gerekiyorsa Podfile aşağıdaki uygulamaya uygun olmalıdır:

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

BaseOptions yapılandırması

BaseOptions, MediaPipe Görev API'lerinin genel yapılandırmasına olanak tanır.

Donanım hızlandırma

iOS'te MediaPipe Tasks yalnızca standart CPU işlemcilerinde çalışan modelleri destekler.

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.

iOS geliştirme ortamınızı kurma konusunda yardım almak için Apple Geliştirici Dokümanlar.