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