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

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

يمكن تثبيت النماذج في واجهات برمجة التطبيقات الخاصة بحزمة تعلُّم الآلة بإحدى الطرق الثلاث التالية:

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

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

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

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

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

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

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

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

في حال توفّر خيارَي التثبيت المجمَّع وغير المجمَّع في إحدى واجهات برمجة التطبيقات، اتّبِع ما يلي:

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

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

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

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

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

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

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

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

• يمكنك طلب التنزيل بشكل صريح من خلال واجهة ModuleInstallClient API في "خدمات Google Play".

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

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

لتعديل النماذج عند استخدام خيار "النموذج المجمّع" أو "النماذج التي يتم تنزيلها بشكل ديناميكي"، اتّبِع الخطوات التالية:

1. عدِّل ملف gradle الخاص بتطبيقك لاستخدام أحدث مكتبة لبرنامج عميل ميزة حزمة تعلّم الآلة.

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

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

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

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