CameraClipPreview 스키마
Nest Doorbell (배터리)
sdm.devices.traits.CameraClipPreview
이 트레잇은 클립 미리보기의 다운로드를 지원하는 모든 기기에 속합니다.
필드
이 트레잇에 사용할 수 있는 필드가 없습니다.
명령어
이 트레잇에 사용할 수 있는 명령어가 없습니다.
이벤트
ClipPreview
동영상 클립을 미리 볼 수 있습니다.
클립 미리보기는 mp4 형식의 10프레임 동영상 파일입니다. mp4 동영상 파일을 표시하도록 선택하거나, 전체 10프레임 시퀀스를 표시하기 위해 파일을 다른 형식 (예: 애니메이션 GIF)으로 트랜스코딩할 수 있습니다. 클립 미리보기 방법을 선택할 때는 기기 클라이언트 기능을 고려해야 합니다.
이 이벤트는 다음 이벤트에 지원됩니다.
유형 | 요소 | 설명 |
---|---|---|
이벤트 | CameraMotion 트레잇의 Motion 이벤트 | 카메라가 움직임을 감지했습니다. |
이벤트 | CameraPerson 트레잇의 Person 이벤트 | 카메라가 사람을 감지했습니다. |
이벤트 | DoorbellChime 트레잇의 Chime 이벤트 | 초인종을 눌렀습니다. |
eventSessionId
를 사용하여 이 이벤트와 관련 previewUrl
를 하나 이상의 지원되는 이벤트와 연결하세요.
ClipPreview 이벤트
페이로드
{ "eventId" : "3e97e0c3-abe9-4fbe-9321-0f41582fe7af",
"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 예: '3e97e0c3-abe9-4fbe-9321-0f41582fe7af' |
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 오류 코드의 전체 목록입니다.