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

تتناول هذه الصفحة استخدام ميزات محدّدة في واجهة برمجة التطبيقات الخاصة بالتفعيل في 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>

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

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

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

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

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

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

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

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

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