تتناول هذه الصفحة استخدام ميزات محدّدة في واجهة برمجة التطبيقات الخاصة بتفعيل الأجهزة في Google Home Mobile SDK.
إيقاف إشعارات الاستكشاف المؤهّلة للحصول على عمولة
يستخدم 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>
يمكنك الاطّلاع على بيان تطبيقنا النموذجي للحصول على مرجع.
أداة اختيار التطبيقات
هناك طريقتان يظهر بهما تطبيقك في أداة اختيار التطبيقات أثناء عملية الإعداد:
- في شاشة اختيار تطبيق
- إذا اختار المستخدمون اختيار تطبيق آخر، سيظهر التطبيق في شاشة التطبيقات الأخرى المثبّتة.
التطبيقات المقترَحة
تعرض أداة اختيار التطبيقات تطبيقَين مقترَحيْن.
- يكون العنصر الأول دائمًا Google Home app (GHA).
- أما المعرّف الثاني، فهو مخصّص للتطبيق المفضّل لدى الشركة المصنّعة للجهاز، إذا تم تحديده في مشروع Developer Console مرتبط بمعرّف المورّد (VID) أو معرّف المنتج (PID) الخاص بالجهاز.
هناك سيناريوهان يظهر فيهما التطبيقان على شاشة اختيار تطبيق.
- مثبَّت - Play services تأكَّد من أنّ التطبيق يتوافق مع فلتر الأهداف
ACTION_COMMISSION_DEVICE. في حال عدم توفّر intent filter، يتم توجيه المستخدم إلى "متجر Play" لتحديث التطبيق. - لم يتم التثبيت: يتم توجيه المستخدم إلى "متجر Play" لتثبيت التطبيق قبل المتابعة.