Trang này được dịch bởi Cloud Translation API.

Màn hình

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

sdm.devices.types.DISPLAY

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

Đặc điểm

Tài liệu tham khảo

Các đặc điểm, lệnh hoặc sự kiện sau đây có liên quan đến thiết bị này:

Đặc điểm	Mô tả	Lệnh	Sự kiện
CameraEventImage	Đặc điểm này thuộc về mọi thiết bị hỗ trợ việc tạo hình ảnh từ các sự kiện.	GenerateImage
CameraImage	Đặc điểm này thuộc về mọi thiết bị hỗ trợ chụp ảnh.
CameraLiveStream	Đặc điểm này thuộc về mọi thiết bị hỗ trợ tính năng phát trực tiếp.	GenerateRtspStream ExtendRtspStream StopRtspStream
CameraMotion	Đặc điểm này thuộc về mọi thiết bị hỗ trợ các sự kiện phát hiện chuyển động.		Chuyển động
CameraPerson	Đặc điểm này thuộc về mọi thiết bị hỗ trợ các sự kiện phát hiện người.		Người
CameraSound	Đặc điểm này thuộc về mọi thiết bị hỗ trợ các sự kiện phát hiện âm thanh.		Âm thanh
Thông tin	Đặc điểm này thuộc về mọi thiết bị để cung cấp thông tin liên quan đến thiết bị.

JSON

Nếu không có đặc điểm trong phản hồi GET, tức là đặc điểm hoặc tính năng đó hiện không dùng được cho thiết bị. Hãy xem phần Các loại thiết bị để biết thêm thông tin.

{
  "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 máy ảnh

Các sự kiện sau có thể được kích hoạt từ loại thiết bị DISPLAY:

Loại	Phần tử	Mô tả
Sự kiện	Sự kiện Chuyển động của đặc điểm CameraMotion	Camera đã phát hiện thấy chuyển động.
Sự kiện	Sự kiện Person của đặc điểm CameraPerson	Camera phát hiện thấy có người.
Sự kiện	Sự kiện Âm thanh của đặc điểm CameraSound	Camera phát hiện thấy âm thanh.

Ví dụ: camera đã phát hiện thấy chuyển động:

Phần tải

{
  "eventId" : "ccb0ca57-7608-4bf8-9d61-5c89f5c59e59",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraMotion.Motion" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "fN7xRKphnT0IFk5_GIKB-R_vm7...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Tải trọng của sự kiện này chứa một eventId có thể dùng với lệnh GenerateImage. Lệnh này trả về một URL tải xuống cho hình ảnh camera liên quan đến sự kiện:

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "bODnoyXLFUYy-S2FOSik8eR-5Q..."
  }
}

Phản hồi

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

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

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

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

Sử dụng 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 thông số này. Tham số còn lại sẽ được tự động điều chỉnh tỷ lệ 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:

Chiều rộng

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

Chiều cao

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

Các hạn chế khác đối với URL tải xuống:

Nếu bạn cung cấp cả hai tham số trong URL, thì width sẽ được dùng và height sẽ bị bỏ qua.
Nếu bạn không cung cấp cả hai tham số 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 hình ảnh.

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

Bạn có thể truy cập vào luồng phát trực tiếp của camera. Thiết bị này hỗ trợ các định dạng luồng phát sau đây:

RTSP

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

Để truy cập vào một 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ểmCameraLiveStream.

RTSP

Đối với luồng RTSP, lệnh GenerateRtspStream của lệnh đặc điểm CameraLiveStream sẽ trả về URL của luồng và streamToken có liên quan:

Yêu cầu

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

Phản hồi

{
  "results" : {
    "streamUrls" : {
      "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken"
    },
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
    "streamToken" : "g.0.streamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

Sau đó, hãy dùng URL của luồng phát để truy cập vào luồng phát trực tiếp của camera:

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

Bạn không thể chia sẻ URL phát trực tiếp RTSP giữa các ứng dụng. Mỗi lần, chỉ có một ứng dụng có thể sử dụng URL của sự kiện phát trực tiếp. Nếu nhiều ứng dụng muốn phát trực tiếp từ cùng một camera cùng một lúc, thì bạn phải gửi lệnh RTSP cho từng ứng dụng riêng lẻ và mỗi ứng dụng riêng lẻ phải sử dụng URL phát trực tiếp riêng.

Kéo dài sự kiện phát trực tiếp

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

RTSP

Để mở rộng luồng RTSP, hãy dùng lệnh ExtendRtspStream của lệnh đặc điểm CameraLiveStream để lấy các giá trị streamExtensionToken và streamToken mới:

Yêu cầu

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

Phản hồi

{
  "results" : {
    "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "streamToken" : "g.0.newStreamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

Cập nhật URL phát trực tiếp bằng các giá trị mới này để tiếp tục xem sự kiện phát trực tiếp:

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

Ngừng phát trực tiếp

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

RTSP

Để dừng luồng RTSP, hãy dùng mã thông báo để vô hiệu hoá bằng lệnh StopRtspStream của lệnh đặc điểm CameraLiveStream:

Yêu cầu

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

Phản hồi

{}

Lỗi

(Các) mã lỗi sau đây có thể được trả về liên quan đến thiết bị này:

Thông báo Lỗi	RPC	Khắc phục sự cố
Bạn không thể tải hình ảnh từ camera xuống nữa.	`DEADLINE_EXCEEDED`	Hình ảnh sự kiện sẽ hết hạn sau 30 giây kể từ khi sự kiện được xuất bản. Nhớ tải hình ảnh xuống trước khi hết hạn.
Mã sự kiện không thuộc về camera.	`FAILED_PRECONDITION`	Sử dụng `eventID` chính xác do sự kiện camera trả về.

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.

Màn hình Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Đặc điểm

Tài liệu tham khảo

JSON

Xử lý sự kiện máy ảnh

Phần tải

Yêu cầu

Phản hồi

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

Chiều rộng

Chiều cao

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

RTSP

Yêu cầu

Phản hồi

Kéo dài sự kiện phát trực tiếp

RTSP

Yêu cầu

Phản hồi

Ngừng phát trực tiếp

RTSP

Yêu cầu

Phản hồi

Lỗi

Màn hình