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