Hướng dẫn về cảm biến trong nhà thông minh
action.devices.types.SENSOR – Một cảm biến có thể phục vụ nhiều chức năng, chẳng hạn như theo dõi cả nhiệt độ và độ ẩm. Các cảm biến có thể cho biết cả hai hoặc định lượng (ví dụ: khí CO và nồng độ khói được đo ở phần triệu) và các số liệu đị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ị có biểu tượng Cảm biến và một số từ đồng nghĩa và bí danh.
Khả năng của thiết bị
Tham khảo tài liệu về đặc điểm tương ứng cho 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 sẽ hỗ trợ cũng như cách tạo các phản hồi EXECUTE và QUERY.
Đặc điểm được đề xuất
Bạn nên dùng những đặc điểm này (nếu phù hợp với thiết bị của mình). Tuy nhiên, bạn có thể thoải mái kết hợp tất cả các đặc điểm có sẵn để phù hợp nhất với hiện tại của mình chức năng của sản phẩm.
Các cảm biến cũng có thể sử dụng các đặc điểm khác bao gồm dữ liệu mà chúng có thể báo cáo, chẳng hạn như:
Yêu cầu về chất lượng
- Độ trễ: phải nhỏ hơn hoặc bằng 1000 mili giây.
- Độ tin cậy: phải lớn hơn hoặc bằng 97%.
Thiết bị mẫu: Cảm biến đơn giản
Phần này chứa các tải trọng ý định mẫu đại diện cho một "Cảm biến" chung dựa trên loại thiết bị và đặc điểm nêu trên. Nếu bạn thêm hoặc xoá các đặc điểm trong quá trình triển khai, sửa đổi câu trả lời của bạn sao cho phù hợp để phản ánh những thay đổi đó.
Phản hồi SYNC mẫu
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"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 QUERY mẫu
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"currentSensorStateData": [
{
"name": "AirQuality",
"currentSensorState": "healthy"
}
],
"descriptiveCapacityRemaining": "HIGH",
"capacityRemaining": [
{
"unit": "PERCENTAGE",
"rawValue": 90
}
],
"occupancy": "OCCUPIED"
}
}
}
}