تعرض لك هذه الصفحة كيفية إعداد بيئة التطوير لاستخدام مهام MediaPipe في تطبيقات iOS.
الأجهزة والمنصّات المتوافقة
لإنشاء تطبيقات iOS باستخدام "مهام MediaPipe"، تتطلب بيئة التطوير ما يلي:
macOS Mojave 10.14.3 أو الإصدارات الأحدث.
Xcode 10.3 أو إصدار أحدث.
جهاز iOS مزوّد بالإصدار 12.0 من iOS على الأقل. بدلاً من ذلك، يمكن لمحاكي iOS التعامل مع التطبيقات التي لا تتطلب كاميرا الجهاز.
إعداد بيئة المطوّر
قبل تشغيل مَهمّة MediaPipe على أحد تطبيقات iOS، يجب أن يكون لديك مشروع Xcode حالي أو إنشاء مشروع جديد على جهازك المحلي.
لا يمكن تثبيت مهام MediaPipe إلا باستخدام CocoaPods. يجب تثبيت CocoaPods 1.12.1 أو إصدار أحدث قبل البدء. للحصول على تعليمات حول تثبيت CocoaPods على نظام التشغيل macOS، يُرجى الرجوع إلى دليل تثبيت CocoaPods.
مثال على إعداد الرمز
يحتوي مستودع أمثلة MediaPipe على أمثلة لتطبيقات iOS لمهام MediaPipe.
يمكنك إنشاء مشروع من نموذج التعليمات البرمجية وبناء المشروع وتشغيل المهمة. وتُنشئ الخطوات التالية مهمة Text Classifier.
لاستيراد نموذج مشروع الرمز البرمجي وإنشاءه:
افتح المحطة الطرفية، واستنسِخ مستودع MediaPipe، وانتقِل إلى الدليل الذي يحتوي على
TextClassifier.xcodeproj
وPodfile
.git clone https://github.com/google-ai-edge/mediapipe-samples cd mediapipe/examples/text_classification/ios
تثبيت "مهام MediaPipe" باستخدام CocoaPods:
pod install
يؤدي هذا الأمر إلى إنشاء ملف
TextClassifier.xcworkspace
في مثال دليل المشروع.انقر نقرًا مزدوجًا على ملف
TextClassifier.xcworkspace
لفتح المشروع في Xcode. إذا كان ملفTextClassifier.xcodeproj
مفتوحًا، أغلقه قبل فتح ملفTextClassifier.xcworkspace
.اختَر المخطط
TextClassifier
واختَر جهاز iOS أو محاكيًا من شريط الأدوات في نافذة المشروع. عند استخدام جهاز iOS فعلي، تأكد من توصيله بجهاز Mac.انقر على الزر
Run
في شريط أدوات مشروعك.
لمزيد من التعليمات حول تشغيل تطبيق على Xcode، راجع إنشاء تطبيق وتشغيله.
تبعيات مهام MediaPipe
توفر مهام MediaPipe مكتبتين مصممتين مسبقًا للرؤية والنص. يجب وضع ملف الطراز .tflite
في حزمة تطبيق iOS الذي يستخدم النموذج. بناءً على MediaPipe Tas، يمكنك إضافة مكتبة الرؤية أو
النص إلى قائمة مجموعات المجموعات في Podfile
CocoaPods. للحصول على تعليمات حول كيفية إنشاء Podfile
باستخدام مجموعات الإعلانات المتسلسلة المطلوبة لتطبيقك، يمكنك الاطّلاع على المقالة استخدام CocoaPods.
مهام الذكاء الاصطناعي التوليدي
تحتوي مكتبات MediaPipe للذكاء الاصطناعي التوليدي على مهام تعالج إنشاء الصور أو النصوص. لتثبيت مكتبة MediaPipe للذكاء الاصطناعي التوليدي، أضِف
مجموعة MediaPipeTasksGenAI
وMediaPipeTasksGenAIC
إلى هدف تطبيقك في
Podfile
.
واجهة برمجة التطبيقات للاستنتاج اللغوي الكبير
تتضمّن مهمة الاستدلال اللغوي الكبير MediaPipe في مجموعات MediaPipeTasksGenAI
وMediaPipeTasksGenAIC
.
target 'MyLlmInferenceApp' do
use_frameworks!
pod 'MediaPipeTasksGenAI'
pod 'MediaPipeTasksGenAIC'
end
مهام بصرية
تحتوي مكتبة رؤية "مهام MediaPipe" على مهام تعالج إدخالات الصور أو الفيديو. لتثبيت مكتبة رؤية MediaPipe ضمن "مهام Google"، أضِف
مجموعة MediaPipeTasksVision
المتسلسلة إلى هدف تطبيقك في Podfile
.
target 'MyAppWithMediaPipeTasksVision' do
use_frameworks!
pod 'MediaPipeTasksVision'
end
المهام النصية
تحتوي مكتبة نص "مهام MediaPipe" على مهام تعالج بيانات اللغة بتنسيق نصي. لتثبيت مكتبة نصوص "مهام MediaPipe"، أضِف
مجموعة MediaPipeTasksText
المتسلسلة إلى هدف التطبيق في Podfile
.
target 'MyAppWithMediaPipeTasksText' do
use_frameworks!
pod 'MediaPipeTasksText'
end
ضبط أهداف الاختبار
إذا كان لتطبيقك هدف اختبار، تأكَّد من التزام ملف Podfile بأي من عمليات التنفيذ التالية لتجنب أي سلوك غير مرغوب فيه عند استخدام مكتبة مهام MediaPipe.
وأبسط عملية تنفيذ هي التأكّد من عدم دمج هدف الاختبار ضمن استهداف التطبيق الرئيسي الذي يضيف مجموعة مهام MediaPipe.
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
end
target 'MyAppWithMediaPipeTasksTests' do
end
إذا كان يجب دمج هدف الاختبار ضمن هدف التطبيق الرئيسي، يجب أن يتوافق ملف Podfile مع عملية التنفيذ التالية:
target 'MyAppWithMediaPipeTasks' do
pod 'MediaPipeTasksVision'
target 'MyAppWithMediaPipeTasksTests' do
inherit! :none
end
end
إعدادات BaseOptions
تتيح قاعدة BaseOptions إعداد واجهة برمجة تطبيقات مهام MediaPipe بشكل عام.
اسم الخيار | الوصف | القيم المقبولة |
---|---|---|
modelAssetPath |
مسار النموذج إلى ملف نموذج في حِزمة تطبيق iOS. | المسار كسلسلة. |
تسريع الأجهزة
على نظام التشغيل iOS، لا تتوافق "مهام MediaPipe" مع تشغيل النماذج إلا على معالِجات وحدة المعالجة المركزية العادية.
تحديد المشاكل وحلّها
للحصول على مساعدة بشأن الأسئلة التقنية المتعلقة بـ MediaPipe، يُرجى الانتقال إلى مجموعة المناقشة أو تجاوز تكديس للحصول على الدعم من المنتدى. للإبلاغ عن أخطاء أو تقديم طلبات ميزات، يمكنك الإبلاغ عن مشكلة على GitHub.
للحصول على مساعدة في إعداد بيئة تطوير iOS، انتقِل إلى مستندات مطوّري برامج Apple.