دليل المكنسة الكهربائية الذكية
action.devices.types.VACUUM - قد تتضمّن المكانس الكهربائية وظائف مثل بدء التنظيف وإيقافه وإيقافه مؤقتًا، أو إرساء المكنسة، أو التحقّق من دورة التنظيف الحالية، أو تحديد موقع المكنسة، أو تعديل أوضاع مختلفة. قد تتيح بعض المكانس الكهربائية تنظيف مناطق معيّنة في المنزل.
يشير هذا النوع إلى أنّ الجهاز يحصل على رمز المكنسة الكهربائية وبعض المرادفات والأسماء المستعارة ذات الصلة.
إمكانات الجهاز
يُرجى الرجوع إلى مستندات السمة المقابلة للحصول على تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تتيحها خدمتك، وكيفية إنشاء استجابات EXECUTE وQUERY.
السمات المطلوبة
تكون هذه السمات والأوامر مطلوبة إذا كانت تنطبق على جهازك. إذا كان جهازك لا يتيح هذه السمات، أدخِل رمز الخطأ functionNotSupported في استجابة QUERY أو EXECUTE. لمزيد من المعلومات، اطّلِع على
الأخطاء والاستثناءات.
السمات التي يُنصح بها
يُنصح باستخدام هذه السمات إذا كانت تنطبق على جهازك. ومع ذلك، يمكنك الجمع بين جميع السمات المتاحة ومطابقتها لتناسب وظائف منتجك الحالية على أفضل نحو.
-
action.devices.traits.Dock -
action.devices.traits.EnergyStorage -
action.devices.traits.Locator -
action.devices.traits.OnOff -
action.devices.traits.RunCycle
مثال على جهاز: مكنسة كهربائية بسيطة
يحتوي هذا القسم على أمثلة على حمولات النية التي تمثّل "مكنسة كهربائية" شائعة استنادًا إلى نوع الجهاز والسمات أعلاه. إذا أضفت سمات أو أزلتها في عملية التنفيذ، عدِّل استجاباتك وفقًا لذلك لتعكس هذه التغييرات.
مثال على استجابة SYNC
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.VACUUM", "traits": [ "action.devices.traits.Dock", "action.devices.traits.EnergyStorage", "action.devices.traits.StartStop" ], "name": { "name": "Simple vacuum" }, "willReportState": true, "attributes": { "queryOnlyEnergyStorage": true, "pausable": true }, "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, "isRunning": false, "isPaused": false, "isDocked": true, "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "unit": "SECONDS", "rawValue": 36000 }, { "unit": "PERCENTAGE", "rawValue": 90 } ] } } } }
أمثلة على أوامر EXECUTE
إرساء
لمزيد من التفاصيل عن مَعلمات الأمر،
اطّلِع على
action.devices.traits.Dock
مرجع.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Dock" } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "PENDING", "states": { "online": true, "isDocked": true } } ] } }
StartStop
لمزيد من التفاصيل عن مَعلمات الأمر،
اطّلِع على
action.devices.traits.StartStop
مرجع.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.StartStop", "params": { "start": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "PENDING", "states": { "online": true, "isRunning": true, "isPaused": false } } ] } }
PauseUnpause
لمزيد من التفاصيل عن مَعلمات الأمر،
اطّلِع على
action.devices.traits.StartStop
مرجع.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.PauseUnpause", "params": { "pause": true } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "PENDING", "states": { "online": true, "isRunning": false, "isPaused": true } } ] } }