CameraClipPreview 스키마

Nest Doorbell (배터리) Nest Doorbell (유선) 

sdm.devices.traits.CameraClipPreview

이 트레잇은 클립 미리보기 다운로드를 지원하는 모든 기기에 속합니다.

필드

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

명령어

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

이벤트

ClipPreview

동영상 클립을 미리 볼 수 있습니다.

클립 미리보기는 mp4 형식의 10프레임 동영상 파일입니다. mp4 동영상 파일을 표시하도록 선택하거나, 전체 10프레임 시퀀스를 표시하기 위해 파일을 다른 형식 (예: 애니메이션 gif)으로 트랜스코딩할 수 있습니다. 클립 미리보기 방법을 선택할 때는 기기 클라이언트 기능을 고려해야 합니다.

이 이벤트는 다음 이벤트에 대해 지원됩니다.

유형 요소 설명
이벤트 CameraMotion 트레잇의 Motion 이벤트 카메라가 움직임을 감지했습니다.
이벤트 CameraPerson 트레잇의 Person 이벤트 카메라가 사람을 감지했습니다.
이벤트 DoorbellChime 트레잇의 Chime 이벤트 초인종을 눌렀습니다.
eventSessionId를 사용하여 이 이벤트와 관련 previewUrl를 하나 이상의 지원되는 이벤트와 연결하세요.

ClipPreview 이벤트

페이로드

{
  "eventId" : "1049fe69-8e1d-4381-ad42-c7f32a90d1af",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraClipPreview.ClipPreview" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "previewUrl" : "https://previewUrl/..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

ClipPreview 이벤트 필드

필드 설명 데이터 유형
eventSessionId 단일 세션의 일부로 발생하는 이벤트에 제공되는 ID입니다. 확인할 수 있습니다. 이벤트를 통합하는 데 사용할 수 있습니다. string
예: 'CjY5Y3VKaTZwR3o4Y19YbTVfMF...'
previewUrl 동영상 클립을 미리 볼 수 있는 URL입니다. 기본 동영상 코덱은 H264 string
예: 'https://previewUrl/...'

이벤트 페이로드 필드

필드 설명 데이터 유형
eventId 이벤트의 고유 식별자입니다. string
예: '1049fe69-8e1d-4381-ad42-c7f32a90d1af'
timestamp 이벤트가 발생한 시간입니다. string
예: '2019-01-01T00:00:01Z'
resourceUpdate 리소스 업데이트에 대한 정보를 자세히 설명하는 객체입니다. object
userId 사용자를 나타내는 난독화된 고유한 식별자입니다. string
예: 'AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi'
resourceGroup 이 이벤트와 유사한 업데이트가 있을 수 있는 리소스를 나타내는 객체입니다. resourceUpdate 객체에서 이벤트 자체의 리소스는 항상 이 객체에 표시됩니다. object

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

클립 미리보기

클립을 미리 보려면 HTTP 승인 헤더에서 OAuth 액세스 토큰을 사용하여 previewUrl에 GET 호출을 수행합니다.

미리보기

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

오류

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