راهنمای خوشبو کننده هوای خانه هوشمند
action.devices.types.AIRFRESHENER
- خوشبو کننده های هوا را می توان روشن و خاموش کرد و ممکن است امکان تنظیم حالت های مختلف را فراهم کند.
این نوع نشان می دهد که دستگاه نماد خوشبو کننده هوا و برخی از مترادف ها و نام های مستعار مرتبط را دریافت می کند.
قابلیت های دستگاه
برای جزئیات پیادهسازی، مانند ویژگیها و حالتهایی که سرویس شما باید از آنها پشتیبانی کند، و نحوه ایجاد پاسخهای EXECUTE و QUERY، به اسناد ویژگی مربوطه مراجعه کنید.
صفات مورد نیاز
این صفات و دستورات، در صورت وجود برای دستگاه شما، مورد نیاز هستند. اگر دستگاه شما از این ویژگی ها پشتیبانی نمی کند، کد خطای functionNotSupported
را در پاسخ QUERY یا EXECUTE وارد کنید. برای اطلاعات بیشتر به خطاها و استثناها مراجعه کنید.
صفات توصیه شده
این ویژگیها در صورت وجود برای دستگاه شما توصیه میشوند. با این حال، شما آزاد هستید که تمام ویژگیهای موجود را با هم ترکیب کنید تا به بهترین نحو با عملکرد محصول موجود خود مطابقت داشته باشد.
الزامات کیفیت
- تأخیر: باید کمتر یا مساوی 1000 میلی ثانیه باشد.
- قابلیت اطمینان: باید بیشتر یا مساوی 97 درصد باشد.
دستگاه مثال: خوشبو کننده هوا ساده
این بخش شامل نمونههایی از محمولههای هدف است که بر اساس نوع دستگاه و ویژگیهای بالا، «بوکننده هوا» رایج را نشان میدهد. اگر ویژگیهایی را در پیادهسازی خود اضافه یا حذف میکنید، پاسخهای خود را متناسب با آن تغییر دهید تا آن تغییرات را منعکس کند.
نمونه پاسخ SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.AIRFRESHENER", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.Toggles" ], "name": { "name": "Simple air freshener" }, "willReportState": true, "attributes": { "availableToggles": [ { "name": "intermittent_key", "name_values": [ { "name_synonym": [ "Intermittent Spray" ], "lang": "en" }, { "name_synonym": [ "Intermittierender Spray" ], "lang": "de" } ] } ] }, "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, "currentToggleSettings": { "intermittent_key": true } } } } }
نمونه دستورات EXECUTE
روشن خاموش
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع 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 } } ] } }
SetToggles
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.Toggles
مراجعه کنید.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "intermittent_key": false } } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentToggleSettings": { "intermittent_key": false } } } ] } }