تفعيل حزمة تطوير البرامج (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 تأكَّد من أنّ التطبيق متوافق مع ملف فلتر الغرض ACTION_COMMISSION_DEVICE. إذا لم يكن فلتر الأهداف متوفّرًا، سيتم توجيه المستخدم إلى "متجر Play" لتحديث التطبيق.
  2. غير مثبّت - يتم توجيه المستخدم إلى "متجر Play" لتثبيت التطبيق قبل المتابعة.