В этом руководстве приведены рекомендации по разработке удобного интерфейса для настройки разрешений и общего доступа к устройствам в вашем приложении с помощью Google Home API.
В этой статье рассматриваются следующие темы:
- Зачем делиться устройствами с Google Home?
- Основные этапы предоставления доступа
- Технические требования
- Рекомендации по UX
Зачем предоставлять доступ к устройствам в Google Home?
Чтобы пользоваться возможностями Home API, пользователям нужно предоставить Google Home доступ к своим устройствам. Вот почему это необходимо:
- Это техническое требование для использования устройств в автоматизациях Google.
- Это помогает поддерживать стабильную и гибкую работу Google Home.
- Чтобы пользователям не приходилось переключаться между приложениями для выполнения простых задач, устройства должны быть представлены одинаково во всех приложениях, использующих Home API.
Основные компоненты процесса предоставления доступа
| Компонент | Программа | Описание |
|---|---|---|
| Permissions API на устройствах Android; | Home API для разрешений на Android | Запрашивает у пользователей разрешения для вашего приложения. Чтобы использовать Home API, приложению требуется разрешение на доступ к устройствам в доме пользователя (в API они называются структурой). Однако порядок выполнения этого шага зависит от сценария разработчика и описан в разделе Техническая реализация. |
| Связывание облачных сервисов | Cloud-to-cloud для связывания аккаунтов | Позволяет начать процесс связывания аккаунтов, чтобы делиться подключенными к облаку устройствами с Google Home из вашего приложения. Чтобы пользователям было удобнее, рекомендуем использовать функцию ссылки на контент (доступна как на Android, так и на iOS), которая перенаправляет пользователей непосредственно на вашу страницу связывания аккаунтов в GHA. |
| Commissioning API на Android | Ввод в эксплуатацию Matter | Хотя обычно этот API используется для ввода в эксплуатацию новых устройств Matter, вы также можете использовать его для добавления сети Google к устройствам Matter, которые уже были введены в эксплуатацию в другой сети. Поэтому это полезный инструмент для процесса адаптации. |
Техническая реализация
Способ создания потоков обмена зависит от того, какими устройствами вы планируете делиться с Google.
В следующих сценариях мы рекомендуем выполнять действия в указанном порядке. Это помогает сделать сайт более удобным для пользователей.
Вы производите только устройства Matter.
Вы производите устройства с поддержкой Matter и хотите, чтобы их можно было добавлять в Google Home.
Вызовите Permissions API на Android.
Вызовите Commissioning API на Android для каждого устройства Matter, ранее введенного в эксплуатацию в другой сети.
- Поскольку доступ к Matter нужно предоставлять для каждого устройства отдельно и для этого требуется выполнить много действий, рекомендуем помочь пользователю:
- Предоставление пользователям списка устройств Matter, которые не передаются Google.
- Разрешить пользователям начинать процесс предоставления доступа к устройству (с помощью Commissioning API), нажимая на устройства в этом списке.
- Возврат к списку устройств Matter, в котором показан ход выполнения задачи и статус предоставления доступа.
- Поскольку доступ к Matter нужно предоставлять для каждого устройства отдельно и для этого требуется выполнить много действий, рекомендуем помочь пользователю:
Вы производите только устройства, которые передают данные в Google через Cloud-to-Cloud API.
Добавьте ссылки на контент в Cloud-to-cloud. Устройства будут добавлены в Google Home Graph.
- Рекомендуем сначала выполнить связывание Cloud-to-cloud, чтобы избежать путаницы, например когда пользователю показывается список, содержащий устройства, доступ к которым предоставлен Google, и устройства, доступ к которым не предоставлен Google.
Вызовите Permissions API на Android.
Вы производите устройства, совместимые с Matter и Cloud-to-cloud.
Добавьте ссылки на контент в Cloud-to-cloud.
- Рекомендуем сначала выполнить связывание Cloud-to-cloud, чтобы избежать путаницы, например когда пользователю показывается список, содержащий устройства, доступ к которым предоставлен Google, и устройства, доступ к которым не предоставлен Google.
Вызовите Permissions API на Android.
Вызовите Commissioning API для Android на каждом устройстве Matter, ранее введенном в эксплуатацию в другой сети.
- Поскольку доступ к Matter нужно предоставлять для каждого устройства отдельно и для этого требуется выполнить много действий, рекомендуем помочь пользователю:
- Предоставление пользователям списка устройств Matter, которые не передаются Google.
- Разрешить пользователям начинать процесс предоставления доступа к устройству (с помощью Commissioning API), нажимая на устройства в этом списке.
- Возврат к списку устройств Matter, в котором показан ход выполнения задачи и статус предоставления доступа.
- Поскольку доступ к Matter нужно предоставлять для каждого устройства отдельно и для этого требуется выполнить много действий, рекомендуем помочь пользователю:
У вас нет устройств, которыми можно поделиться с Google.
Вызовите Permissions API.
Рекомендации по улучшению интерфейса
В этом разделе описаны некоторые критически важные пути пользователей, которые следует учитывать при разработке приложения с использованием Home API.
Где в приложении рассказать о предоставлении доступа к устройству
Это неполный список, и вы можете найти другие возможности для своевременного предложения Google Home и обмена опытом для ваших пользователей.
Эти варианты не исключают друг друга, и есть несколько точек входа:
В меню настроек
Пользователи привыкли настраивать подключения к экосистемам Google Home через меню настроек, поэтому этот способ позволяет им продолжать использовать эту парадигму.
Вы можете разделить предоставление доступа к устройству (Cloud-to-cloud связывание и Matter Commissioning API) и разрешения для приложения (Permissions API). Это дает пользователям возможность контролировать, какие шаги они выполняют, и дает вам возможность отображать пользователю статус подключения.
При использовании устройств в автоматизациях, запущенных Google
На вкладке "Автоматизация" пользователи могут нажать на точку входа в процесс предоставления доступа, прочитать на экране ценностного предложения о преимуществах продолжения и быстро пройти процесс предоставления разрешений.
Только из ввода в эксплуатацию
Этот сценарий в основном предназначен для партнеров, которые производят только устройства Matter (без устройств Cloud-to-cloud) и не имеют собственной сети Matter. Точка входа для пользователя может находиться сразу после экрана, на котором предлагается предоставить доступ к устройствам Matter (через Commissioning API) и разрешения для приложения (через Permissions API).
Логика предоставления доступа
Вот несколько советов по составлению запросов:
Как правило, пользователям нужно предлагать выполнить только недостающие шаги, необходимые для регистрации на платформе. Например, постоянные клиенты могут уже делиться устройствами OEM с Google. В этом случае им нужно только пройти процесс предоставления разрешений Home API, чтобы дать приложению доступ к своему Google Home.
Несколько администраторов Google Home могут использовать одну структуру Google Home, и в некоторых случаях только один аккаунт может использоваться для предоставления доступа к устройствам Google. Поэтому завершение связывания с Cloud-to-cloud не должно быть обязательным условием для запроса разрешений Home API.
Рекомендации по визуальному дизайну
Четко сформулированное преимущество интеграции с Google Home, например "Создавайте сложные автоматизации на базе Google Home" или "Управляйте устройствами с помощью приложений по своему выбору".
Призыв к действию (например, "Начать") и возможность отмены, если пользователь не хочет продолжать.
Если позволяет место, объясните, что будет происходить по мере того, как пользователь будет переходить от экрана к экрану.
В частности, если пользователь ранее предоставил вам доступ к своему дому через Home API, вы можете разрешить ему делиться устройствами в доме с Google Home при вводе в эксплуатацию новых устройств.Matter Например, вы можете добавить устройство Matter в свою сеть, а затем предложить пользователю добавить его в сеть Google.
Предлагаемый контент
Пользователям проще доверять тому, что они понимают и что приносит им пользу. Предоставляйте пользователям информацию, которая поможет им принимать взвешенные решения, в том числе о компромиссах.
Критический шаг
Пользователи не будут делиться устройствами, если не увидят в этом выгоды.
- Обратите особое внимание на то, как вы позиционируете предложение.
- Сделайте его привлекательным, но не обещайте слишком много.
- Если для использования вашего продукта требуется устройство, упомянутое в презентации, обязательно укажите это, чтобы пользователь не столкнулся с неожиданным препятствием.
- У вас может быть только одна возможность привлечь этих пользователей, поэтому не упустите ее.
Рекомендации
- Начните с точки зрения пользователя – подхода "что в этом для меня?".
- Не пишите больше четырех строк контента в блоке раздела. Если слов будет больше, пользователь может потерять интерес. Однако ясность и понимание могут быть важнее краткости.
- Автоматизация – это здорово! Если позволяет место, выберите интересный, но полезный пример.
- Если это соответствует вашей стратегии, попробуйте использовать игривый тон.
- Используйте фразы, побуждающие к действию, например "Начать".