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

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

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

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

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

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

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

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

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