طرحواره ویژگی چرخش خانه هوشمند

action.devices.traits.Rotation - این ویژگی متعلق به دستگاه هایی است که از چرخش پشتیبانی می کنند.

چرخش را می توان به صورت درصد یا درجه مشخص کرد و اگر دستگاه از چرخش درجه پشتیبانی می کند، جهت پیش فرض چرخش در جهت عقربه های ساعت است.

ویژگی های دستگاه

دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC ، به تحقق هدف مراجعه کنید.

صفات تایپ کنید توضیحات
supportsDegrees بولی

مورد نیاز.

اگر دستگاه اجازه چرخش بر حسب درجه را بدهد، روی true تنظیم کنید.

supportsPercent بولی

مورد نیاز.

اگر دستگاه اجازه چرخش درصدی را بدهد، روی true تنظیم کنید

rotationDegreesRange شیء

محدوده را بر حسب درجاتی که یک دستگاه می تواند بچرخاند نشان دهید.

rotationDegreesMin شماره

مورد نیاز.

حداقل چرخش بر حسب درجه

rotationDegreesMax شماره

مورد نیاز.

حداکثر چرخش بر حسب درجه

supportsContinuousRotation بولی

(پیش‌فرض: false )

اگر دستگاه اجازه چرخش مداوم را بدهد، روی true تنظیم کنید. هنگامی که یک پرس و جو نسبی داده می شود، دستور RotateAbsolute در اطراف محدوده چرخش پشتیبانی شده قرار می گیرد.

commandOnlyRotation بولی

(پیش‌فرض: false )

نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف 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 شماره

سطح فعلی در rotationDegreesRange که نشان می دهد دستگاه چند درجه چرخیده است. این مقدار باید همیشه نسبت به چرخش جهت عقربه های ساعت باشد.

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 شماره

مورد نیاز.

یک مقدار مطلق، بر حسب درجه، که چرخش نهایی دستگاه را در جهت عقربه های ساعت مشخص می کند. مقدار باید در ویژگی rotationDegreesRange باشد.

چرخش مطلق را بر حسب درصد تنظیم کنید.

پارامترها تایپ کنید توضیحات
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

خطاهای دستگاه

لیست کامل خطاها و استثناها را ببینید.