راهنمای کشو خانه هوشمند
action.devices.types.DRAWER
- کشوها را می توان در بیش از یک جهت باز و بسته کرد.
این نوع نشان می دهد که دستگاه نماد کشو و برخی از مترادف ها و مستعارهای مرتبط را دریافت می کند.
قابلیت های دستگاه
برای جزئیات پیادهسازی، مانند ویژگیها و حالتهایی که سرویس شما باید از آنها پشتیبانی کند، و نحوه ایجاد پاسخهای EXECUTE و QUERY، به اسناد ویژگی مربوطه مراجعه کنید.
صفات مورد نیاز
این صفات و دستورات، در صورت وجود برای دستگاه شما، مورد نیاز هستند. اگر دستگاه شما از این ویژگی ها پشتیبانی نمی کند، کد خطای functionNotSupported
را در پاسخ QUERY یا EXECUTE وارد کنید. برای اطلاعات بیشتر به خطاها و استثناها مراجعه کنید.
الزامات کیفیت
- تأخیر: باید کمتر یا مساوی 2500 میلیثانیه باشد.
- قابلیت اطمینان: باید بیشتر یا مساوی 97 درصد باشد.
دستگاه نمونه: کشو ساده
این بخش شامل نمونه بارهای هدف است که بر اساس نوع دستگاه و ویژگیهای بالا، یک «کشو» رایج را نشان میدهد. اگر ویژگیهایی را در پیادهسازی خود اضافه یا حذف میکنید، پاسخهای خود را متناسب با آن تغییر دهید تا آن تغییرات را منعکس کند.
نمونه پاسخ SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.DRAWER", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple drawer" }, "willReportState": true, "attributes": { "discreteOnlyOpenClose": 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, "openPercent": 100 } } } }
نمونه دستورات EXECUTE
باز بستن
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.OpenClose
مراجعه کنید.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 0 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openPercent": 0 } } ] } }