Домашний мобильный SDK для Android

Чтобы помочь вам создавать приложения Android, взаимодействующие с устройствами Matter , компания Google разработала Google Home Mobile SDK . Mobile SDK включает два основных API, которые позволяют вашим приложениям подключать устройства к сети Google и обмениваться ими.

После добавления устройства в сеть Google ваши пользователи смогут управлять своими устройствами с помощью Google Home app (GHA) , элементов управления питанием Android, голосового управления и устройств с сенсорным экраном Nest.

Mobile SDK также позволяет вам определить пользовательскую службу ввода в эксплуатацию , которую вы можете использовать для ввода устройств в эксплуатацию дополнительных экосистем Matter .

Интегрируйте Mobile SDK в свое приложение для Android

Для начала выполните следующие шаги:

  1. Следуйте инструкциям, приведенным в разделе Настройка Google Play services .

  2. Добавьте зависимость Play services в файл build.gradle :

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

Обеспечить доставку модуля

Модуль home Play services является необязательным, поэтому функциональность Matter будет доступна на устройстве пользователя только в том случае, если приложение на устройстве укажет соответствующую зависимость модуля Play services в файле AndroidManifest.xml .

GHA и Google Home Sample App for Matter включают эту зависимость от модуля в свой манифест. Если вы интегрируете Mobile SDK в своё приложение Android , чтобы обеспечить поддержку Matter для пользователей вашего приложения, добавьте следующий блок service в объявление application в файле AndroidManifest.xml :

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

Поддерживается только для устройств Android , на которых установлены Play services версии 22.50.14 или выше.

Пример реализации смотрите в манифесте Sample App for Matter .

Проверить доступность модуля Home во время выполнения можно с помощью ModuleInstallClient . Подробнее см. на странице «Обеспечение доступности API с помощью ModuleInstallClient» .

Вызов других приложений Android

Если вы используете Android 11 или выше, вам необходимо включить следующий блок queries в AndroidManifest.xml , чтобы ваше приложение могло выполнять вызовы других приложений.

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

Более подробную информацию см. в статье Фильтрация видимости пакетов на Android .

Используйте пример приложения Google Home для Matter

Чтобы узнать, как работает Mobile SDK в приложении для Android, попробуйте наш Sample App for Matter .

Попробуйте Sample App for Matter

Создайте свое собственное приложение

Чтобы помочь вам быстро приступить к работе, мы открыли исходный код Sample App for Matter и предоставили сопутствующую практическую работу, позволяющую вам настраивать наш пример кода для собственных проектов Android.

Перейти к Sample App for Matter

Ресурсы

Более подробную информацию о Mobile SDK можно найти в Справочнике API .

Чтобы узнать, как этот SDK обрабатывает данные конечного пользователя, обратитесь к разделу «Безопасность данных Google Play для Home Mobile SDK».