تفعيل حزمة تطوير البرامج (SDK) للأجهزة الجوّالة المنزلية

تتناول هذه الصفحة استخدام ميزات محدّدة من واجهة برمجة التطبيقات الخاصة بتحديد الأجهزة في Google Home Mobile SDK.

إيقاف إشعارات الاقتراحات التي يمكن الحصول على عمولة مقابلها

إشعار Android Halfsheet
الشكل 1: مثال على إشعار نصف شاشة على Android

يستخدم الخيار Google Play services في Android تلقائيًا إشعارات "نصف الشاشة" التي تغطي النصف السفلي من شاشة الجهاز الجوّال لتزويد المستخدمين بمؤشر استباقي على أنّ أجهزة Matter قابلة للعمولة قريبة منهم.

لمنع حدوث انقطاعات أثناء عمل تطبيقك في المقدّمة، يمكنك إيقاف هذه الإشعارات من خلال استدعاء طريقة suppressHalfSheetNotification() في Mobile SDK. يمكنك الاطّلاع على مستندات واجهة برمجة التطبيقات للحصول على مزيد من المعلومات.

تنتهي مهلة الإيقاف المؤقت الذي تتيحه واجهة برمجة التطبيقات هذه إذا كان تطبيقك في المقدّمة لمدة تزيد عن 15 دقيقة. لإعادة تفعيل ميزة حظر الإشعارات بعد انتهاء المهلة، اتّصِل بالرقم suppressHalfSheetNotification() مرة أخرى، وإلا ستبدأ إشعارات نصف الشاشة في الظهور.

يمكن العثور على عملية تنفيذ لواجهة برمجة التطبيقات هذه في Google Home Sample App for Matter. يمكنك الاطّلاع على HalfSheetSuppressionObserver.kt لمزيد من المعلومات.

الإشارة إلى إمكانية إعداد أجهزة Matter

إذا كنت تستخدم Mobile SDK لتحديد العمولة، عليك إضافة اسم حزمة التطبيق في Google Home Developer Console وتنفيذ واجهات برمجة التطبيقات Matter والإشارة إلى أنّ تطبيقك يتيح تحديد العمولة Matter من خلال التعامل مع الغرض ACTION_COMMISSION_DEVICE.

أضِف intent-filter التالي إلى تعريف application ضمن ملف AndroidManifest.xml:

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

يمكنك الاطّلاع على بيان تطبيق نموذجي للحصول على مرجع.

أداة اختيار التطبيقات

أداة اختيار التطبيقات

هناك طريقتان يظهر بهما تطبيقك في أداة اختيار التطبيقات أثناء عملية الإعداد:

  1. في شاشة اختيار تطبيق
  2. إذا اختار المستخدمون اختيار تطبيق آخر، سيظهر التطبيق في شاشة التطبيقات الأخرى المثبّتة.

التطبيقات المقترَحة

تعرض أداة اختيار التطبيقات تطبيقَين مقترَحَين.

  • يكون العنصر الأول دائمًا Google Home app (GHA).
  • يُستخدم المعرّف الثاني للتطبيق المفضّل لدى الشركة المصنّعة للجهاز، إذا تم تحديده في مشروع Developer Console مرتبط بمعرّف المورّد (VID) أو معرّف المنتج (PID) الخاص بالجهاز. تطبيق الوسيط المفضَّل لدى الشركة المصنّعة للجهاز

هناك سيناريوهان يظهر فيهما التطبيقان على شاشة اختيار تطبيق.

  1. مثبَّت - Play services تأكَّد من أنّ التطبيق يتوافق مع فلتر الغرض ACTION_COMMISSION_DEVICE. في حال عدم توفّر فلتر الغرض، سيتم توجيه المستخدم إلى "متجر Play" لتحديث التطبيق.
  2. لم يتم التثبيت: يتم توجيه المستخدم إلى "متجر Play" لتثبيت التطبيق قبل المتابعة.