Местное выполнение заказов

Local Home SDK улучшает интеграцию умного дома с Google Ассистентом, добавляя локальный путь выполнения для маршрутизации намерений умного дома.

Local Home SDK предоставляет две возможности: локальное выполнение и локальный запрос.

  • Локальное выполнение позволяет выполнять команды, отправляя EXEC интенты по локальному пути выполнения, а не вызывая Cloud API. Например, запрос "Включи свет" может быть обработан локально.
  • Локальный запрос позволяет обрабатывать запросы о состоянии устройства, отправляя интенты QUERY по локальному пути выполнения. Например, Local Query может выполнить запрос "Включен ли свет?" без вызова Cloud API.

С помощью SDK вы можете написать приложение для локального выполнения на TypeScript или JavaScript, которое содержит бизнес-логику вашего умного дома. Устройства Google Home или устройства Google Nest могут загружать и запускать ваше приложение на устройстве. Приложение напрямую взаимодействует с вашими умными устройствами по Wi-Fi в локальной вычислительной сети (LAN), чтобы выполнять команды пользователя по существующим протоколам.

Интеграция SDK повышает эффективность интеграции Cloud-to-cloud, в том числе снижает задержку и повышает надежность. Локальное выполнение поддерживается для всех типов и характеристик устройств, кроме тех, которые используют дополнительную верификацию пользователя.

Начать разработку Попробовать пример

Как это работает

После получения ответа SYNC от облачного сервиса платформа Local Home сканирует локальную вычислительную сеть пользователя с помощью mDNS, UDP-трансляции или UPnP, чтобы обнаружить умные устройства, подключенные к Ассистенту.

Платформа отправляет намерение IDENTIFY, чтобы определить, можно ли управлять устройством локально. Для этого она сравнивает идентификатор устройства в ответе IDENTIFY с идентификаторами, возвращенными в предыдущем ответе SYNC. Если обнаруженное устройство является хабом или мостом, платформа отправляет намерение REACHABLE_DEVICES и рассматривает хаб как прокси-устройство для локального обмена данными.

Получив ответ, подтверждающий наличие локального устройства, платформа устанавливает локальный путь выполнения для устройства Google Home или устройства Google Nest пользователя, а затем направляет команды пользователя для локального выполнения.

Когда пользователь запускает интеграцию Cloud-to-cloud с локальным путем выполнения, Ассистент отправляет интент EXECUTE или интент QUERY на устройство Google Home или устройство Google Nest, а не в облако. Затем устройство запускает приложение для локального выполнения, чтобы обработать намерение.

На этом рисунке показан процесс выполнения локального выполнения. Путь выполнения фиксирует намерение пользователя с телефона с Google Ассистентом, затем намерение пользователя обрабатывается Google Cloud, затем оно выполняется локально на устройстве Google Home, и команда отправляется непосредственно в концентратор устройства или непосредственно на устройство. Облако разработчика доступно в качестве резервного.
Рисунок 1. Добавление локального пути выполнения для действия умного дома.

Платформа Local Home не определяет, какое устройство Google Home или устройство Google Nest должно выполнить команду. Намерения EXECUTE и QUERY могут поступать от любого устройства Google Home или устройства Google Nest, определенного в той же структуре Home Graph, что и целевое устройство.

Приложение для выполнения заказов на местном уровне

Приложение для локального выполнения содержит бизнес-логику, которая позволяет обрабатывать намерения, отправленные платформой Local Home, и получать доступ к умному устройству через локальную вычислительную сеть. Для интеграции локального выполнения не требуется модификация оборудования. Приложение выполняет запросы на интеграцию с Cloud-to-cloud, отправляя команды управления на умное устройство через протоколы прикладного уровня, включая HTTP, TCP или UDP. Если локальное выполнение не удастся, будет использоваться облачное.

Для поддержки создания приложения Local Home SDK предоставляет два основных класса:

  • DeviceManager предоставляет методы для взаимодействия с умными устройствами с помощью сокетов TCP, UDP или HTTP-запросов.
  • App предоставляет методы для подключения обработчиков намерений, которые Google отправляет после обнаружения устройств с локальным управлением (IDENTIFY, REACHABLE_DEVICES). Этот класс также выполняет команды пользователя (EXECUTE) и отвечает на запросы о текущем состоянии устройства (QUERY).

В процессе разработки вы можете создавать и тестировать приложение, загружая его на собственный сервер хостинга или локальный компьютер для разработки. В рабочей среде Google размещает ваше приложение в защищенной изолированной среде JavaScript на устройстве Google Home или Google Nest пользователя.

Report State API в настоящее время не поддерживается для локального выполнения. Для обработки этих запросов Google использует ваше облачное выполнение.

Жизненный цикл приложения

Ваше приложение для локального выполнения загружается по запросу, когда платформа Local Home обнаруживает новые локальные устройства, соответствующие конфигурации сканирования проекта, или имеет ожидающие намерения, связанные с ранее идентифицированным устройством.

Устройства Google Home и Google Nest имеют ограниченный объем памяти, и ваше приложение для локального выполнения может быть закрыто в любой момент из-за нехватки памяти в системе. Это может произойти, если приложение начинает потреблять слишком много памяти или если системе нужно освободить место для другого приложения. Платформа Local Home перезапускает приложение, только когда есть новые намерения для доставки и достаточно ресурсов памяти для запуска приложения.

Платформа Local Home выгружает приложение после тайм-аута бездействия, когда пользователь отменяет связь со своим аккаунтом или когда больше нет устройств, поддерживающих локальное выполнение, связанных с agentUserId пользователя.

Поддерживаемые устройства

Платформа Local Home выполняет ваше приложение для локального выполнения на поддерживаемых устройствах Google Home или Google Nest. В таблице ниже перечислены поддерживаемые устройства и среда выполнения, используемая на каждом из них. Подробнее о требованиях к среде выполнения…

Устройство Тип Среда
Google Home Озвучивающий Chrome
Google Home Mini Озвучивающий Chrome
Google Home Max Озвучивающий Chrome
Nest Mini Озвучивающий Chrome
Nest Hub Экран Chrome
Nest Hub Max Экран Chrome
Nest Wifi Маршрутизатор Node.js
Точка Chrome

Среда выполнения

Среда выполнения для вашего локального приложения зависит от вашего устройства. Платформа Local Home поддерживает следующие среды выполнения:

  • Chrome Приложение для локального выполнения запускается в контексте браузера Chrome window версии M80 или более поздней с поддержкой ECMAScript версии ES2018.
  • Node.js Ваше приложение для локального выполнения запускается как скрипт в процессе Node.js, работающем в Node v10.x LTS или более поздней версии с поддержкой ECMAScript версии ES2018.

Структура исходного кода

Рекомендуем объединить зависимости в один файл JavaScript, используя конфигурации сборщика, которые предоставляет Local Home SDK, и упаковать исходный код в виде немедленно вызываемой функции (IIFE).

Путь реализации

Чтобы использовать Local Home SDK для интеграции умного дома, вам необходимо выполнить следующие задачи:

1 Настройте конфигурацию сканирования Настройте Google Home Developer Console с параметрами, необходимыми для того, чтобы Ассистент мог обнаруживать устройства, которыми можно управлять локально.
2 Обновите ответ SYNC в облачном выполнении В облачном выполнении измените обработчик запросов SYNC, чтобы он поддерживал поле otherDeviceIds, которое платформа использует для создания локального пути выполнения. В этом поле укажите идентификаторы устройств, которыми можно управлять локально.
3 Реализуйте приложение для локального выполнения Используйте Local Home SDK, чтобы создать приложение JavaScript для обработки намерений IDENTIFY, EXECUTE и QUERY. Для прокси-устройств, таких как хабы и мосты, также нужно обрабатывать намерение REACHABLE_DEVICES.
4 Тестирование и отладка приложения Протестируйте интеграцию или пройдите самостоятельную сертификацию с помощью набора тестов Google Home.

Подготовка