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

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

يمكن تثبيت النماذج في واجهات برمجة تطبيقات ML Kit بطريقتَين:

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

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

يعرض الجدول أدناه مسارات تثبيت النماذج المتوافقة مع كل ميزة من ميزات ML Kit:

غير مجمّعة مجمّعة تم تنزيلها ديناميكيًا
الإصدار 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 لغة، وليس من الضروري دائمًا تضمين كل اللغات في الميزة أثناء التثبيت. لهذا الغرض، نقدّم خيار التثبيت الثالث الذي يتم فيه تنزيل النماذج عند الطلب بعد التثبيت. في الوقت الحالي، يتوفّر هذا الخيار فقط في ميزة التعرّف على الحبر الرقمي والترجمة واستخراج الكيانات.