Схема CameraMotion

Nest Cam (legacy) Nest Cam (outdoor or indoor, battery) Nest Cam with floodlight Nest Cam (indoor, wired) Nest Hub Max Nest Doorbell (legacy) Nest Doorbell (battery) Nest Doorbell (wired)

sdm.devices.traits.CameraMotion

Эта функция присуща любому устройству, поддерживающему обнаружение движения.

Поля

Для этого признака нет доступных полей.

Команды

Для этого признака нет доступных команд.

События

Движение

Обновляемый

Камера зафиксировала движение.

Это событие поддерживает обновляемые уведомления. Существующие уведомления приложения, созданные на основе этого события, могут быть обновлены с использованием содержимого последующего события с тем же eventThreadId .

Событие движения

Полезная нагрузка 

{
  "eventId" : "c9b6b21d-c842-462c-af10-96fd8bdfe43b",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraMotion.Motion" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "YrsIUTNlRtIU7X9Sjh51Iutojt...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Поля событий движения

Поле Описание Тип данных
eventSessionId Nest Doorbell (battery) Nest Doorbell (wired) An ID given to events occurring as part of a single session of related events. May be used for consolidating events.

Use it to associate this event with the related ClipPreview event of the CameraClipPreview trait.

 string
Пример: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Cam (legacy) Nest Hub Max Nest Doorbell (legacy) An ID associated with the event.

Use it with the GenerateImage command to download the camera image related to this event.

 string
Пример: "YrsIUTNlRtIU7X9Sjh51Iutojt..."

Поля полезной нагрузки события

Поле Описание Тип данных
eventId Уникальный идентификатор мероприятия. string
Пример: "c9b6b21d-c842-462c-af10-96fd8bdfe43b"
timestamp Время, когда произошло событие. string
Пример: "2019-01-01T00:00:01Z"
resourceUpdate Объект, содержащий подробную информацию об обновлении ресурса. object
userId Уникальный, зашифрованный идентификатор, представляющий пользователя. string
Пример: «AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi»
eventThreadId Обновляемый. Уникальный идентификатор потока событий. string
Пример: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Обновляемый поток событий. string
Значения: "НАЧАЛО", "ОБНОВЛЕНО", "ЗАВЕРШЕНО"
resourceGroup Объект, указывающий на ресурсы, которые могут иметь аналогичные обновления для данного события. Ресурс самого события (из объекта resourceUpdate ) всегда будет присутствовать в этом объекте. object

Более подробную информацию о различных типах мероприятий и порядке их проведения можно найти в разделе «Мероприятия» .

Ошибки

В связи с этим признаком могут быть возвращены следующие коды ошибок:

Сообщение об ошибке РПК Поиск неисправностей
Camera image is no longer available for download. DEADLINE_EXCEEDED Event images expire 30 seconds after the event is published. Make sure to download the image prior to expiration.
Идентификатор события не относится к камере. FAILED_PRECONDITION Use the correct eventID returned by the camera event.

Полный список кодов ошибок API см. в Справочнике кодов ошибок API.