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

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

إيقاف إشعارات اكتشاف الأجهزة القابلة للتجهيز

إشعار نصف الشاشة على Android
الشكل 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 تتحقّق من أنّ التطبيق يتيح intent filter ACTION_COMMISSION_DEVICE. وفي حال عدم توفّر intent filter، يتم توجيه المستخدم إلى "متجر Play" لتحديث التطبيق.
  2. غير مثبَّت : يتم توجيه المستخدم إلى "متجر Play" لتثبيت التطبيق قبل المتابعة.