Чтобы помочь вам создавать приложения для Android, которые взаимодействуют с устройствами Matter, Google разработала Google Home Mobile SDK. Mobile SDK включает два основных API, которые позволяют приложениям вводить устройства в эксплуатацию и предоставлять к ним доступ в сети Google.
После добавления устройства в сеть Google пользователи смогут управлять им через Google Home app (GHA), элементы управления питанием Android, голосовые команды и сенсорные экраны устройств Nest.
Mobile SDK также позволяет определить собственный сервис ввода в эксплуатацию, который можно использовать для ввода устройств в эксплуатацию в дополнительных экосистемах Matter.
Как интегрировать Mobile SDK в приложение для Android
Чтобы начать, выполните следующие действия:
Следуйте инструкциям в статье Как настроить Google Play services.
Добавьте зависимость Play services в файл
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Обеспечьте доставку модулей
Модуль Play services home необязателен, поэтому функции 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 или более позднюю версию, добавьте в файл AndroidManifest.xml блок queries, чтобы ваше приложение могло вызывать другие приложения.
<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.