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

تتناول هذه الصفحة استخدام ميزات محدّدة في واجهة Commissioning API في 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 intent filter. إذا لم يكن intent filter متوفّرًا، سيتم توجيه المستخدم إلى متجر Google Play لتحديث التطبيق.
  2. غير مثبَّت: يتم توجيه المستخدم إلى متجر Google Play لتثبيت التطبيق قبل المتابعة.