![Nest Hub Max](https://developers.google.cn/nest/device-access/images/device-hub-max.png?authuser=6&hl=ko)
Google Nest Hub Max 디스플레이 Smart Device Management (SDM) API에서 지원됩니다. 이 기기는 기기 유형을 반환합니다. /DISPLAY:
sdm.devices.types.DISPLAY
Google Nest Hub Max에는 카메라와 동일하게 작동하는 카메라가 있습니다. 카메라 기기 유형입니다.
특성
참조
이 기기와 관련된 특성, 명령어 또는 이벤트는 다음과 같습니다.
특성 | 설명 | 명령어 | 이벤트 |
---|---|---|---|
CameraEventImage | 이 트레잇은 이벤트에서 이미지 생성을 지원하는 모든 기기에 속합니다. | GenerateImage | |
CameraImage | 이 트레잇은 이미지 촬영을 지원하는 모든 기기에 속합니다. | ||
CameraLiveStream | 이 트레잇은 라이브 스트리밍을 지원하는 모든 기기에 속합니다. | GenerateRtspStream ExtendRtspStream StopRtspStream | |
CameraMotion | 이 트레잇은 움직임 감지 이벤트를 지원하는 모든 기기에 속합니다. | 모션 | |
CameraPerson | 이 트레잇은 사람 감지 이벤트를 지원하는 모든 기기에 속합니다. | 사람 | |
CameraSound | 이 트레잇은 소리 감지 이벤트를 지원하는 모든 기기에 속합니다. | 소리 | |
정보 | 이 트레잇은 기기 관련 정보를 위한 모든 기기에 속합니다. |
JSON
GET 응답에 트레잇이 없다는 것은 트레잇이 현재 기기에서 사용할 수 없는 기능입니다. 자세한 내용은 자세한 내용은 기기 유형을 참조하세요. 확인할 수 있습니다
{ "type" : "sdm.devices.types.DISPLAY", "traits" : { "sdm.devices.traits.CameraEventImage" : {}, "sdm.devices.traits.CameraImage" : { "maxImageResolution" : { "width" : 1280, "height" : 960 } }, "sdm.devices.traits.CameraLiveStream" : { "maxVideoResolution" : { "width" : 640, "height" : 480 }, "videoCodecs" : ["H264"], "audioCodecs" : ["AAC"], "supportedProtocols" : ["WEB_RTC"] }, "sdm.devices.traits.CameraMotion" : {}, "sdm.devices.traits.CameraPerson" : {}, "sdm.devices.traits.CameraSound" : {}, "sdm.devices.traits.Info" : { "customName" : "My device" } } }
카메라 이벤트 처리
디스플레이 기기 유형에서 다음 이벤트가 트리거될 수 있습니다.유형 | 요소 | 설명 |
---|---|---|
이벤트 | CameraMotion 트레잇의 Motion 이벤트 | 카메라가 움직임을 감지했습니다. |
이벤트 | CameraPerson 트레잇의 Person 이벤트 | 카메라가 사람을 감지했습니다. |
이벤트 | CameraSound trait의 Sound 이벤트 | 카메라에서 소리가 감지되었습니다. |
페이로드
{ "eventId" : "e5efc212-2b66-454c-8a17-ea2302586547",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraMotion.Motion
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "KYp0O88IrEB6lMnbADZLkjqcYN...", } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
eventId
이 포함되어 있으며 이는
GenerateImage
명령어와 함께 사용하면 됩니다 이 명령어는 관련 카메라 이미지의 다운로드 URL을
이벤트를 사용합니다.
요청
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraEventImage.GenerateImage
",
"params" : {
"eventId" : "fbFikofb9nWN1onMhn1tgwcIwI..."
}
}
응답
{ "results" : { "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "token" : "g.0.eventToken" } }
카메라 이미지 다운로드하기
다음에서 url
에 GET 호출을 수행합니다.
GenerateImage 명령어 응답
기본 승인과 함께 HTTP 승인 헤더에 token
를 사용하여
카메라 이미지를 다운로드합니다.
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...
width
또는 height
쿼리 매개변수를 사용하여
다운로드한 이미지 이 매개변수 중 하나만 지정하면 됩니다. 다른
매개변수는 카메라의 가로세로 비율에 따라 자동으로 조정됩니다.
예를 들어 카메라의 가로세로 비율이 4:3인 경우, 카메라 이미지를 다운로드하려면 해상도 480x360인 경우 너비 또는 높이를 지정합니다.
너비
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480
높이
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360
다운로드 URL에는 다음과 같은 제한사항이 적용됩니다.
- 두 매개변수가 모두 URL에 제공되는 경우
width
가 사용되며height
무시됩니다. - 어떤 매개변수도 URL에 제공되지 않은 경우
width
다음 CameraImage 특성을 참고하세요. 이미지 속성 정보
라이브 스트림 이용
카메라의 라이브 스트림에 액세스할 수 있습니다. 다음 스트림 형식은 지원되는 기기:
- RTSP
카메라 및 지원되는 스트림 형식의 전체 목록은 다음을 참고하세요. 지원되는 기기
라이브 스트림에 액세스하려면 적절한 GenerateFormat스트림을 사용하세요. 명령어를 CameraLiveStream 특성입니다.
RTSP
RTSP 스트림의 경우
CameraLiveStream 트레잇 명령어의 GenerateRtspStream 명령어
는 스트림 URL 및 관련 streamToken
를 반환합니다.
요청
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream
",
"params" : {}
}
응답
{ "results" : { "streamUrls" : { "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken" }, "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "streamToken" : "g.0.streamingToken", "expiresAt" : "2018-01-04T18:30:00.000Z" } }
그런 다음 스트림 URL을 사용하여 카메라 라이브 스트림에 액세스합니다.
rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken
RTSP 라이브 스트림 URL은 클라이언트 간에 공유할 수 없습니다. 스트림 URL은 한 번에 한 클라이언트에서만 사용할 수 있습니다. 여러 클라이언트가 동일한 카메라에서 동시에 스트리밍하려는 경우 각 클라이언트에 대해 RTSP 명령을 전송해야 하며 개별 클라이언트는 자체 스트림 URL을 사용해야 합니다.
라이브 스트림 연장하기
카메라 라이브 스트림 세션은 5분 동안만 유효합니다. 라이브 스트림의 전체 기간을 연장해야 하는 경우 생성한 스트림 형식에 맞는 CameraLiveStream 속성의 적절한 '스트림 확장' 명령어를 사용하세요.Format
RTSP
RTSP 스트림을 확장하려면
CameraLiveStream trait 명령어의 ExtendRtspStream 명령어를 사용하여
새 streamExtensionToken
및 streamToken
다운로드
값:
요청
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraLiveStream.ExtendRtspStream
",
"params" : {
"streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
}
}
응답
{ "results" : { "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "streamToken" : "g.0.newStreamingToken", "expiresAt" : "2018-01-04T18:30:00.000Z" } }
새 값으로 스트림 URL을 업데이트하면 라이브 스트림:
rtsps://someurl.com/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?auth=g.0.newStreamingToken
라이브 스트림 중지
카메라 라이브 스트림을 더 이상 사용하지 않을 때는 라이브 스트림을 중단하고 스트림을 무효화합니다. 그러려면 적절한 중지Format스트림을 사용합니다. 명령어를 CameraLiveStream 트레잇을 설정합니다.
RTSP
RTSP 스트림을 중지하려면 토큰을 사용하여 CameraLiveStream 트레잇 명령어의 StopRtspStream 명령어를 사용합니다.
요청
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream
",
"params" : {
"streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
}
}
응답
{}
오류
이 기기와 관련하여 다음 오류 코드가 반환될 수 있습니다.
오류 메시지 | RPC | 문제 해결 |
---|---|---|
카메라 이미지를 더 이상 다운로드할 수 없습니다. | DEADLINE_EXCEEDED |
이벤트 이미지는 이벤트가 게시된 후 30초 후에 만료됩니다. 만료되기 전에 이미지를 다운로드해야 합니다. |
카메라에 속하지 않은 활동 ID입니다. | FAILED_PRECONDITION |
카메라 이벤트에서 반환된 올바른 eventID 를 사용합니다. |
API 오류 코드 참조에서 API 오류 코드의 전체 목록입니다.