Android için Home Mobile SDK

Google, Matter cihazlarla etkileşime giren Android uygulamaları oluşturmanıza yardımcı olmak için Google Home Mobile SDK özelliğini geliştirdi. Mobile SDK, uygulamalarınızın kullanıma sunmasına ve cihazları Google kumaşıyla paylaşmasına olanak tanıyan iki temel API içerir.

Bir cihaz Google kumaşına eklendikten sonra kullanıcılarınız Google Home app (GHA) cihazını, Android güç kontrollerini, sesi ve Nest dokunmatik ekran cihazlarını kullanarak kontrol edebilir.

Mobile SDK, cihazları ek Matter ekosistemlere yaptırmak için kullanabileceğiniz bir özel komisyon hizmeti de tanımlamanızı sağlar.

Mobil SDK'yı Android uygulamanıza entegre edin

Başlamak için aşağıdaki adımları tamamlayın:

  1. Google Play services ayarlarını yapma başlıklı makalede verilen talimatları uygulayın.

  2. Play services bağımlısını build.gradle dosyanıza ekleyin:

    implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'

Modül yayınından emin olun

Play services home modülü isteğe bağlıdır. Bu nedenle Matter işlevi, yalnızca cihazdaki bir uygulama AndroidManifest.xml dosyasında uygun Play services modülü bağımlılığını belirtiyorsa kullanıcının cihazında bulunur.

Hem GHA hem de Google Home Sample App for Matter, bu modüle bağımlılığı manifestlerine ekler. Mobile SDK uygulamasını Android uygulamanıza entegre ediyorsanız uygulamanızın kullanıcılarına Matter desteği sağlamak için AndroidManifest.xml dosyanızdaki application bildirimine aşağıdaki service blokunu ekleyin:

<service android:name="com.google.android.gms.metadata.ModuleDependencies"
    android:enabled="false"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
    </intent-filter>

    <meta-data android:name="home:0:preferred" android:value=""/>
</service>

Bu özellik yalnızca Play services 22.50.14 veya sonraki sürümleri çalıştıran Android cihazlarda desteklenir.

Örnek uygulama için Sample App for Matter manifestine bakın.

Home modülünün kullanılabilirliğini çalışma zamanında kontrol etmek için ModuleInstallClient özelliğini kullanabilirsiniz. Daha fazla bilgi için ModuleInstallClient ile API kullanılabilirliğini sağlama sayfasına bakın.

Diğer Android uygulamalarını arama

Android 11 veya sonraki bir sürümü kullanıyorsanız uygulamanızın diğer uygulamalara çağrı yapabilmesi için AndroidManifest.xml alanına aşağıdaki queries blokunu dahil etmeniz gerekir.

<queries>
    <!-- For GMS Core/Play service -->
        <package android:name="com.google.android.gms" />
        <package android:name="com.android.vending" />
    <!-- End of GMS Core/Play service-->
</queries>

Daha fazla bilgi için Android'de paket görünürlüğü filtreleme makalesine göz atın.

Matter için Google Home Örnek Uygulamasını Kullanma

Mobile SDK uygulamasının bir Android uygulamasından nasıl çalıştığını öğrenmek için Sample App for Matter sayfamızı deneyin.

Sample App for Matter sürümünü deneyin

Kendi uygulamanızı oluşturun

Hızlı bir başlangıç yapmanıza yardımcı olmak için Sample App for Matter kaynağını açık kaynaklı hale getirdik ve tamamlayıcı kodu laboratuvarımuzu kullanarak kendi Android projeleriniz için örnek kodumuzu özelleştirebilirsiniz.

Sample App for Matter codelab'e gidin

Kaynaklar

Mobile SDK hakkında daha fazla bilgi için API Referansı'na bakın.

Bu SDK'nın son kullanıcı verilerini nasıl işlediğini öğrenmek için Home Mobile SDK Google Play Veri Güvenliği Bölümü'ne bakın.