راهنمای نرم کننده آب خانگی هوشمند
action.devices.types.WATERSOFTENER - نرمکنندههای آب دستگاههایی هستند که میتوانند روشن و خاموش شوند، میزان تمیزی فیلتر آب و طول عمر فیلتر را گزارش دهند و در حالتهای مختلف تنظیم شوند.
این نوع نشان میدهد که دستگاه نماد نرمکننده آب و برخی مترادفها و نامهای مستعار مرتبط را دریافت میکند.
قابلیتهای دستگاه
برای جزئیات پیادهسازی، مانند ویژگیها و حالتهایی که سرویس شما باید پشتیبانی کند، و نحوه ساخت پاسخهای EXECUTE و QUERY، به مستندات مربوط به ویژگیها مراجعه کنید.
ویژگیهای توصیهشده
این ویژگیها، در صورت وجود، برای دستگاه شما توصیه میشوند. با این حال، شما میتوانید تمام ویژگیهای موجود را با هم ترکیب و تطبیق دهید تا به بهترین شکل با عملکرد محصول فعلی شما مطابقت داشته باشد.
دستگاه نمونه: نرمکننده ساده آب
این بخش شامل نمونههایی از payloadهای intent است که نشاندهندهی یک "نرمکنندهی آب" رایج بر اساس نوع دستگاه و ویژگیهای بالا هستند. اگر ویژگیهایی را در پیادهسازی خود اضافه یا حذف میکنید، پاسخهای خود را متناسب با آن تغییرات تغییر دهید.
نمونه پاسخ SYNC
{
"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" } } ] } }
نمونه پاسخ QUERY
{ "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" } ] } } } }
نمونه دستورات اجرایی
روشن/خاموش
برای جزئیات بیشتر در مورد پارامترهای دستور، به مرجع 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 } } ] } }