CameraPerson 스키마

Nest Cam(기존) Nest Cam(실외용 또는 실내용, 배터리) Nest Cam(투광등 번들) Nest Cam(실내용, 유선) Nest Hub Max Nest Doorbell(기존) Nest Doorbell(배터리) Nest Doorbell(유선) 

sdm.devices.traits.CameraPerson

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

필드

이 특성에 사용할 수 있는 필드가 없습니다.

명령어

이 특성에 사용할 수 있는 명령어가 없습니다.

이벤트

사람

업데이트 가능 

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

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

사람의 활동

페이로드

{
  "eventId" : "2b16ac0a-6477-494e-b7e2-790ec1c46b85",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "1rMqbtBm0jjUaUhN0aVfqj02vU...",
      }
    }
  }
  "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
예: '1rMqbtBm0jjUaUhN0aVfqj02vU...'

이벤트 페이로드 필드

필드 설명 데이터 유형
eventId 이벤트의 고유 식별자입니다. string
예: '2b16ac0a-6477-494e-b7e2-790ec1c46b85'
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 오류 코드 참조를 확인하세요.