طرحواره ویژگی چرخش خانه هوشمند
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 برای باز است. |
مثال ها
دستگاه چقدر چرخیده است؟ (درصد و درجات).
{ "rotationDegrees": 45, "rotationPercent": 25 }
دستگاه چقدر چرخیده است؟ (فقط درجات).
{ "rotationDegrees": 45 }
دستگاه چقدر چرخیده است؟ (مستمر).
{ "rotationDegrees": 270, "rotationPercent": 75 }
دستورات دستگاه
دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات 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