Android için Home Mobile SDK'sı

Android uygulamanızı kullanarak Matter cihazlar, Google tarafından geliştirilen Google Home Mobile SDK. İlgili içeriği oluşturmak için kullanılan Mobile SDK, uygulamalarınızın şunları yapmasına olanak tanıyan iki temel API içerir: Google yapısıyla komisyon alabilir ve cihazları paylaşabilirsiniz.

Google yapısına eklenen bir cihaz kullanıcılarınız tarafından kontrol edilebilir. Google Home app (GHA), Android güç kontrolleri, ses, ve Nest dokunmatik ekranlı cihazlarda kullanabilirsiniz.

Mobile SDK ayrıca bir özel komisyon hizmeti Cihazları ek Matter için sipariş vermek üzere kullanabileceğiniz ekosistemler.

Mobil SDK'yı Android uygulamanıza entegre etme

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

  1. Şu adreste sağlanan talimatları uygulayın: Google Play services hizmetini ayarlayı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üllerin yayınlanmasını sağlama

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

Hem GHA hem de Google Home Sample App for Matter bunu içeriyor modül bağımlılığını belirtir. Dönüşüm izleme özelliğini entegre ediyorsanız Android uygulamanıza Mobile SDK Uygulamanızın kullanıcıları için Matter desteği, hesabınızdaki application beyanına service blok sonra AndroidManifest.xml dosyası:

<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 şu anda çalışan Android cihazlarda desteklenir Play services 22.50.14 veya sonraki sürümler.

Sample App for Matter manifesto örnek bir uygulama inceleyelim.

Çalışma zamanında Home modülünün kullanılabilirliğini şu komutu kullanarak kontrol edebilirsiniz: ModuleInstallClient Bkz. ModuleLoadClient 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 şunları eklemeniz gerekir: Uygulamanızın telefon edebilmesi için AndroidManifest.xml içinde queries engelleme diğer uygulamalar.

<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 makalesi.

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

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

Şunu deneyin: Sample App for Matter

Kendi uygulamanızı oluşturun

Hızlı başlangıç yapmanıza yardımcı olmak için Sample App for Matter ve tamamlayıcı bir codelab ile birlikte şunları yapabilirsiniz: örnek kodumuzu kendi Android projeleriniz için özelleştirin.

Sample App for Matter codelab'ine gidin

Kaynaklar

Mobile SDK hakkında daha fazla bilgi için: API Referansı.

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