این صفحه نحوه استفاده از ویژگی‌های API راه‌اندازی منتخب در Google Home Mobile SDK را پوشش می‌دهد.
اعلان‌های کشف قابل سفارش را غیرفعال کنید
به طور پیش‌فرض، Google Play services در Android از اعلان‌های «نیم‌صفحه‌ای» استفاده می‌کنند که نیمه پایینی صفحه نمایش دستگاه تلفن همراه را می‌پوشاند تا به کاربران نشان دهد که دستگاه‌های Matter که قابلیت سفارش دارند در نزدیکی آنها هستند.
برای جلوگیری از وقفه‌ها در حین اجرای برنامه، می‌توانید با فراخوانی متد suppressHalfSheetNotification() در Mobile SDK ، این اعلان‌ها را غیرفعال کنید. برای اطلاعات بیشتر به مستندات API مراجعه کنید.
اگر برنامه شما بیش از ۱۵ دقیقه در پیش‌زمینه باشد، سرکوب فعال‌شده توسط این API پایان می‌یابد. برای فعال کردن مجدد سرکوب پس از یک دوره زمانی، دوباره تابع suppressHalfSheetNotification() را فراخوانی کنید، در غیر این صورت اعلان‌های halfsheet شروع به نمایش می‌کنند.
پیاده‌سازی این API را می‌توان در Google Home Sample App for Matter یافت. برای اطلاعات بیشتر به HalfSheetSuppressionObserver.kt مراجعه کنید.
پشتیبانی برای راه‌اندازی Matter را مشخص کنید
اگر از Mobile SDK برای راه‌اندازی استفاده می‌کنید، باید نام بسته برنامه را در Google Home Developer Console اضافه کنید، APIهای Matter ما را پیاده‌سازی کنید و با مدیریت قصد ACTION_COMMISSION_DEVICE نشان دهید که برنامه شما از راه‌اندازی Matter پشتیبانی می‌کند.
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 هدایت می‌شود.