مسارات تثبيت نماذج "حزمة تعلّم الآلة" على نظام التشغيل 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>

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

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

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

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

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

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

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

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

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