В этом руководстве представлены рекомендации по UX-дизайну для проектирования удобных разрешений устройств и общего доступа к API Google Home для удобства адаптации в вашем приложении.
Основные темы, описанные здесь:
- Зачем использовать устройства совместно с Google Home?
- Ключевые этапы процесса обмена
- Техническая реализация
- Лучшие практики UX
Зачем использовать устройства совместно с Google Home?
Чтобы воспользоваться возможностями Home API, пользователи должны предоставить Google Home доступ к своим устройствам, потому что:
- Использование этих устройств в системах автоматизации является техническим требованием Google.
- Это помогает поддерживать единообразную и гибкую работу Google Home.
- Обеспечение единообразного представления устройств во всех приложениях с поддержкой Home API имеет решающее значение для предотвращения создания разрозненного и запутанного пользовательского опыта, когда пользователям приходится переключаться между приложениями для выполнения основных задач.
Ключевые компоненты потока обмена
| Компонент | Программа | Описание |
|---|---|---|
| API разрешений на Android | API для разрешений на Android | Предлагает пользователям предоставить разрешения вашему приложению. Перед использованием любого из API Home ваше приложение должно иметь разрешение на доступ к устройствам в доме пользователя (в API это называется « структура »). Однако порядок выполнения этого шага зависит от сценария разработчика и описан в разделе «Техническая реализация». |
| Связь между облаками | Облако-облако для привязки аккаунтов | Позволяет начать процесс привязки учётной записи для совместного использования устройств, подключённых к облаку, с Google Home прямо из вашего приложения. Чтобы снизить неудобства для пользователей, мы рекомендуем использовать функцию глубокой ссылки (доступную как для Android, так и для iOS), которая перенаправляет пользователей непосредственно на страницу привязки вашей учётной записи в GHA. |
| Ввод в эксплуатацию API на Android | Ввод в эксплуатацию | Хотя API обычно рассматривается как API для ввода в эксплуатацию новых устройств Matter , вы также можете использовать его для добавления фабрики Google к устройствам Matter , которые уже подключены к другой фабрике. Таким образом, это полезный инструмент для процесса адаптации. |
Техническая реализация
То, как вы выстроите потоки обмена, зависит от того, какие устройства вы планируете предоставить Google в общий доступ.
В следующих сценариях мы рекомендуем выполнять шаги в указанном порядке. Это поможет обеспечить пользователям более комфортный опыт использования.
Вы производите только устройства Matter
Вы производите устройства с поддержкой Matter, которые хотите внедрить в Google Home.
Вызовите API разрешений на Android .
Вызовите API-интерфейс Commissioning на Android на каждом устройстве Matter , ранее подключенном к другой фабрике.
- Поскольку совместное использование Matter должно осуществляться для каждого устройства индивидуально, а также существует множество экранов, требующих ввода данных пользователем, мы рекомендуем вам провести пользователя через этот процесс следующим образом:
- Предоставление пользователям списка устройств Matter, данные о которых не передаются в Google.
- Предоставление пользователям возможности начать процесс совместного использования устройств (с использованием API-интерфейса Commissioning) путем нажатия на устройства в этом списке.
- Возвращаемся к списку устройств Matter, показываем пользователю ход выполнения задачи и статус общего доступа.
- Поскольку совместное использование Matter должно осуществляться для каждого устройства индивидуально, а также существует множество экранов, требующих ввода данных пользователем, мы рекомендуем вам провести пользователя через этот процесс следующим образом:
Вы создаете только устройства, совместно используемые с Google, с использованием API Cloud-to-Cloud.
Выполните глубокое связывание Cloud-to-cloud . Это добавит устройства в график Google Home .
- Мы рекомендуем сначала выполнить связывание Cloud-to-cloud чтобы избежать потенциально запутанных ситуаций, когда пользователю предоставляется список устройств, используемых совместно с Google, и устройств, не используемых совместно с Google.
Вызовите API разрешений на Android .
Вы производите устройства как Cloud-to-cloud, так и Matter.
Выполнять глубокое связывание Cloud-to-cloud .
- Мы рекомендуем сначала выполнить связывание Cloud-to-cloud чтобы избежать потенциально запутанных ситуаций, когда пользователю предоставляется список устройств, используемых совместно с Google, и устройств, не используемых совместно с Google.
Вызовите API разрешений на Android .
Вызовите API-интерфейс Commissioning для Android на каждом устройстве Matter , ранее подключенном к другой фабрике.
- Поскольку совместное использование Matter должно осуществляться для каждого устройства индивидуально, а также существует множество экранов, требующих ввода данных пользователем, мы рекомендуем вам провести пользователя через этот процесс следующим образом:
- Предоставление пользователям списка устройств Matter, данные о которых не передаются в Google.
- Предоставление пользователям возможности начать процесс совместного использования устройств (с использованием API-интерфейса Commissioning) путем нажатия на устройства в этом списке.
- Возвращаемся к списку устройств Matter, показываем пользователю ход выполнения задачи и статус общего доступа.
- Поскольку совместное использование Matter должно осуществляться для каждого устройства индивидуально, а также существует множество экранов, требующих ввода данных пользователем, мы рекомендуем вам провести пользователя через этот процесс следующим образом:
У вас нет устройств, которыми вы могли бы поделиться с Google.
Вызовите API разрешений .
Лучшие практики UX
В этом разделе содержатся некоторые важные этапы взаимодействия с пользователем, которые следует учитывать при разработке приложения с использованием API Home.
Где в приложении реализовать функцию совместного использования устройств
Это не исчерпывающий список, и вы можете найти другие возможности для своевременной презентации Google Home и обмена опытом для своих пользователей.
Они также не являются взаимоисключающими, и существует несколько точек входа:
Из меню настроек

Поскольку пользователи, вероятно, привыкли настраивать соединения со своими экосистемами Google Home с помощью меню настроек, этот метод позволяет им продолжать использовать эту парадигму.
Возможно, вам стоит разделить совместное использование устройств (связь Cloud-to-cloud и API Matter Commissioning) и предоставление разрешений приложениям (API Permissions). Это позволит пользователям контролировать выполняемые ими действия, а вам — отображать пользователю статус подключения.
При использовании устройств в системах автоматизации, управляемых Google
На вкладке «Автоматизация» пользователи могут нажать на точку входа в поток обмена, прочитать экран ценностного предложения, в котором четко объясняются преимущества продвижения вперед, а затем быстро перейти к потоку разрешений.


Только с момента ввода в эксплуатацию
Этот сценарий в первую очередь подходит для партнёров, которые производят только устройства Matter (не устройства Cloud-to-cloud ) и не имеют собственной фабрики Matter . Точка входа для пользователя может располагаться сразу после стандартного экрана, где общий доступ к устройствам Matter (через API Commissioning) и предоставление разрешений приложению (через API Permissions) являются частью одного и того же пользовательского интерфейса.


Совместное использование логики
Вот некоторые предложения относительно подсказок для пользователей:
Как правило, следует предлагать пользователям выполнить только те шаги, которые недостают для подключения к платформе. Например, постоянные клиенты могут уже использовать устройства OEM-производителя совместно с Google, и в этом случае им достаточно будет пройти процедуру предоставления разрешений Home API, чтобы предоставить приложению доступ к своему Google Home.
Несколько администраторов Google Home могут совместно использовать структуру Google Home, и в некоторых случаях для совместного использования устройств с Google может использоваться только одна учётная запись. В результате, установление связи Cloud-to-cloud не должно быть обязательным условием для запроса разрешений Home API.
Предложения по визуальному дизайну

Явное преимущество подключения к Google Home (например, «Создание расширенных функций автоматизации на базе Google Home» или «Управление устройствами с помощью приложений по вашему выбору»).
Призыв к действию (например, «Начать») и возможность отмены, если пользователь не хочет продолжать.
Если позволяет место, объясните, что будет происходить по мере перемещения пользователя по экранам.
В Matter , если пользователь ранее предоставил вам доступ к своему дому через Home API, вы можете разрешить Google Home совместно использовать устройства в его доме при вводе в эксплуатацию новых. Например, вы можете добавить устройство Matter в свою систему, а затем предложить пользователю добавить это устройство в систему Google.
Предложения по содержанию
Пользователям проще доверять тому, что они понимают, и это добавляет ценности. Предоставьте пользователям информацию для принятия обоснованных решений, включая компромиссы.
Критический шаг
Пользователи не будут продолжать совместное использование устройств, если для этого не будет весомого ценностного предложения.
- Обратите особое внимание на то, как вы позиционируете предложение.
- Сделайте предложение заманчивым, но не обещайте слишком многого.
- Если пользователю необходимо устройство, упомянутое в вашем предложении, убедитесь, что об этом четко сказано, чтобы он не столкнулся с неожиданным препятствием.
- У вас может быть только одна возможность привлечь этих пользователей, поэтому не упустите ее.
Лучшие практики
- Начните с точки зрения пользователя — с подхода «что я получу от этого?».
- Не пишите более четырёх строк текста в блоке раздела. Больше слов может отвлечь внимание пользователя. Однако ясность и понимание могут быть важнее краткости.
- Автоматизация — это увлекательно! Выберите интересный, но полезный пример, если позволяет место.
- Постарайтесь говорить игривым тоном и в шутку, если это соответствует вашей общей стратегии.
- Используйте действенные фразы, например «Начните».