Halaman ini menunjukkan cara menyiapkan lingkungan pengembangan untuk menggunakan Tugas MediaPipe di aplikasi iOS Anda.
Perangkat dan platform yang didukung
Untuk membuat aplikasi iOS dengan MediaPipe Tasks, lingkungan pengembangan Anda memerlukan hal-hal berikut:
macOS Mojave 10.14.3 atau yang lebih baru.
Xcode 10.3 atau yang lebih baru.
Perangkat iOS yang memiliki minimal iOS 12.0. Atau, simulator iOS dapat menangani aplikasi yang tidak memerlukan kamera perangkat.
Penyiapan lingkungan developer
Sebelum menjalankan tugas MediaPipe di aplikasi iOS, Anda harus sudah memiliki project Xcode atau membuat yang baru di komputer lokal.
MediaPipe Tasks hanya dapat diinstal menggunakan CocoaPods. Anda harus menginstal CocoaPods 1.12.1 atau yang lebih baru sebelum memulai. Untuk mengetahui petunjuk cara menginstal CocoaPods di macOS, lihat panduan penginstalan CocoaPods.
Contoh penyiapan kode
Repositori MediaPipe Examples berisi contoh aplikasi iOS untuk tugas MediaPipe.
Anda dapat membuat project dari kode contoh, membuat project, dan menjalankan tugas. Langkah-langkah berikut akan membangun tugas Text Classifier.
Untuk mengimpor dan membangun project kode contoh:
Buka terminal, clone repositori Contoh MediaPipe, lalu buka direktori yang berisi
TextClassifier.xcodeproj
danPodfile
.git clone https://github.com/google-ai-edge/mediapipe-samples cd mediapipe/examples/text_classification/ios
Instal MediaPipe Tasks menggunakan CocoaPods:
pod install
Perintah ini akan membuat file
TextClassifier.xcworkspace
dalam direktori contoh project.Klik dua kali file
TextClassifier.xcworkspace
untuk membuka project di Xcode. Jika fileTextClassifier.xcodeproj
sudah terbuka, tutup sebelum membuka fileTextClassifier.xcworkspace
.Pilih skema
TextClassifier
dan pilih simulator atau perangkat iOS fisik dari toolbar jendela project Anda. Saat menggunakan perangkat iOS fisik, pastikan perangkat tersebut terhubung ke Mac Anda.Klik tombol
Run
di toolbar project Anda.
Untuk petunjuk selengkapnya tentang menjalankan aplikasi di Xcode, lihat Mem-build dan menjalankan aplikasi.
Dependensi Tugas MediaPipe
MediaPipe Tasks menyediakan dua library bawaan untuk visi dan teks. File model .tflite
harus berada dalam paket aplikasi iOS yang menggunakan model tersebut. Bergantung pada MediaPipe Tas, tambahkan library visi atau teks
ke daftar pod dalam Podfile
CocoaPods. Untuk petunjuk cara
membuat Podfile
dengan pod yang diperlukan untuk aplikasi Anda, lihat Menggunakan
CocoaPods.
Tugas AI generatif
Library AI Generatif MediaPipe Tasks berisi tugas yang menangani pembuatan gambar atau
teks. Untuk menginstal library AI Generatif MediaPipe Tasks, tambahkan pod MediaPipeTasksGenAI
dan MediaPipeTasksGenAIC
ke target aplikasi Anda di Podfile
.
API Inferensi LLM
Tugas Inferensi LLM MediaPipe dimuat dalam pod MediaPipeTasksGenAI
dan MediaPipeTasksGenAIC
.
target 'MyLlmInferenceApp' do
use_frameworks!
pod 'MediaPipeTasksGenAI'
pod 'MediaPipeTasksGenAIC'
end
Tugas visi
Library Vision MediaPipe Tasks berisi tugas yang menangani input gambar atau
video. Untuk menginstal library Vision MediaPipe Tasks, tambahkan pod MediaPipeTasksVision
ke target aplikasi Anda di Podfile
.
target 'MyAppWithMediaPipeTasksVision' do
use_frameworks!
pod 'MediaPipeTasksVision'
end
Tugas teks
Library teks MediaPipe Tasks berisi tugas yang menangani data bahasa dalam
format teks. Untuk menginstal library teks MediaPipe Tasks, tambahkan pod MediaPipeTasksText
ke target aplikasi Anda di Podfile
target 'MyAppWithMediaPipeTasksText' do
use_frameworks!
pod 'MediaPipeTasksText'
end
Mengonfigurasi target pengujian
Jika aplikasi Anda memiliki target pengujian, pastikan Podfile Anda mematuhi salah satu penerapan berikut untuk menghindari perilaku yang tidak diinginkan saat menggunakan library tugas MediaPipe.
Implementasi paling sederhana adalah memastikan bahwa target pengujian tidak disusun bertingkat dalam target aplikasi utama yang menambahkan pod tugas MediaPipe.
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
end
target 'MyAppWithMediaPipeTasksTests' do
end
Jika target pengujian harus disarangkan dalam target aplikasi utama, Podfile harus sesuai dengan implementasi berikut:
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
target 'MyAppWithMediaPipeTasksTests' do
inherit! :none
end
end
Konfigurasi BaseOptions
BaseOptions memungkinkan konfigurasi umum MediaPipe Task API.
Nama opsi | Deskripsi | Nilai yang diterima |
---|---|---|
modelAssetPath |
Jalur model ke file model dalam paket aplikasi iOS. | Jalur sebagai string. |
Akselerasi hardware
Di iOS, MediaPipe Tasks hanya mendukung model yang berjalan pada prosesor CPU standar.
Pemecahan masalah
Untuk mendapatkan bantuan terkait pertanyaan teknis terkait MediaPipe, kunjungi grup diskusi atau Stack Overflow untuk mendapatkan dukungan dari komunitas. Untuk melaporkan bug atau mengajukan permintaan fitur, ajukan masalah di GitHub.
Untuk mendapatkan bantuan dalam menyiapkan lingkungan pengembangan iOS, buka Dokumentasi Developer Apple.