دليل أجهزة تيسير الماء الذكية
action.devices.types.WATERSOFTENER - أجهزة تنقية المياه هي أجهزة يمكن تشغيلها وإيقافها، ويمكنها إرسال تقارير عن نظافة فلتر المياه وعمره الافتراضي، ويمكن ضبطها على إعدادات أوضاع مختلفة.
يشير هذا النوع إلى أنّ الجهاز يحصل على رمز "منقّي المياه" وبعض المرادفات والأسماء المستعارة ذات الصلة.
إمكانات الجهاز
راجِع مستندات السمة ذات الصلة للحصول على تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تدعمها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المقترَحة
يُنصح باستخدام هذه السمات إذا كانت تنطبق على جهازك. ومع ذلك، يمكنك المزج والمطابقة بين جميع السمات المتاحة لتحقيق أفضل تطابق مع وظائف منتجك الحالية.
مثال على جهاز: جهاز بسيط لتليين المياه
يحتوي هذا القسم على أمثلة لحمولات بيانات الأهداف التي تمثّل "منقّي مياه" شائعًا استنادًا إلى نوع الجهاز وسماته المذكورة أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، يجب تعديل الردود وفقًا لذلك لعكس هذه التغييرات.
نموذج استجابة 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" } ] } } } }
أمثلة على أوامر EXECUTE
OnOff
للحصول على تفاصيل إضافية حول معلَمات الأمر، راجِع
مرجع 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 } } ] } }