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

تستفيد جميع ميزات ML Kit تلقائيًا من نماذج تعلُّم الآلة المُدرَّبة من 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 API في "خدمات Google Play".

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

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

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

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

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

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

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

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