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

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 برای باز است.

مثال ها

دستگاه چقدر چرخیده است؟ (درصد و درجات).

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

دستگاه چقدر چرخیده است؟ (فقط درجات).

{
  "rotationDegrees": 45
}

دستگاه چقدر چرخیده است؟ (مستمر).

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

دستورات دستگاه

دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات 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

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

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