Hướng dẫn làm mềm nước cho nhà thông minh
action.devices.types.WATERSOFTENER – Máy làm mềm nước là các thiết bị có thể bật và tắt, cho biết độ sạch của bộ lọc nước và tuổi thọ của bộ lọc, đồng thời được điều chỉnh theo nhiều chế độ cài đặt.
Loại này cho biết thiết bị sẽ thấy biểu tượng Làm mềm nước cùng một số từ đồng nghĩa và tên đại diện có 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ề cách 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 cần hỗ trợ cũng như cách tạo các phản hồi EXECUTE và QUERY.
Trait được đề xuất
Bạn nên sử 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ể tuỳ ý kết hợp và so khớp từ tất cả các đặc điểm có sẵn sao cho phù hợp nhất với chức năng sản phẩm hiện có.
Yêu cầu về chất lượng
- Độ trễ: phải nhỏ hơn hoặc bằng 800 mili giây.
- Độ tin cậy: phải lớn hơn hoặc bằng 97%.
Thiết bị ví dụ: Máy làm mềm nước đơn giản
Phần này chứa các tải trọng ý định mẫu đại diện cho một "Thiết bị làm mềm nước" thông thường, dựa trên loại thiết bị và các đặc điểm nêu trên. Nếu bạn thêm hoặc xoá đặ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
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.WATERSOFTENER",
"traits": [
"action.devices.traits.OnOff",
"action.devices.traits.SensorState"
],
"name": {
"name": "Simple water softener"
},
"willReportState": true,
"attributes": {
"sensorStatesSupported": [
{
"name": "FilterCleanliness",
"descriptiveCapabilities": {
"availableStates": [
"clean",
"dirty",
"needs replacement"
]
}
}
]
},
"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,
"on": true,
"currentSensorStateData": [
{
"name": "FilterCleanliness",
"currentSensorState": "clean"
}
]
}
}
}
}
Lệnh EXECUTE mẫu
OnOff
Để biết thêm thông tin chi tiết về các tham số lệnh, hãy xem tài liệu tham khảo về
action.devices.traits.OnOff.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}