Android için Home Mobile SDK'sı

Google, Matter cihazlarla etkileşim kuran Android uygulamaları oluşturmanıza yardımcı olmak için Google Home Mobile SDK'ı geliştirmiştir. Mobile SDK, uygulamalarınızın Google Fabric ile cihazları etkinleştirmesine ve paylaşmasına olanak tanıyan iki temel API içerir.

Google Fabric'e eklenen cihazlar, kullanıcılarınız tarafından Google Home app (GHA), Android güç kontrolleri, ses ve Nest dokunmatik ekranlı cihazlar aracılığıyla kontrol edilebilir.

Mobile SDK, cihazları ek Matterekosistemleriyle devreye almak için kullanabileceğiniz özel bir devreye alma hizmeti de tanımlamanıza olanak tanır.

Mobile SDK'yı Android uygulamanıza entegre etme

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ılığını build.gradle dosyanıza ekleyin:

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

Modülün yayınlanmasını sağlama

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ı belirtirse kullanıcının cihazında bulunur.

Hem GHA hem de Google Home Sample App for Matter, bu modül bağımlılığını manifest dosyalarına eklemiştir. Mobile SDK'ü Android uygulamanıza entegre ediyorsanız uygulamanızın kullanıcılarına Matter desteği sağlamak için AndroidManifest.xml dosyanızın application beyanına aşağıdaki service bloğunu 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'ın manifest dosyasına bakın.

ModuleInstallClient öğesini kullanarak Home modülünün çalışma zamanındaki kullanılabilirliğini kontrol edebilirsiniz. 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 içine aşağıdaki queries bloğunu eklemeniz 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 başlıklı makaleyi inceleyin.

Matter için Google Home Sample uygulamasını kullanma

Mobile SDK özelliğinin Android uygulamasında nasıl çalıştığını öğrenmek için Sample App for Matter'imizi deneyin.

Sample App for Matter deneyin

Kendi uygulamanızı oluşturma

Hızlı bir başlangıç yapmanıza yardımcı olmak amacıyla Sample App for Matter açık kaynaklı olarak, örnek kodumuzu kendi Android projeleriniz için özelleştirmenize olanak tanıyan tamamlayıcı bir codelab'i de sunduk.

Sample App for Matter codelab'ine gidin

Kaynaklar

Mobile SDK hakkında daha fazla bilgi edinmek 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.