Giản đồ đặc điểm cảm biến tình trạng có người ở trong 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 tình trạng có người ở, cho dù là thông qua cảm biến hồng ngoại chuyển động, siêu âm hay cảm biến tiếp xúc vật lý.

Thuộc tính thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thực hiện thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần 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 chứa loại cảm biến và độ trễ và ngưỡng sự kiện liên quan.
[item, ...] Đối tượng

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

Bắt buộc.

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

PIR
Thiết bị hỗ trợ tính năng cảm biến số người hiện diện thông qua cảm biến hồng ngoại thụ động (PIR).
ULTRASONIC
Thiết bị hỗ trợ tính năng phát hiện tỷ lệ kín phòng thông qua cảm biến siêu âm.
PHYSICAL_CONTACT
Thiết bị hỗ trợ tính năng nhận biết số người hiện diện thông qua cảm biến 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 tình trạng sử dụng được báo cáo thay đổi thành trạng thái không có người sử dụng sau sự kiện được phát hiện gần đây nhất.
unoccupiedToOccupiedDelaySec Số nguyên

Thể hiện độ trễ thời gian (tính bằng giây) trước khi tình trạng sử dụng được báo cáo thay đổi thành trạng thái có người sử dụ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 xảy ra trong khoảng thời gian unoccupiedToOccupiedDelaySec trước khi tình trạng sử dụng được báo cáo thay đổi thành trạng thái đã sử dụng. Bắt buộc nếu bạn đặt unoccupiedToOccupiedDelaySec.

Ví dụ

Cảm biến vị trí hỗ trợ cảm biến hồng ngoại và cảm biến siêu âm.

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

Trạng thái thiết bị

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

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

Bắt buộc.

Cho biết thiết bị có cảm nhận được có người hay không.

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

OCCUPIED
Thiết bị phát hiện có người trong nhà.
UNOCCUPIED
Thiết bị không phát hiện thấy có người trong nhà.
UNKNOWN_OCCUPANCY_STATE
Trạng thái hiện tại của thiết bị phát hiện thấy có người trong nhà hay không.

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ó.

LỖI thiết bị

Xem danh sách đầy đủ lỗi và ngoại lệ.