راهنمای راه اندازی برای iOS، راهنمای راه اندازی برای iOS

این صفحه به شما نشان می دهد که چگونه محیط توسعه خود را برای استفاده از MediaPipe Tasks در برنامه های iOS خود تنظیم کنید.

دستگاه ها و پلتفرم های پشتیبانی شده

برای ایجاد برنامه های iOS با MediaPipe Tasks، محیط توسعه شما به موارد زیر نیاز دارد:

  • macOS Mojave 10.14.3 یا بالاتر.

  • Xcode 10.3 یا بالاتر.

  • دستگاه iOS با حداقل iOS 12.0. از طرف دیگر، یک شبیه‌ساز iOS می‌تواند برنامه‌هایی را که به دوربین دستگاه نیاز ندارند، مدیریت کند.

راه اندازی محیط توسعه دهنده

قبل از اجرای یک وظیفه MediaPipe در یک برنامه iOS، باید یک پروژه Xcode موجود داشته باشید یا یک پروژه جدید در دستگاه محلی خود ایجاد کنید.

MediaPipe Tasks فقط با استفاده از CocoaPods قابل نصب است. قبل از شروع باید CocoaPods 1.12.1 یا بالاتر را نصب کنید. برای دستورالعمل‌های نصب CocoaPods در macOS، به راهنمای نصب CocoaPods مراجعه کنید.

نمونه راه اندازی کد

مخزن MediaPipe Examples شامل نمونه برنامه های iOS برای وظایف MediaPipe است.

می توانید یک پروژه از کد مثال ایجاد کنید، پروژه را بسازید و وظیفه را اجرا کنید. مراحل زیر وظیفه طبقه‌بندی متن را می‌سازد.

برای وارد کردن و ساخت نمونه پروژه کد:

  1. ترمینال را باز کنید، مخزن MediaPipe Examples را کلون کنید و به دایرکتوری حاوی TextClassifier.xcodeproj و Podfile بروید.

    git clone https://github.com/google-ai-edge/mediapipe-samples
    cd mediapipe/examples/text_classification/ios
    
  2. MediaPipe Tasks را با استفاده از CocoaPods نصب کنید:

    pod install
    

    این دستور یک فایل TextClassifier.xcworkspace در فهرست پروژه مثال ایجاد می کند.

  3. روی فایل TextClassifier.xcworkspace دوبار کلیک کنید تا پروژه در Xcode باز شود. اگر فایل TextClassifier.xcodeproj از قبل باز است، قبل از باز کردن فایل TextClassifier.xcworkspace آن را ببندید.

  4. طرح TextClassifier را انتخاب کنید و یک دستگاه فیزیکی یا شبیه ساز iOS را از نوار ابزار پنجره پروژه خود انتخاب کنید. هنگام استفاده از یک دستگاه iOS فیزیکی، مطمئن شوید که به مک شما متصل است.

  5. روی دکمه Run در نوار ابزار پروژه خود کلیک کنید.

برای دستورالعمل‌های بیشتر در مورد اجرای برنامه در Xcode، به ساخت و اجرای برنامه مراجعه کنید.

وابستگی های MediaPipe Tasks

MediaPipe Tasks دو کتابخانه از پیش ساخته شده برای دید و متن فراهم می کند. فایل مدل .tflite باید در بسته نرم افزاری iOS که از مدل استفاده می کند قرار داشته باشد. بسته به MediaPipe Tas، ویژن یا کتابخانه متنی را به لیست پادهای موجود در Podfile CocoaPods اضافه کنید. برای دستورالعمل‌های مربوط به ایجاد یک Podfile با پادهای مورد نیاز برای برنامه خود، به استفاده از CocoaPods مراجعه کنید.

وظایف هوش مصنوعی مولد

کتابخانه های MediaPipe Tasks Generative AI شامل وظایفی است که تولید تصویر یا متن را مدیریت می کند. برای نصب کتابخانه هوش مصنوعی MediaPipe Tasks Generative، غلاف MediaPipeTasksGenAI و MediaPipeTasksGenAIC را به هدف برنامه خود در Podfile اضافه کنید.

LLM Inference API

وظیفه استنتاج MediaPipe LLM در غلاف MediaPipeTasksGenAI و MediaPipeTasksGenAIC قرار دارد.

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

وظایف چشم انداز

کتابخانه چشم انداز MediaPipe Tasks شامل وظایفی است که ورودی های تصویر یا ویدیو را مدیریت می کند. برای نصب کتابخانه چشم انداز MediaPipe Tasks، MediaPipeTasksVision pod را به هدف برنامه خود در Podfile اضافه کنید.

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

وظایف متنی

کتابخانه متن MediaPipe Tasks شامل وظایفی است که داده های زبان را در قالب متن مدیریت می کند. برای نصب کتابخانه متن MediaPipe Tasks، MediaPipeTasksText pod را به هدف برنامه خود در 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 Task API اجازه می دهد.

نام گزینه شرح ارزش های پذیرفته شده
modelAssetPath مسیر مدل به فایل مدل در بسته نرم افزاری iOS. مسیر به عنوان یک رشته

شتاب سخت افزاری

در iOS، MediaPipe Tasks فقط از مدل‌های در حال اجرا روی پردازنده‌های استاندارد CPU پشتیبانی می‌کند.

عیب یابی

برای راهنمایی در مورد سؤالات فنی مرتبط با MediaPipe، از گروه بحث یا Stack Overflow برای پشتیبانی از انجمن دیدن کنید. برای گزارش اشکال یا درخواست ویژگی، مشکل را در GitHub ثبت کنید .

برای راهنمایی در تنظیم محیط توسعه iOS خود، از مستندات برنامه‌نویس اپل دیدن کنید.