Чтобы помочь вам создавать приложения 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'
Обеспечить доставку модуля
Модуль 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».