Home Mobil SDK'sı Devreye Alma

Bu sayfada, Google Home Mobile SDK'daki belirli devreye alma API'si özelliklerinin kullanımı ele alınmaktadır.

Komisyon kazandıran keşif bildirimlerini engelleme

Android Halfsheet Notification
Şekil 1: Android'de yarım sayfa bildirim örneği

Google Play services on Android, varsayılan olarak kullanıcıları yakında komisyon kazanmaya uygun Matter cihazlar olduğu konusunda proaktif olarak bilgilendirmek için mobil cihaz ekranının alt yarısını kaplayan "yarım sayfa" bildirimlerini kullanır.

Uygulamanız ön plandayken kesintileri önlemek için Mobile SDK içindeki suppressHalfSheetNotification() yöntemini çağırarak bu bildirimleri bastırabilirsiniz. Daha fazla bilgi için API belgelerine bakın.

Bu API ile etkinleştirilen bastırma, uygulamanız 15 dakikadan uzun süre ön planda kalırsa zaman aşımına uğrar. Zaman aşımından sonra bastırmayı yeniden etkinleştirmek için suppressHalfSheetNotification() işlevini tekrar çağırın. Aksi takdirde, yarım sayfa bildirimleri görünmeye başlar.

Bu API'nin uygulanmış halini Google Home Sample App for Matter adresinde bulabilirsiniz. Daha fazla bilgi için HalfSheetSuppressionObserver.kt sayfasına bakın.

Matter devreye alma desteğini belirtme

Mobile SDK ile komisyon alıyorsanız Google Home Developer Console bölümüne uygulama paketi adını eklemeniz, Matter API'lerimizi uygulamanız ve ACTION_COMMISSION_DEVICE amacını işleyerek uygulamanızın Matter komisyon alma özelliğini desteklediğini belirtmeniz gerekir.

AndroidManifest.xml dosyanızdaki application beyanına aşağıdaki intent-filter öğesini ekleyin:

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

Referans için örnek uygulamamızın manifestine bakın.

Uygulama seçici

Uygulama seçici

Uygulamanız, devreye alma işlemi sırasında uygulama seçicide iki şekilde görünür:

  1. Bir uygulama seçin ekranında.
  2. Kullanıcılar Başka bir uygulama seç'i belirlerse bu uygulama, Diğer Yüklü Uygulamalar ekranında gösterilir.

Önerilen uygulamalar

Uygulama seçicide iki önerilen uygulama gösterilir.

  • Birincisi her zaman Google Home app (GHA) olur.
  • İkincisi ise cihaz üreticisinin tercih ettiği uygulama içindir. Bu uygulama, cihazın VID'si veya PID'si ile ilişkili bir Developer Console projesinde tanımlanmışsa geçerlidir. Cihaz üreticisinin tercih ettiği komisyoner uygulaması

Uygulamaların Bir uygulama seçin ekranında olduğu iki senaryo vardır.

  1. Yüklü: Uygulamanın Play services amaç filtresini desteklediğini kontrol edin.ACTION_COMMISSION_DEVICE Amaç filtresi eksikse kullanıcı, uygulamayı güncellemek için Play Store'a yönlendirilir.
  2. Yüklü Değil: Kullanıcı, devam etmeden önce uygulamayı yüklemek için Play Store'a yönlendirilir.