Màn hình

Màn hình Google Nest Hub Max được hỗ trợ trong API Smart Device Management (SDM). Thiết bị này trả về loại thiết bị là DISPLAY:

sdm.devices.types.DISPLAY

Google Nest Hub Max có camera hoạt động giống như loại thiết bị CAMERA.

Đặc điểm tính cách

{
  "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"
    }
  }
}

Xử lý sự kiện camera

{
  "eventId" : "f39b35b7-21ba-4cf4-bbf0-5d36b21b345d",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraMotion.Motion" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "hkDG-nDge7SgosWYto0eOCLQeQ...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "Xza0fN83xY5p88UNrpa-Bx55Hh..."
  }
}

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

Tải hình ảnh camera xuống

Thực hiện lệnh gọi GET đến url từ phản hồi lệnh GenerateImage, sử dụng token trong tiêu đề Uỷ quyền HTTP bằng cách uỷ quyền Cơ bản để tải hình ảnh camera xuống:

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...

Sử dụng các tham số truy vấn width hoặc height để tuỳ chỉnh độ phân giải của hình ảnh đã tải xuống. Bạn chỉ cần chỉ định một trong các tham số này. Tham số còn lại sẽ tự động được điều chỉnh theo tỷ lệ khung hình của camera.

Ví dụ: nếu tỷ lệ khung hình của camera là 4:3, để tải hình ảnh camera xuống với độ phân giải 480 x 360, hãy chỉ định chiều rộng hoặc chiều cao:

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

Áp dụng các hạn chế khác đối với URL tải xuống:

• Nếu cả hai tham số đều được cung cấp trong URL, thì width sẽ được sử dụng và height sẽ bị bỏ qua.
• Nếu không có tham số nào được cung cấp trong URL, thì giá trị mặc định là 480 sẽ được chọn cho width.

Hãy xem đặc điểm CameraImage để biết thông tin về các thuộc tính của hình ảnh.

Truy cập vào sự kiện phát trực tiếp

Bạn có thể truy cập vào sự kiện phát trực tiếp từ camera. Các định dạng luồng sau đây được hỗ trợ cho thiết bị này:

• RTSP

Để xem danh sách đầy đủ các camera và định dạng luồng được hỗ trợ, hãy xem Thiết bị được hỗ trợ.

Để truy cập vào sự kiện phát trực tiếp, hãy sử dụng lệnh GenerateFormatStream thích hợp của đặc điểm CameraLiveStream.

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"
  }
}

rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken

Mở rộng sự kiện phát trực tiếp

Phiên phát trực tiếp của camera chỉ có hiệu lực trong 5 phút. Nếu bạn cần kéo dài thời gian hoạt động của sự kiện phát trực tiếp, hãy sử dụng lệnh ExtendFormatStream thích hợp của CameraLiveStream đặc điểm cho định dạng luồng mà bạn đã tạo.

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"
  }
}

rtsps://someurl.com/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?auth=g.0.newStreamingToken

Dừng sự kiện phát trực tiếp

Bất cứ khi nào bạn không còn sử dụng sự kiện phát trực tiếp của camera, bạn nên dừng và vô hiệu hoá luồng đó. Để làm như vậy, hãy sử dụng lệnh StopFormatStream thích hợp của đặc điểm CameraLiveStream cho định dạng luồng mà bạn đã tạo.

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

{}

Lỗi

Bạn có thể nhận được(các) mã lỗi sau đây liên quan đến thiết bị này:

Hãy xem Tài liệu tham khảo về mã lỗi API để biết danh sách đầy đủ các mã lỗi API.