دليل سخّانات المنازل المزوّدة بأجهزة ذكية
action.devices.types.BOILER : يمكن تشغيل أجهزة تدفئة المياه وإيقافها، وقد تتيح تعديل درجة الحرارة.
يشير هذا النوع إلى أنّ الجهاز يحصل على رمز "جهاز تدفئة المياه" وبعض المرادفات والأسماء المستعارة ذات الصلة
إمكانات الجهاز
يُرجى الرجوع إلى مستندات السمة المقابلة للاطّلاع على تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تتيحها خدمتك، وكيفية إنشاء استجابات EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والأوامر مطلوبة إذا كانت تنطبق على جهازك. إذا كان جهازك لا يتيح هذه السمات، أدخِل رمز الخطأ functionNotSupported في استجابة QUERY أو EXECUTE. لمزيد من المعلومات، اطّلِع على
الأخطاء والاستثناءات.
السمات التي يُنصح بها
يُنصح بهذه السمات إذا كانت تنطبق على جهازك. ومع ذلك، يمكنك الجمع بين جميع السمات المتاحة ومطابقتها لتناسب وظائف منتجك الحالية على أفضل نحو.
مثال على جهاز: سخّان بسيط
يحتوي هذا القسم على أمثلة على حمولات الأهداف التي تمثّل "جهاز تدفئة مياه" شائعًا استنادًا إلى نوع الجهاز والسمات أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، عدِّل استجاباتك وفقًا لذلك لعكس هذه التغييرات.
مثال على استجابة SYNC
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.BOILER", "traits": [ "action.devices.traits.TemperatureControl", "action.devices.traits.OnOff" ], "name": { "name": "Simple boiler" }, "willReportState": true, "attributes": { "temperatureRange": { "minThresholdCelsius": 10, "maxThresholdCelsius": 50 }, "temperatureUnitForUX": "F" }, "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, "temperatureSetpointCelsius": 35 } } } }
أمثلة على أوامر EXECUTE
SetTemperature
لمزيد من التفاصيل حول مَعلمات الأمر،
اطّلِع على
action.devices.traits.TemperatureControl
مرجع.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetTemperature", "params": { "temperature": 40 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "temperatureSetpointCelsius": 40 } } ] } }
OnOff
لمزيد من التفاصيل حول مَعلمات الأمر،
اطّلِع على
action.devices.traits.OnOff
مرجع.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }