راه‌اندازی کیت توسعه نرم‌افزار تلفن همراه Home

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

جلوگیری از اعلان‌های کاوش کارمزددار

اعلان نیم‌برگ Android
شکل ۱: نمونه‌ای از اعلان نیم‌برگی Android

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

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

اگر برنامه شما بیش‌از ۱۵ دقیقه در پیش‌زمینه باشد، این API که سرکوب را فعال می‌کند منقضی می‌شود. برای فعال کردن مجدد سرکوب پس‌از اتمام مهلت، دوباره با suppressHalfSheetNotification() تماس بگیرید، درغیراین‌صورت اعلان‌های نیم‌برگی شروع به نمایش داده شدن می‌کنند.

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

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

اگر از Mobile SDK برای مأمور کردن استفاده می‌کنید، باید نام بسته برنامه را در Google Home Developer Console اضافه کنید، میاناهای برنامه‌سازی کاربردی Matter ما را پیاده‌سازی کنید، و با مدیریت کردن هدف ACTION_COMMISSION_DEVICE نشان دهید که برنامه‌تان از مأمور کردن Matter پشتیبانی می‌کند.

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» هدایت می‌شود.