تتناول هذه الصفحة استخدام ميزات محددة من واجهة برمجة التطبيقات لإعداد العمولة في Google Home Mobile SDK.
إيقاف إشعارات اكتشاف المحتوى التي لا تحظى بعمولة
بشكل تلقائي، يستخدم Google Play services على Android إشعارات "النصف" التي تغطي النصف السفلي من شاشة الجهاز الجوّال لتزويد المستخدمين بإشارة استباقية إلى أنّ الأجهزة Matter التي يمكن تفويضها تقع بالقرب من الجهاز.
لمنع انقطاع الخدمة عندما يكون تطبيقك يعمل في المقدّمة، يمكنك
إيقاف هذه الإشعارات من خلال استدعاء الإجراء
suppressHalfSheetNotification()
في Mobile SDK. راجع وثائق واجهة برمجة التطبيقات
للحصول على مزيد من المعلومات.
تنتهي مهلة الإيقاف المفعَّلة من خلال واجهة برمجة التطبيقات هذه إذا ظلّ تطبيقك في المقدّمة لأكثر من 15 دقيقة. لإعادة تفعيل الإيقاف بعد انتهاء المهلة، اتّصِل بـ
suppressHalfSheetNotification() مرة أخرى، وإلا ستبدأ إشعارات
النصف الثاني في الظهور.
يمكن العثور على طريقة تنفيذ لواجهة برمجة التطبيقات هذه في
Google Home Sample App for Matter. اطّلِع على
HalfSheetSuppressionObserver.kt
للحصول على مزيد من المعلومات.
تحديد الدعم بشأن تفويض المسألة القانونية
إذا كنت تستخدم 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. في حال عدم توفّر فلتر الأهداف، يتم توجيه المستخدم إلى "متجر Play" لتحديث التطبيق. - غير مثبَّت - يتم توجيه المستخدم إلى متجر Play لتثبيت التطبيق قبل المتابعة.