Bu sayfada, MediaPipe Görevleri'ni iOS uygulamalarınızda kullanmak için geliştirme ortamınızı nasıl kuracağınız gösterilmektedir.
Desteklenen cihazlar ve platformlar
MediaPipe Tasks ile iOS uygulamaları oluşturmak için geliştirme ortamınızda şunlar gerekir:
macOS Mojave 10.14.3 veya sonraki sürümler.
Xcode 10.3 veya sonraki sürümler.
En az iOS 12.0 yüklü iOS cihaz. Alternatif olarak, bir iOS simülatörü cihaz kamerasını gerektirmeyen uygulamaları da kullanabilir.
Geliştirici ortamı kurulumu
iOS uygulamasında bir MediaPipe görevi çalıştırmadan önce mevcut bir Xcode projeniz olması veya yerel makinenizde yeni bir proje oluşturmanız gerekir.
MediaPipe Görevleri yalnızca CocoaPods ile yüklenebilir. Başlamadan önce CocoaPods'un 1.12.1 veya sonraki bir sürümünü yüklemeniz gerekir. macOS'e CocoaPods yükleme talimatları için CocoaPods yükleme kılavuzuna bakın.
Örnek kod kurulumu
MediaPipe Örnekleri deposu, MediaPipe görevleri için örnek iOS uygulamaları içerir.
Örnek koddan proje oluşturabilir, projeyi derleyebilir ve görevi çalıştırabilirsiniz. Aşağıdaki adımlar Metin Sınıflandırıcı görevi oluşturur.
Örnek kod projesini içe aktarmak ve derlemek için:
Terminali açın, MediaPipe Örnekleri deposunu klonlayın ve
TextClassifier.xcodeproj
ilePodfile
öğelerini içeren dizine gidin.git clone https://github.com/google-ai-edge/mediapipe-samples cd mediapipe/examples/text_classification/ios
CocoaPods'u kullanarak MediaPipe Görevler'i yükleme:
pod install
Bu komut, örnek proje dizininde bir
TextClassifier.xcworkspace
dosyası oluşturur.Projeyi Xcode'da açmak için
TextClassifier.xcworkspace
dosyasını çift tıklayın.TextClassifier.xcodeproj
dosyası zaten açıksaTextClassifier.xcworkspace
dosyasını açmadan önce dosyayı kapatın.TextClassifier
şemasını seçin ve proje pencerenizin araç çubuğundan fiziksel bir iOS cihaz veya simülatör seçin. Fiziksel bir iOS cihaz kullanırken cihazın Mac'inize bağlı olduğundan emin olun.Projenizin araç çubuğundaki
Run
düğmesini tıklayın.
Xcode'da uygulama çalıştırmayla ilgili diğer talimatlar için Uygulama oluşturma ve çalıştırma bölümüne bakın.
MediaPipe Görevleri bağımlılıkları
MediaPipe Tasks, vizyon ve metin için önceden oluşturulmuş iki kitaplık sağlar. .tflite
model dosyası, modeli kullanan iOS uygulaması paketinde bulunmalıdır. MediaPipe Tas'a bağlı olarak, Vision veya metin kitaplığını CocoaPods Podfile
içindeki kapsül listesine ekleyin. Uygulamanız için gerekli kapsüllerle Podfile
oluşturma talimatları için CocoaPods'u kullanma bölümüne bakın.
Ü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. MediaPipe Tasks Üretici Yapay Zeka kitaplığını yüklemek için MediaPipeTasksGenAI
ve MediaPipeTasksGenAIC
kapsüllerini Podfile
içinde uygulamanızın hedefine ekleyin.
LLM Inference API'si
MediaPipe LLM Çıkarımı görevi, MediaPipeTasksGenAI
ve MediaPipeTasksGenAIC
kapsüllerinde yer alır.
target 'MyLlmInferenceApp' do
use_frameworks!
pod 'MediaPipeTasksGenAI'
pod 'MediaPipeTasksGenAIC'
end
Görüş görevleri
MediaPipe Tasks vizyon kitaplığı, görüntü veya video girişlerini işleyen görevleri içerir. MediaPipe Görevleri 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ığı, dil verilerini metin biçiminde işleyen görevleri içerir. MediaPipe Görevleri metin kitaplığını yüklemek için MediaPipeTasksText
kapsülünü Podfile
içinde uygulamanızın hedefine ekleyin
target 'MyAppWithMediaPipeTasksText' do
use_frameworks!
pod 'MediaPipeTasksText'
end
Test hedeflerini yapılandırın
Uygulamanızın test hedefi varsa MediaPipe görev kitaplığını kullanırken istenmeyen davranışlardan kaçınmak için Podfile'ınızın aşağıdaki uygulamalardan birine uyduğundan emin olun.
En basit uygulama, test hedefinin MediaPipe görev kapsülünü ekleyen ana uygulama hedefinin içine iç içe yerleştirilmemesidir.
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'larının genel yapılandırılmasına olanak tanır.
Seçenek adı | Açıklama | Kabul edilen değerler |
---|---|---|
modelAssetPath |
iOS uygulama paketindeki bir model dosyasının model yolu. | Dize olarak yol. |
Donanım hızlandırma
MediaPipe Tasks, iOS'te yalnızca standart CPU işlemcilerde çalışan modelleri destekler.
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.
iOS geliştirme ortamınızı ayarlama konusunda yardım almak için Apple Geliştirici Belgeleri'ni ziyaret edin.