Чтобы помочь вам создавать 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 или более позднюю версию, вам необходимо добавить следующий блок 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.