CameraPerson 스키마

sdm.devices.traits.CameraPerson

이 트레잇은 사람 감지 이벤트를 지원하는 모든 기기에 속합니다.

필드

이 트레잇에 사용할 수 있는 필드가 없습니다.

명령어

이 트레잇에 사용할 수 있는 명령어가 없습니다.

이벤트

인물

업데이트 가능 

카메라에 사람이 감지되었습니다.

이 이벤트는 업데이트 가능한 알림을 지원합니다. 이 이벤트에서 만든 기존 앱 알림은 동일한 eventThreadId가 있는 후속 이벤트의 콘텐츠를 사용하여 업데이트할 수 있습니다.

인물 활동

페이로드

{
  "eventId" : "914a826c-8b1f-4ff9-8b53-a2b92a945cd2",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "9Uk0BSbGbYySSeq4b4LOXni1fb...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

사용자 이벤트 필드

필드 설명 데이터 유형
eventSessionId Nest Doorbell (배터리) Nest Doorbell (유선) 단일 세션의 일부로 발생하는 이벤트에 부여되는 ID 확인할 수 있습니다. 이벤트 통합에 사용할 수 있습니다.

이를 사용하여 이 이벤트를 CameraClipPreview 트레잇의 관련 ClipPreview 이벤트와 연결합니다.

 string
예: 'CjY5Y3VKaTZwR3o4Y19YbTVfMF...'
eventId Nest Cam (기존) Nest Hub Max Nest Doorbell (기존)  이벤트와 연결된 ID입니다.

GenerateImage 명령어와 함께 사용하여 이 이벤트와 관련된 카메라 이미지를 다운로드합니다.

 string
예: '9Uk0BSbGbYySSeq4b4LOXni1fb...'

이벤트 페이로드 필드

필드 설명 데이터 유형
eventId 이벤트의 고유 식별자입니다. string
예: '914a826c-8b1f-4ff9-8b53-a2b92a945cd2'
timestamp 이벤트가 발생한 시간입니다. string
예: '2019-01-01T00:00:01Z'
resourceUpdate 리소스 업데이트에 관한 세부정보를 포함하는 객체입니다. object
userId 사용자를 나타내는 고유한 난독화된 식별자입니다. string
예: 'AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi'
eventThreadId 업데이트 가능 이벤트 스레드의 고유 식별자입니다. string
예: 'd67cd3f7-86a7-425e-8bb3-462f92ec9f59'
eventThreadState 업데이트 가능 이벤트 스레드의 상태입니다. string
값: 'STARTED', 'UPDATED', 'ENDED'
resourceGroup 이 이벤트와 유사한 업데이트가 있을 수 있는 리소스를 나타내는 객체입니다. resourceUpdate 객체에서 이벤트 자체의 리소스는 항상 이 객체에 표시됩니다. object

다른 유형에 대한 자세한 내용은 이벤트를 참조하세요. 이벤트 유형과 그 작동 방식을 배웁니다.

오류

이 트레잇과 관련하여 다음과 같은 오류 코드가 반환될 수 있습니다.

오류 메시지 RPC 문제 해결
카메라 이미지를 더 이상 다운로드할 수 없습니다. DEADLINE_EXCEEDED 이벤트 이미지는 이벤트가 게시된 후 30초 후에 만료됩니다. 만료되기 전에 이미지를 다운로드해야 합니다.
카메라에 속하지 않은 활동 ID입니다. FAILED_PRECONDITION 카메라 이벤트에서 반환된 올바른 eventID를 사용합니다.

API 오류 코드 참조에서 API 오류 코드의 전체 목록입니다.