Отчет о состоянии

Report State — важная функция, которая позволяет Home Action заблаговременно сообщать о последнем статусе устройства пользователя обратно в Google Home Graph rather than waiting for a QUERY intent.

Report State сообщает Google о состоянии пользовательских устройств со связанным с ними указанным agentUserId (отправленным в исходном запросе SYNC ). Google Assistant wants to take an action that requires understanding the current state of a device, it can simply look up the state information in the Home Graph instead of issuing a QUERY intent to various third-party clouds prior to issuing the EXECUTE intent.

Без Report State , учитывая освещение от нескольких поставщиков в гостиной, команда Ok Google, сделайте мою гостиную ярче требует разрешения нескольких запросов QUERY , отправленных в несколько облаков, в отличие от простого поиска текущих значений яркости на основе того, что было ранее сообщено. . Для наилучшего взаимодействия с пользователем Assistant должен иметь текущее состояние устройства, не требуя обращения к устройству туда и обратно.

После первоначальной SYNC для устройства платформа отправляет намерение QUERY , которое собирает состояние устройства для заполнения Home Graph . После этого Home Graph сохраняет только состояние, отправленное с помощью Report State .

При вызове Report State убедитесь, что предоставлены полные данные о состоянии для данного типажа. Home Graph обновляет состояния для каждого признака и перезаписывает все данные для этого признака при выполнении вызова Report State . Например, если вы сообщаете о состоянии для типажа StartStop , полезная нагрузка должна включать значения как для isRunning , так и isPaused .

Начать

Чтобы реализовать Report State , выполните следующие действия:

• Включить Google HomeGraph API
• Создайте ключ служебной учетной записи
• Вызов API

Включить Google HomeGraph API

1. В Google Cloud Console , go to the HomeGraph API page.

   Перейдите на страницу API HomeGraph.
2. Выберите проект, который соответствует вашему smart home project ID.
3. Щелкните ВКЛЮЧИТЬ .

Создайте ключ служебной учетной записи

Следуйте этим инструкциям, чтобы сгенерировать ключ сервисного аккаунта из Google Cloud Console :

1. В Google Cloud Console перейдите на страницу создания ключа сервисного аккаунта .

   Перейдите на страницу создания ключа сервисной учетной записи.
2. В списке Учетная запись службы выберите Новая учетная запись службы .
3. В поле Имя учетной записи службы введите имя.
4. В поле Идентификатор учетной записи службы введите идентификатор.

5. В списке Роли выберите Учетные записи служб > Создатель токена учетной записи службы .

6. Для Типа ключа выберите вариант JSON .

7. Щелкните Создать . Файл JSON, содержащий ваш ключ, загружаемый на ваш компьютер.

Вызов API

Выберите вариант на вкладках ниже:

const homegraphClient = homegraph({
  version: 'v1',
  auth: new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/homegraph'
  })
});

const res = await homegraphClient.devices.reportStateAndNotification({
  requestBody: {
    agentUserId: 'PLACEHOLDER-USER-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        states: {
          "PLACEHOLDER-DEVICE-ID": {
            on: true
          }
        }
      }
    }
  }
});
    

  // Get Application Default credentials.
  GoogleCredentials credentials =
      GoogleCredentials.getApplicationDefault()
          .createScoped(List.of("https://www.googleapis.com/auth/homegraph"));

  // Create Home Graph service client.
  HomeGraphService homegraphService =
      new HomeGraphService.Builder(
              GoogleNetHttpTransport.newTrustedTransport(),
              GsonFactory.getDefaultInstance(),
              new HttpCredentialsAdapter(credentials))
          .setApplicationName("HomeGraphExample/1.0")
          .build();

  // Build device state payload.
  Map<?, ?> states = Map.of("on", true);

  // Report device state.
  ReportStateAndNotificationRequest request =
      new ReportStateAndNotificationRequest()
          .setRequestId("PLACEHOLDER-REQUEST-ID")
          .setAgentUserId("PLACEHOLDER-USER-ID")
          .setPayload(
              new StateAndNotificationPayload()
                  .setDevices(
                      new ReportStateAndNotificationDevice()
                          .setStates(Map.of("PLACEHOLDER-DEVICE-ID", states))));
  homegraphService.devices().reportStateAndNotification(request);
}
    

Состояние отчета о тестировании

Чтобы подготовить действие к сертификации, важно протестировать Report State .

Для этого мы рекомендуем использовать инструмент Home Graph Viewer, который представляет собой автономное веб-приложение, не требующее загрузки или развертывания.

Панель мониторинга Report State по-прежнему доступна, но она устарела и больше не поддерживается.

Информационная панель состояния отчета

Предпосылки

Прежде чем вы сможете протестировать свое действие, вам потребуется ключ учетной записи службы и ваш agentUserId . Если у вас уже есть ключ сервисной учетной записи и agentUserId см. Развертывание панели мониторинга Report State .

Разверните панель мониторинга состояния отчета

Получив ключ учетной записи службы и идентификатор пользователя агента для своего проекта, загрузите и разверните последнюю версию с панели мониторинга Report State . После загрузки последней версии следуйте инструкциям из прилагаемого файла README.MD .

После того, как вы развернули панель мониторинга Report State , получите доступ к панели мониторинга по следующему URL-адресу (замените your_project_id идентификатором вашего проекта):

http://<your-project-id>.appspot.com

На приборной панели сделайте следующее:

• Выберите файл ключа вашей учетной записи
• Добавьте свой AgentUserId

Затем щелкните Список .

Все ваши устройства перечислены. После заполнения списка вы можете использовать кнопку «Обновить» , чтобы обновить состояния устройства. При изменении состояния устройства строка выделяется зеленым цветом.

Ответы на ошибки

При вызове Report State вы можете получить один из следующих ответов об ошибке. Эти ответы приходят в виде кодов состояния HTTP.

• 400 Bad Request — сервер не смог обработать запрос, отправленный клиентом, из-за неправильного синтаксиса . Общие причины включают искаженный формат JSON или использование null вместо "" для строкового значения.
• 404 Not Found — запрошенный ресурс не может быть найден, но может быть доступен в будущем. Как правило, это означает, что мы не можем найти запрошенное устройство. Это также может означать, что учетная запись пользователя не связана с Google или мы получили недопустимый agentUserId . Убедитесь, что agentUserId соответствует значению, указанному в вашем ответе SYNC , и вы правильно обрабатываете намерения DISCONNECT .