Giản đồ đặc điểm SensorState của nhà thông minh

action.devices.traits.SensorState – Đặc điểm này bao gồm cả phép đo định lượng và trạng thái định tính.

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 hoạt động 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ả
sensorStatesSupported Mảng

Bắt buộc.

Mỗi đối tượng đại diện cho các chức năng trạng thái cảm biến mà thiết bị cụ thể này hỗ trợ. Mỗi cảm biến phải có ít nhất một chức năng mô tả hoặc số. Cảm biến cũng có thể báo cáo cả hai, trong trường hợp này, giá trị số sẽ được ưu tiên.
[item, ...] Đối tượng

Các chức năng cảm biến được hỗ trợ.

Yêu cầu phải có ít nhất 1 mục.
name String

Bắt buộc.

Loại cảm biến được hỗ trợ. Xem bảng Cảm biến được hỗ trợ.
descriptiveCapabilities Đối tượng

Nội dung mô tả về các chức năng của cảm biến.
availableStates Mảng

Bắt buộc.

Danh sách các trạng thái có sẵn cho thiết bị. Trạng thái "không xác định" được hỗ trợ ngầm khi cảm biến không trả về giá trị.
[item, ...] String

Giá trị trạng thái mô tả được hỗ trợ.

Yêu cầu phải có ít nhất 1 mục.
numericCapabilities Đối tượng

Mô tả các giá trị số có thể có mà cảm biến có thể báo cáo.
rawValueUnit String

Bắt buộc.

Đơn vị số được hỗ trợ.

Hãy xem phần Cảm biến được hỗ trợ để biết thêm thông tin chi tiết về các tính năng và loại cảm biến mà đặc điểm này hỗ trợ.

Ví dụ

Thiết bị cảm biến báo cáo giá trị trạng thái mô tả.

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

Thiết bị cảm biến báo cáo giá trị trạng thái dạng số.

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

Thiết bị cảm biến báo cáo giá trị trạng thái mô tả và dạng số.

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

Cảm biến được hỗ trợ

Các bảng sau đây liệt kê các loại cảm biến được hỗ trợ và các chức năng liên quan.

Chất lượng không khí

Tên Khả năng mô tả Khả năng số

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

AirQuality

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

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

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

AQI

Khí CO

Tên Khả năng mô tả Khả năng số

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

CarbonMonoxideLevel

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

carbon monoxide detected
high
no carbon monoxide detected
unknown

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

PARTS_PER_MILLION

Nồng độ khói

Tên Khả năng mô tả Khả năng số

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

SmokeLevel

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

smoke detected
high
no smoke detected
unknown

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

PARTS_PER_MILLION

Độ sạch của bộ lọc

Tên Khả năng mô tả Khả năng số

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

FilterCleanliness

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

clean
dirty
needs replacement
unknown
 Không được hỗ trợ.

Rò rỉ nước

Tên Khả năng mô tả Khả năng số

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

WaterLeak

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

leak
no leak
unknown
 Không được hỗ trợ.

Phát hiện mưa

Tên Khả năng mô tả Khả năng số

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

RainDetection

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

rain detected
no rain detected
unknown
 Không được hỗ trợ.

Tuổi thọ của bộ lọc

Tên Khả năng mô tả Khả năng số

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

FilterLifeTime

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

new
good
replace soon
replace now
unknown

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

PERCENTAGE

Tuổi thọ của bộ lọc đã tính toán

Tên Khả năng mô tả Khả năng số

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

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
 Không được hỗ trợ.

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

PERCENTAGE

Nồng độ CO2

Tên Khả năng mô tả Khả năng số

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

CarbonDioxideLevel
 Không được hỗ trợ.

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

PARTS_PER_MILLION

Bụi mịn

Tên Khả năng mô tả Khả năng số

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

PM2.5
PM10
 Không được hỗ trợ.

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

MICROGRAMS_PER_CUBIC_METER

Hợp chất hữu cơ dễ bay hơi

Tên Khả năng mô tả Khả năng số

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

VolatileOrganicCompounds
 Không được hỗ trợ.

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

PARTS_PER_MILLION

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ả
currentSensorStateData Mảng

Bắt buộc.

Danh sách trạng thái cảm biến hiện tại.
[item, ...] Đối tượng

Trạng thái cảm biến hiện tại.
name String

Bắt buộc.

Tên trạng thái cảm biến. Trùng khớp với một giá trị trong sensorStatesSupported.
currentSensorState String

Giá trị trạng thái mô tả hiện tại. Trùng khớp với một giá trị trong sensorStatesSupported.
rawValue Number

Giá trị cảm biến dạng số hiện tại.
alarmState String

Trạng thái chuông báo tương ứng với chỉ số cảm biến hiện tại. Chuông báo trước hoặc chuông báo có thể được kích hoạt khi kết quả đo lường của cảm biến tiến đến và đạt đến mức nguy hiểm.

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

IDLE
Chuông báo ở trạng thái rảnh; mức phát hiện không nguy hiểm.
PRE_ALARM_1
Mức phát hiện được đã tăng nhưng chưa đạt đến mức khẩn cấp; mức này có thể sớm trở nên nguy hiểm.
PRE_ALARM_2
Nếu thiết bị hỗ trợ nhiều cảnh báo trước khi đạt đến cấp độ khẩn cấp, thì điều này cho biết các cấp độ phát hiện cao hơn PRE_ALARM_1; các cấp độ này đang tiếp tục tăng và có thể sớm đạt đến cấp độ khẩn cấp.
ALARM
Mức phát hiện đã đạt đến mức khẩn cấp và chuông báo đã được kích hoạt.
alarmSilenceState String

Cho biết trạng thái tắt tiếng cho chuông báo của cảm biến, bao gồm cả việc liệu hiện có cho phép tắt tiếng chuông báo đang hoạt động hay không. Trạng thái này có thể được cung cấp khi trạng thái báo trước hoặc báo động đang hoạt động.

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

ALLOWED
Chuông báo không bị tắt tiếng và hiện được phép tắt tiếng.
DISALLOWED
Chuông báo không bị tắt tiếng và hiện không được phép tắt tiếng chuông báo.
SILENCED
Đã tắt chuông báo.

Hãy xem phần Cảm biến được hỗ trợ để biết thêm thông tin chi tiết về các tính năng và loại cảm biến mà đặc điểm này hỗ trợ.

Ví dụ

Thiết bị cảm biến báo cáo giá trị trạng thái mô tả.

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

Thiết bị cảm biến báo cáo giá trị trạng thái dạng số.

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

Thiết bị cảm biến báo cáo giá trị trạng thái mô tả và dạng số.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

Thiết bị cảm biến báo cáo giá trị trạng thái mô tả và dạng số, đồng thời cho biết chuông báo đang hoạt động.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "DISALLOWED"
    }
  ]
}

LỆNH của thiết bị

Không có.

THÔNG BÁO trên thiết bị

Các thiết bị có đặc điểm này có thể trả về tải trọng thông báo sau đây trong quá trình thay đổi trạng thái thiết bị. Để tìm hiểu thêm về cách triển khai thông báo, hãy xem bài viết Thông báo cho Hành động nhà thông minh.

Trường Loại Mô tả
SensorState Đối tượng

Bắt buộc.

Gói dữ liệu thông báo.
priority Số nguyên

Bắt buộc.

Biểu thị cấp độ thông báo. Giá trị hiện được hỗ trợ là 0, cho biết thông báo sẽ được đọc to.
name String

Bắt buộc.

Tên trạng thái cảm biến. Xem danh sách các loại cảm biến được hỗ trợ cho thông báo.
currentSensorState String

Bắt buộc.

Giá trị trạng thái mô tả hiện tại. Xem danh sách các loại cảm biến được hỗ trợ cho thông báo.

Tải trọng thông báo có thể chứa các loại cảm biến sau:

  • AirQuality
  • CarbonMonoxideLevel
  • SmokeLevel
  • FilterCleanliness
  • WaterLeak
  • RainDetection
  • FilterLifeTime

Hãy xem phần Cảm biến được hỗ trợ để biết thêm thông tin chi tiết về các chức năng mà từng loại cảm biến hỗ trợ.

Ví dụ

Thiết bị phát hiện thấy khói.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

LỖI thiết bị

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