راه اندازی SDK موبایل خانه

این صفحه استفاده از ویژگی‌های راه‌اندازی API را در Google Home Mobile SDK پوشش می‌دهد.

اعلان‌های کشف سفارشی را سرکوب کنید

اعلان نیم برگ اندروید
شکل 1: نمونه ای از اعلان نیم برگ اندروید

به‌طور پیش‌فرض، Google Play services در Android از اعلان‌های «نیم برگه» استفاده می‌کنند که نیمه پایینی صفحه دستگاه تلفن همراه را می‌پوشاند تا به کاربران نشانه‌ای فعال مبنی بر اینکه دستگاه‌های قابل سفارش Matter نزدیک هستند، ارائه می‌کند.

برای جلوگیری از وقفه زمانی که برنامه شما در پیش زمینه است، می توانید این اعلان ها را با فراخوانی روش suppressHalfSheetNotification() در Mobile SDK سرکوب کنید. برای اطلاعات بیشتر به مستندات API مراجعه کنید.

اگر برنامه شما بیش از 15 دقیقه در پیش زمینه باشد، سرکوب فعال شده توسط این API به پایان می رسد. برای فعال کردن مجدد suppression پس از یک بازه زمانی، مجدداً suppressHalfSheetNotification() فراخوانی کنید، در غیر این صورت اعلان‌های halfsheet ظاهر می‌شوند.

پیاده‌سازی این API را می‌توانید در Google Home Sample App for Matter پیدا کنید. برای اطلاعات بیشتر به HalfSheetSuppressionObserver.kt مراجعه کنید.

پشتیبانی از راه اندازی Matter را نشان دهید

اگر از Mobile SDK برای راه اندازی استفاده می کنید، باید نام بسته برنامه را در Google Home Developer Console اضافه کنید، Matter API های ما را پیاده سازی کنید و نشان دهید که برنامه شما از راه اندازی 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 هدایت می شود تا قبل از ادامه برنامه را نصب کند.