Giản đồ đặc điểm cảm biến trạng thái cảm biến của nhà thông minh

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

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ả
sensorStatesSupported	Mảng	Bắt buộc. Mỗi đối tượng đại diện cho các chức năng của 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 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 đó, giá trị số sẽ được ưu tiên.
[item, ...]	Đối tượng	Các chức năng của cảm biến được hỗ trợ. Cần 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ả 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 hiện có cho thiết bị. Trường "không xác định" trạng thái đượ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ợ. Cần có ít nhất 1 mục.
numericCapabilities	Đối tượng	Mô tả các giá trị số 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 bài viết Các cảm biến được hỗ trợ để biết thêm thông tin về các loại cảm biến các chức năng và loại cảm biến mà tính năng này hỗ trợ.

Ví dụ

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

{
  "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à chức năng liên quan.

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

Tên	Khả năng mô tả	Năng lực 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ả	Năng lực 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ả	Năng lực 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ả	Năng lực 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ả	Năng lực 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ả	Năng lực 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ả	Năng lực 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ả	Năng lực 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 độ khí CO2

Tên	Khả năng mô tả	Năng lực 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ả	Năng lực 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ả	Năng lực số
Các giá trị được hỗ trợ: VolatileOrganicCompounds	Không được hỗ trợ.	Các giá trị được hỗ trợ: PARTS_PER_MILLION

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ả
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 hiện tại của cảm biến.
name	String	Bắt buộc. Tên trạng thái của cảm biến. Khớp với một giá trị từ sensorStatesSupported.
currentSensorState	String	Giá trị trạng thái mô tả hiện tại. Khớp với một giá trị từ sensorStatesSupported.
rawValue	Number	Giá trị cảm biến số hiện tại.

Hãy xem bài viết Các cảm biến được hỗ trợ để biết thêm thông tin về các loại cảm biến các chức năng và loại cảm biến mà tính năng này hỗ trợ.

Ví dụ

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

{
  "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
    }
  ]
}

lệnh của thiết bị

Không có.

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

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

Trường	Loại	Mô tả
SensorState	Đối tượng	Bắt buộc. Tải trọng thông báo.
priority	Số nguyên	Bắt buộc. Thể hiện cấp độ thông báo. Giá trị hiện được hỗ trợ là 0, cho biết rằng thông báo cần được đọc to.
name	String	Bắt buộc. Tên trạng thái của 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 bài viết Các cảm biến được hỗ trợ để biết thêm thông tin về các loại cảm biến khả năng hỗ trợ của từng loại cảm biến.

Ví dụ

phát hiện thấy khói.

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

Thiết bị ERRORS

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