طرحواره ویژگی چرخش خانه هوشمند
action.devices.traits.Rotation
- این ویژگی متعلق به دستگاه هایی است که از چرخش پشتیبانی می کنند.
چرخش را می توان به صورت درصد یا درجه مشخص کرد و اگر دستگاه از چرخش درجه پشتیبانی می کند، جهت پیش فرض چرخش در جهت عقربه های ساعت است.
ویژگی های دستگاه
دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC
، به تحقق هدف مراجعه کنید.
صفات | تایپ کنید | توضیحات |
---|---|---|
supportsDegrees | بولی | مورد نیاز. اگر دستگاه اجازه چرخش بر حسب درجه را بدهد، روی true تنظیم کنید. |
supportsPercent | بولی | مورد نیاز. اگر دستگاه اجازه چرخش درصدی را بدهد، روی true تنظیم کنید |
rotationDegreesRange | شیء | محدوده را بر حسب درجاتی که یک دستگاه می تواند بچرخاند نشان دهید. |
rotationDegreesMin | شماره | مورد نیاز. حداقل چرخش بر حسب درجه |
rotationDegreesMax | شماره | مورد نیاز. حداکثر چرخش بر حسب درجه |
supportsContinuousRotation | بولی | (پیشفرض: اگر دستگاه اجازه چرخش مداوم را بدهد، روی true تنظیم کنید. هنگامی که یک پرس و جو نسبی داده می شود، دستور |
commandOnlyRotation | بولی | (پیشفرض: نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف QUERY یا وضعیت گزارش برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید. |
نمونه ها
دستگاهی که از چرخش در درصد و درجه پشتیبانی می کند.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 180 } }
دستگاهی که فقط از چرخش درجه پشتیبانی می کند.
{ "supportsDegrees": true, "supportsPercent": false, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 90 } }
دستگاهی که فقط از دستورات چرخش مداوم پشتیبانی می کند.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 360 }, "supportsContinuousRotation": true, "commandOnlyRotation": true }
وضعیت دستگاه
موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات QUERY
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد QUERY
، به تحقق هدف مراجعه کنید.
ایالات | تایپ کنید | توضیحات |
---|---|---|
rotationDegrees | شماره | سطح فعلی در |
rotationPercent | شماره | سطح فعلی که نشان می دهد چند درصد دستگاه در حال حاضر چرخانده شده است. 0.0 مربوط به بسته و 100.0 برای باز است. |
targetRotationPercent | شماره | سطحی که نشاندهنده درصد چرخش است که دستگاه در نتیجه تغییر مداوم چرخش به کجا میرود یا در حال حرکت است. |
نمونه ها
دستگاه چقدر چرخیده است؟ (درصد و درجات).
{ "rotationDegrees": 45, "rotationPercent": 25 }
دستگاه چقدر چرخیده است؟ (فقط درجات).
{ "rotationDegrees": 45 }
دستگاه چقدر چرخیده است؟ (مستمر).
{ "rotationDegrees": 270, "rotationPercent": 75 }
دستگاهی که در حال حاضر به یک موقعیت جدید می چرخد (درصد).
{ "rotationPercent": 75, "targetRotationPercent": 100 }
دستورات دستگاه
دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE
پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE
intent ها، به اجرای Intent مراجعه کنید.
action.devices.commands.RotateAbsolute
چرخش مطلق دستگاه را تنظیم کنید.
پارامترها
محموله شامل یکی از موارد زیر است:
چرخش مطلق را بر حسب درجه تنظیم کنید.
پارامترها | تایپ کنید | توضیحات |
---|---|---|
rotationDegrees | شماره | مورد نیاز. یک مقدار مطلق، بر حسب درجه، که چرخش نهایی دستگاه را در جهت عقربه های ساعت مشخص می کند. مقدار باید در ویژگی |
چرخش مطلق را بر حسب درصد تنظیم کنید.
پارامترها | تایپ کنید | توضیحات |
---|---|---|
rotationPercent | شماره | مورد نیاز. یک مقدار مطلق، بر حسب درصد، که چرخش نهایی دستگاه را مشخص می کند. |
نمونه ها
دستگاه را تا 50 درصد کج کنید.
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationPercent": 50 } }
دستگاه را 15 درجه در خلاف جهت عقربه های ساعت بچرخانید ( rotationDegrees: 45
).
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 30 } }
دستگاه را 100 درجه در جهت عقربه های ساعت بچرخانید ( supportsContinuousRotation: true
، rotationDegrees: 270
).
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 10 } }
خطاهای مرتبط
در تنظیم چرخش دستگاه خطایی روی داد.
مقادیر پشتیبانی شده:
-
deviceJammingDetected