توضح لك هذه الصفحة كيفية إعداد بيئة التطوير لاستخدام MediaPipe "مهام Google" في تطبيقات iOS.
الأجهزة والأنظمة الأساسية المتوافقة
لإنشاء تطبيقات iOS باستخدام MediaPipe Tasks، فإن بيئة التطوير لديك ما يلي:
الإصدار 10.14.3 من نظام التشغيل macOS Mojave أو الإصدارات الأحدث
Xcode 10.3 أو إصدار أحدث.
جهاز iOS يعمل بالإصدار 12.0 من نظام التشغيل iOS على الأقل بدلاً من ذلك، يمكن لمحاكي iOS تتعامل مع التطبيقات التي لا تتطلب كاميرا الجهاز.
إعداد بيئة المطوِّر
قبل تشغيل مهمة MediaPipe على أحد تطبيقات iOS، يجب أن يتوفر لديك إما مشروع Xcode حالي أو إنشاء مشروع جديد على جهازك المحلي.
لا يمكن تثبيت "مهام MediaPipe" إلا باستخدام CocoaPods. يجب تثبيت الإصدار 1.12.1 من CocoaPods أو إصدار أحدث منه قبل البدء. بالنسبة تعليمات لتثبيت CocoaPods على نظام التشغيل macOS، يُرجى الرجوع إلى عملية تثبيت CocoaPods. الدليل.
مثال لإعداد الرمز
MediaPipe أمثلة يحتوي المستودع على أمثلة تطبيقات iOS لمهام MediaPipe.
يمكنك إنشاء مشروع من خلال نموذج الرمز البرمجي، وإنشاء المشروع، ثم تشغيل المهمة. تؤدي الخطوات التالية إلى إنشاء النص المصنِّف المهمة.
لاستيراد نموذج مشروع الرمز البرمجي وإنشاءه:
افتح الوحدة الطرفية وانسخ مستودع أمثلة 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، راجع إنشاء تطبيق على Xcode CANNOT TRANSLATE التطبيق.
تبعيات "مهام MediaPipe"
توفر مهام MediaPipe مكتبتين تم إنشاؤهما مسبقًا للرؤية والنص. تشير رسالة الأشكال البيانية
يجب وضع ملف طراز .tflite
في حزمة تطبيق iOS التي
يستخدم النموذج. بناءً على MediaPipe Tas، أضف الرؤية أو النص
إلى قائمة المجموعات في CocoaPods Podfile
. للحصول على تعليمات حول
لإنشاء Podfile
باستخدام المجموعات المتسلسلة المطلوبة لتطبيقك، راجِع المقالة استخدام
CocoaPods
المهام المتعلّقة بالذكاء الاصطناعي التوليدي
تحتوي مكتبات الذكاء الاصطناعي التوليدي على MediaPipe Tasks على مهام تعالج الصور أو
إنشاء النصوص. لتثبيت مكتبة الذكاء الاصطناعي التوليدي في MediaPipe Tasks، أضِف
MediaPipeTasksGenAI
وMediaPipeTasksGenAIC
مجموعة متجاورة إلى هدف تطبيقك في
Podfile
.
واجهة برمجة تطبيقات استنتاج النماذج اللغوية الكبيرة
يتم تضمين مهمة استنتاج MediaPipe LLM ضمن MediaPipeTasksGenAI
وMediaPipeTasksGenAIC
مجموعة.
target 'MyLlmInferenceApp' do
use_frameworks!
pod 'MediaPipeTasksGenAI'
pod 'MediaPipeTasksGenAIC'
end
المهام المتعلّقة بالرؤية
تحتوي مكتبة رؤية "مهام MediaPipe" على المهام التي تعالج الصور أو الفيديوهات.
المدخلات. لتثبيت مكتبة الرؤى في MediaPipe Tasks، أضِف
مجموعة واحدة (MediaPipeTasksVision
) إلى هدف تطبيقك في Podfile
.
target 'MyAppWithMediaPipeTasksVision' do
use_frameworks!
pod 'MediaPipeTasksVision'
end
المهام النصية
تحتوي المكتبة النصية MediaPipe Tasks على المهام التي تعالج بيانات اللغة
تنسيق النص. لتثبيت المكتبة النصية "مهام 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 "مهام Google" تشغيل النماذج إلا على معالِجات وحدة المعالجة المركزية العادية.
تحديد المشاكل وحلّها
للحصول على مساعدة في الإجابة عن الأسئلة الفنية ذات الصلة بـ MediaPipe، انتقل إلى منتدى group أو حزمة القائمة الكاملة للحصول على الدعم من المجتمع. للإبلاغ عن أخطاء أو تقديم طلبات ميزات، يمكنك الإبلاغ عن مشكلة على GitHub.
للحصول على مساعدة في إعداد بيئة تطوير iOS، يُرجى الانتقال إلى Apple Developer (مطوّر برامج Apple). الوثائق: