Hướng dẫn về cảm biến nhà thông minh

action.devices.types.SENSOR – Một cảm biến có thể thực hiện nhiều chức năng, chẳng hạn như theo dõi cả nhiệt độ và độ ẩm. Cảm biến có thể báo cáo cả hai hoặc một trong hai loại thông tin đo lường định lượng (ví dụ: nồng độ cacbon monoxit và khói đo được theo phần triệu) và định tính (chẳng hạn như chất lượng không khí có tốt cho sức khoẻ hay không).

Loại này cho biết thiết bị nhận được biểu tượng Cảm biến và một số từ đồng nghĩa cũng như biệt hiệu liên quan.

Khả năng của thiết bị

Hãy tham khảo tài liệu về đặc điểm tương ứng để biết thông tin chi tiết về việc triển khai, chẳng hạn như các thuộc tính và trạng thái mà dịch vụ của bạn phải hỗ trợ, cũng như cách tạo phản hồi EXECUTE và QUERY.

Bạn nên sử dụng những đặc điểm này nếu thiết bị của bạn có. Tuy nhiên, bạn có thể tự do kết hợp các đặc điểm hiện có để phù hợp nhất với chức năng sản phẩm hiện tại.

Cảm biến cũng có thể sử dụng các đặc điểm khác liên quan đến dữ liệu mà cảm biến có thể báo cáo, chẳng hạn như:

Ví dụ về thiết bị: Cảm biến đơn giản

Phần này chứa các ví dụ về tải trọng ý định đại diện cho một "Cảm biến" phổ biến dựa trên loại thiết bị và đặc điểm ở trên. Nếu bạn thêm hoặc xoá các đặc điểm trong quá trình triển khai, hãy sửa đổi các phản hồi cho phù hợp để phản ánh những thay đổi đó.

Phản hồi SYNC mẫu

Yêu cầu
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Câu trả lời
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.SENSOR",
        "traits": [
          "action.devices.traits.EnergyStorage",
          "action.devices.traits.OccupancySensing",
          "action.devices.traits.SensorState"
        ],
        "name": {
          "name": "Simple sensor"
        },
        "willReportState": true,
        "attributes": {
          "sensorStatesSupported": [
            {
              "name": "AirQuality",
              "descriptiveCapabilities": {
                "availableStates": [
                  "healthy",
                  "moderate",
                  "unhealthy",
                  "very unhealthy"
                ]
              }
            }
          ],
          "queryOnlyEnergyStorage": true,
          "occupancySensorConfiguration": [
            {
              "occupancySensorType": "PIR",
              "occupiedToUnoccupiedDelaySec": 10,
              "unoccupiedToOccupiedDelaySec": 10,
              "unoccupiedToOccupiedEventThreshold": 2
            }
          ]
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

Phản hồi mẫu của hàm QUERY

Yêu cầu
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Câu trả lời
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "currentSensorStateData": [
          {
            "name": "AirQuality",
            "currentSensorState": "healthy"
          }
        ],
        "descriptiveCapacityRemaining": "HIGH",
        "capacityRemaining": [
          {
            "unit": "PERCENTAGE",
            "rawValue": 90
          }
        ],
        "occupancy": "OCCUPIED"
      }
    }
  }
}

LỖI thiết bị

Xem danh sách đầy đủ các lỗi và trường hợp ngoại lệ.