Giản đồ CameraPerson

Nest Cam (phiên bản cũ) Nest Cam (ngoài trời hoặc trong nhà, dùng pin) Nest Cam có đèn rọi Nest Cam (trong nhà, có dây) Nest Hub Max Nest Doorbell (phiên bản cũ) Nest Doorbell (dùng pin) Nest Doorbell (có dây) 

sdm.devices.traits.CameraPerson

Đặc điểm này thuộc về mọi thiết bị hỗ trợ sự kiện phát hiện người.

Trường

Không có trường nào cho đặc điểm này.

Lệnh

Không có lệnh nào dùng được cho đặc điểm này.

Sự kiện

Người

Có thể cập nhật 

Camera phát hiện thấy một người.

Sự kiện này hỗ trợ thông báo có thể cập nhật. Bạn có thể cập nhật thông báo ứng dụng hiện có được tạo từ sự kiện này bằng cách sử dụng nội dung của một sự kiện tiếp theo có cùng eventThreadId.

Sự kiện người

Dung lượng

{
  "eventId" : "d9a2b0e9-8578-46f8-899a-d741975d1c5b",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "QKlbpmRJYrfkoK3vyiiLoUuNry...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Trường sự kiện về người

Trường Mô tả Loại dữ liệu
eventSessionId Nest Doorbell (pin) Nest Doorbell (có dây) Mã nhận dạng được cấp cho các sự kiện xảy ra trong một phiên của các sự kiện liên quan. Có thể dùng để hợp nhất các sự kiện.

Sử dụng thuộc tính này để liên kết sự kiện này với sự kiện ClipPreview có liên quan của thuộc tính CameraClipPreview.

 string
Ví dụ: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Cam (phiên bản cũ) Nest Hub Max Nest Doorbell (phiên bản cũ) Mã nhận dạng được liên kết với sự kiện.

Sử dụng mã này với lệnh GenerateImage để tải hình ảnh máy ảnh liên quan đến sự kiện này.

 string
Ví dụ: "QKlbpmRJYrfkoK3vyiiLoUuNry..."

Trường tải trọng sự kiện

Trường Mô tả Loại dữ liệu
eventId Giá trị nhận dạng duy nhất của sự kiện. string
Ví dụ: "d9a2b0e9-8578-46f8-899a-d741975d1c5b"
timestamp Thời gian xảy ra sự kiện. string
Ví dụ: "2019-01-01T00:00:01Z"
resourceUpdate Một đối tượng cung cấp thông tin chi tiết về nội dung cập nhật tài nguyên. object
userId Giá trị nhận dạng duy nhất, được làm rối mã nguồn đại diện cho người dùng. string
Ví dụ: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId Có thể cập nhật Giá trị nhận dạng duy nhất của luồng sự kiện. string
Ví dụ: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Có thể cập nhật Trạng thái của luồng sự kiện. string
Giá trị: "STARTED" (BẮT ĐẦU), "UPDATED" (CẬP NHẬT), "ENDED" (KẾT THÚC)
resourceGroup Một đối tượng cho biết các tài nguyên có thể có nội dung cập nhật tương tự như sự kiện này. Tài nguyên của chính sự kiện (từ đối tượng resourceUpdate) sẽ luôn có trong đối tượng này. object

Hãy xem phần Sự kiện để biết thêm thông tin về các loại sự kiện và cách hoạt động của chúng.

Lỗi

(Các) mã lỗi sau đây có thể được trả về liên quan đến đặc điểm 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 chụp bằng máy ảnh xuống nữa. DEADLINE_EXCEEDED Hình ảnh sự kiện sẽ hết hạn 30 giây sau khi sự kiện được xuất bản. Hãy nhớ tải hình ảnh xuống trước khi hết hạn.
Mã sự kiện không thuộc về máy ảnh. FAILED_PRECONDITION Sử dụng đúng eventID do sự kiện máy ảnh 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.