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

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

جلوگیری از اعلان‌های کاوش قابل‌پرداخت کمیسیون

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

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

اگر برنامه‌تان بیش‌از ۱۵ دقیقه در پیش‌زمینه باشد، مهلت توقف فعال‌شده توسط این میانای برنامه‌سازی کاربردی تمام می‌شود. برای فعال کردن مجدد توقف پس‌از اتمام مهلت، دوباره 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» هدایت می‌شود.