مسارات تثبيت نماذج "حزمة تعلّم الآلة" على نظام التشغيل Android

تستفيد جميع ميزات حزمة تعلُّم الآلة من نماذج تعلُّم الآلة المُدرَّبة من Google (المعروفة باسم نماذجك الأساسية) افتراضيًا. لا ينطبق هذا الدليل إلا على النماذج الأساسية. انظر هنا للحصول على إرشادات حول النماذج المخصّصة

يمكن تثبيت الطُرز في واجهات برمجة تطبيقات ML Kit بإحدى الطرق الثلاث التالية:

  1. غير مجمّعة: يتم تنزيل النماذج وإدارتها من خلال "خدمات Google Play".
  2. مجمَّعة: يتم ربط النماذج بتطبيقك بشكل ثابت في وقت الإنشاء.
  3. التنزيل ديناميكيًا: يتم تنزيل النماذج عند الطلب.

مسارات التثبيت المتوافقة لكل واجهة برمجة تطبيقات

يوضّح الجدول أدناه مسارات تثبيت النماذج المتوافقة مع كل تقنية تعلُّم الآلة. ميزة مجموعة الأدوات:

غير مجمّعة مجمّعة تم تنزيلها ديناميكيًا
الإصدار 2 من ميزة التعرّف على النصوص ✅ ✅
التعرّف على الوجه ✅ ✅
رصد شبكة الوجه ✅
رصد الوضعية ✅
تقسيم صور السيلفي ✅
مسح الرموز الشريطية ضوئيًا ✅ ✅
تصنيف الصور ✅ ✅
رصد الأجسام وتتبُّعها ✅
التعرّف الرقمي على الحبر ✅
الماسح الضوئي للمستندات ✅
تقسيم المواضيع ✅
أداة مسح الرموز من Google ✅
تحديد اللغة ✅ ✅
الترجمة ✅
الرد السريع ✅ ✅
استخراج الكيانات ✅

تعرض الأدلة المتعلّقة بواجهة برمجة التطبيقات خيارات التثبيت المتاحة لواجهة برمجة التطبيقات المحدّدة.

الاختلافات الرئيسية بين خيارات التثبيت

غير مجمعة مجمّعة تم تنزيلها ديناميكيًا
أين يتم تخزين النماذج؟ يتم تخزينها في "خدمات Google Play" ولا يتم احتسابها ضمن مساحة التخزين التي يستخدمها هذا التطبيق. يتم حفظها في مساحة التخزين الخاصة بالتطبيق بعد التثبيت يتم حفظها في مساحة التخزين الخاصة بالتطبيق بعد تنزيل النموذج.
كيف يؤثر حجم النموذج في حجم التطبيق؟ لا تساهم في حجم التطبيق المساهمة مباشرةً في حجم التطبيق لا تساهم في حجم التطبيق بل تزيد مساحة التخزين الخاصة بالتطبيق
متى يتم تعديل النماذج؟ يتم تحديثها تلقائيًا عند طرح إصدار أحدث يجب تحديث التطبيق لتحديث النموذج يجب تحديث التطبيق لتحديث النموذج
متى يتم تنزيل النماذج؟ يجب تنزيل النماذج قبل استخدامها يتم تضمين جميع النماذج والميزات عند تثبيت التطبيق، وبالتالي يمكن استخدامها على الفور. يجب إدارة عمليات تنزيل النماذج وتعديلها وحذفها يدويًا باستخدام واجهة برمجة التطبيقات RemoteModelManager
متى تتم إزالة الطُرز من الجهاز؟ لن تزيل "خدمات Google Play" طراز الجهاز من وحدة التخزين إلا إذا تم إلغاء تثبيت كل التطبيقات التي تعتمد على الطراز. تتم إزالة النماذج من مساحة التخزين الخاصة بالتطبيق. عندما يتم إلغاء تثبيت التطبيق تتم إزالة النماذج التي تم تنزيلها من مساحة التخزين الخاصة بالتطبيق. عندما يتم إلغاء تثبيت التطبيق

كيفية الاختيار بين التطبيقات المجمّعة وغير المجمّعة

إذا كانت واجهة برمجة التطبيقات تتيح كلاً من خيارَي التثبيت المجمّع وغير المجمّع:

  • استخدِم الخيار المجمّع إذا كنت تعطي الأولوية لما يلي:

    • إتاحة وظائف الميزة بالكامل بعد تثبيت التطبيق مباشرةً
    • وظائف الميزة بدون اتصال بالشبكة بعد تثبيت التطبيق

  • استخدِم الخيار غير المجمّع إذا كنت تعطي الأولوية لما يلي:

    • حجم تطبيق أصغر
    • تحديثات النماذج المبرمَجة من خلال "خدمات Google Play"

كيفية تنزيل النماذج

عند استخدام خيار النموذج غير المجمّع، يمكنك تحديد كيفية تنزيل النماذج على الجهاز:

  • يمكنك تفعيل عمليات تنزيل النماذج في وقت التثبيت من خلال إضافة بيان إلىملفAndroidManifest.xml في تطبيقك. على سبيل المثال، يوضّح مقتطف الرمز البرمجي أدناه كيفية ضبط تطبيقك لتنزيل نموذج فحص الرمز الشريطي تلقائيًا بعد تثبيت تطبيقك من "متجر Play":

    <application ...>
      ...
      <meta-data
          android:name="com.google.mlkit.vision.DEPENDENCIES"
          android:value="barcode" >
      <!-- To use multiple models: android:value="barcode,model2,model3" -->
</application>

  • يمكنك طلب تنزيل صريح من خلال Google Play Services ModuleInstallClient API.

  • في حال عدم تفعيل عمليات تنزيل نموذج وقت التثبيت أو طلب الحصول على إذن صريح عند التنزيل، سيتم تنزيل النموذج في أول مرة يتم فيها تشغيل الميزة. سيتعذّر تنفيذ طلبات الاستنتاج إلى حين اكتمال عملية التنزيل.

كيفية تحديث النماذج

لتعديل نماذجك عند استخدام النموذج المجمّع أو خيار نماذج التي يتم تنزيلها ديناميكيًا:

  1. عدِّل ملف gradle الخاص بتطبيقك لاستخدام أحدث مكتبة لعملاء ميزات ML Kit.

    dependencies {
  implementation 'com.google.mlkit:barcode-scanning: 17.3.0' // The latest version number of the API
}

  2. أعِد إنشاء تطبيقك.

سبب توفير بعض واجهات برمجة التطبيقات لنماذج يتم تنزيلها ديناميكيًا

تحتوي بعض واجهات برمجة تطبيقات ML Kit على عدد كبير جدًا من خيارات النماذج التي يتعذّر تجميعها. على سبيل المثال، تتيح ميزة التعرّف على الحبر الرقمي استخدام أكثر من 300 لغة، وليس من الضروري دائمًا تضمين كل لغة في الميزة أثناء التثبيت. لهذا الغرض، نوفر خيار التثبيت الثالث، الذي يتم فيه إعداد النماذج يتم تنزيلها عند الطلب بعد التثبيت. في الوقت الحالي، يتوفّر هذا الخيار فقط في ميزات التعرّف على الحبر الرقمي واستخراج العناصر والترجمة.