Giản đồ về đặc điểm cảm biến sự hiện diện của nhà thông minh

action.devices.traits.OccupancySensing – Đặc điểm này thuộc về những thiết bị có thể phát hiện sự hiện diện, cho dù thông qua PIR, siêu âm hay cảm biến tiếp xúc vật lý.

ATTRIBUTE của thiết bị

Những thiết bị có đặc điểm này có thể báo cáo những điều sau trong thao tác SYNC. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem Thực hiện ý định.

Thuộc tính Loại Mô tả
occupancySensorConfiguration Mảng

Danh sách các đối tượng, mỗi đối tượng đều chứa loại cảm biến cùng độ trễ và ngưỡng sự kiện có liên quan.
[item, ...] Đối tượng

Một loại cảm biến, độ trễ và ngưỡng sự kiện có liên quan (nếu có).
occupancySensorType String

Bắt buộc.

Các giá trị được hỗ trợ:

PIR
Thiết bị này hỗ trợ tính năng cảm biến phát hiện người trong nhà thông qua cảm biến hồng ngoại thụ động (PIR).
ULTRASONIC
Thiết bị này hỗ trợ tính năng cảm biến có người ở nhà thông qua công nghệ cảm biến bằng sóng siêu âm.
PHYSICAL_CONTACT
Thiết bị này hỗ trợ tính năng nhận biết sự hiện diện trong phòng thông qua tính năng nhận biết tiếp xúc vật lý.
occupiedToUnoccupiedDelaySec Số nguyên

Thể hiện độ trễ thời gian (tính bằng giây) trước khi số người lưu trú được báo cáo chuyển sang trạng thái không có người sau sự kiện phát hiện gần nhất.
unoccupiedToOccupiedDelaySec Số nguyên

Thể hiện độ trễ thời gian (tính bằng giây) trước khi số người lưu trú được báo cáo chuyển thành trạng thái kín phòng sau sự kiện được phát hiện gần đây nhất. Bắt buộc nếu bạn đã đặt occupiedToUnoccupiedDelaySec.
unoccupiedToOccupiedEventThreshold Số nguyên

Chỉ định số lượng sự kiện phát hiện phải diễn ra trong khoảng thời gian unoccupiedToOccupiedDelaySec trước khi số người lưu trú được báo cáo thay đổi thành trạng thái đã lưu trú. Bắt buộc nếu bạn đã đặt unoccupiedToOccupiedDelaySec.

Ví dụ

Cảm biến có người hỗ trợ cảm biến PIR và siêu âm.

{
  "occupancySensorConfiguration": [
    {
      "occupancySensorType": "PIR",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    },
    {
      "occupancySensorType": "ULTRASONIC",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    }
  ]
}

Thiết bị STATES

Đối tượng có đặc điểm này có thể báo cáo những nội dung sau các trạng thái trong thao tác QUERY. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem Thực hiện ý định.

Tiểu bang Loại Mô tả
occupancy String

Bắt buộc.

Cho biết liệu thiết bị có phát hiện thấy có người ở nhà hay không.

Các giá trị được hỗ trợ:

OCCUPIED
Thiết bị phát hiện có người ở nhà.
UNOCCUPIED
Thiết bị không phát hiện thấy có người trong nhà.
UNKNOWN_OCCUPANCY_STATE
Không xác định được trạng thái kín phòng hiện tại mà thiết bị phát hiện được.

Ví dụ

Cảm biến có phát hiện thấy có người trong văn phòng không?

{
  "occupancy": "OCCUPIED"
}

lệnh của thiết bị

Không có.

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.