راهنمای آشپز خانه هوشمند
action.devices.types.COOKTOP
- فعل و انفعالات با اجاقها ممکن است شامل روشن و خاموش کردن آنها، شروع و توقف، تنظیم تایمر، تنظیم حالتهای پخت و تنظیم از پیش تعیین شده غذا و تنظیم تنظیمات مختلف حالت غیر پخت باشد.
این نوع نشان میدهد که دستگاه نماد Cooktop و برخی از مترادفها و نامهای مستعار مرتبط را دریافت میکند.
قابلیت های دستگاه
برای جزئیات پیادهسازی، مانند ویژگیها و حالتهایی که سرویس شما باید از آنها پشتیبانی کند، و نحوه ساخت پاسخهای EXECUTE و QUERY، به مستندات ویژگی مربوطه مراجعه کنید.
صفات مورد نیاز
این صفات و دستورات، در صورت وجود برای دستگاه شما، مورد نیاز هستند.
صفات توصیه شده
این ویژگیها در صورت وجود برای دستگاه شما توصیه میشوند. با این حال، شما آزاد هستید که تمام ویژگیهای موجود را با هم ترکیب کنید تا به بهترین نحو با عملکرد محصول موجود خود مطابقت داشته باشد.
الزامات کیفیت
- تأخیر: باید کمتر یا مساوی 800 میلی ثانیه باشد.
- قابلیت اطمینان: باید بیشتر یا مساوی 97 درصد باشد.
دستگاه نمونه: اجاق گاز ساده
این بخش شامل نمونههایی از محمولههای هدف است که بر اساس نوع دستگاه و ویژگیهای بالا، نشاندهنده یک «تابخانه» رایج است. اگر ویژگیهایی را در پیادهسازی خود اضافه یا حذف میکنید، پاسخهای خود را متناسب با آن تغییر دهید تا آن تغییرات را منعکس کند.
نمونه پاسخ SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.COOKTOP", "traits": [ "action.devices.traits.Cook", "action.devices.traits.StartStop", "action.devices.traits.Timer", "action.devices.traits.OnOff" ], "name": { "name": "Simple cooktop" }, "willReportState": true, "attributes": { "supportedCookingModes": [ "COOK", "BOIL", "SAUTE" ], "foodPresets": [ { "food_preset_name": "chicken_key", "supported_units": [ "POUNDS", "OUNCES" ], "food_synonyms": [ { "synonym": [ "Chicken", "Chicken breast", "Chicken thigh" ], "lang": "en" } ] }, { "food_preset_name": "bacon_key", "supported_units": [ "POUNDS", "OUNCES" ], "food_synonyms": [ { "synonym": [ "Bacon", "Bacon strips" ], "lang": "en" } ] } ], "maxTimerLimitSec": 1200, "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, "on": true, "isRunning": true, "isPaused": false, "timerRemainingSec": 120, "currentCookingMode": "COOK", "currentFoodPreset": "chicken_key" } } } }
نمونه دستورات EXECUTE
پختن
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.Cook
مراجعه کنید.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BOIL" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentCookingMode": "BOIL", "currentFoodPreset": "NONE" } } ] } }
شروع پایان
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع 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": "SUCCESS", "states": { "online": true, "isRunning": true, "isPaused": false } } ] } }
TimerStart
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.Timer
مراجعه کنید.
{ "requestId": "6894439706274654522", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } } ] } ] } } ] }
{ "requestId": "6894439706274654522", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 300 } } ] } }
تایمر تنظیم کنید
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.Timer
مراجعه کنید.
{ "requestId": "6894439706274654524", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -10 } } ] } ] } } ] }
{ "requestId": "6894439706274654524", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 110 } } ] } }
تایمر مکث
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.Timer
مراجعه کنید.
{ "requestId": "6894439706274654526", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerPause" } ] } ] } } ] }
{ "requestId": "6894439706274654526", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 120, "timerPaused": true } } ] } }
تایمر رزومه
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.Timer
مراجعه کنید.
{ "requestId": "6894439706274654528", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerResume" } ] } ] } } ] }
{ "requestId": "6894439706274654528", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 120, "timerPaused": false } } ] } }
تایمر لغو
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.Timer
مراجعه کنید.
{ "requestId": "6894439706274654530", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerCancel" } ] } ] } } ] }
{ "requestId": "6894439706274654530", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": -1 } } ] } }
روشن خاموش
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.OnOff
مراجعه کنید.
{ "requestId": "6894439706274654532", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654532", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }