مخطّط سمة التدوير في المنزل الذكي

‫action.devices.traits.Rotation: تنطبق هذه السمة على الأجهزة التي تتيح إمكانية التدوير.

يمكن تحديد عملية التدوير إما بالنسب المئوية أو بالدرجات، وإذا كان الجهاز يتيح التدوير بالدرجات، يكون اتجاه التدوير التلقائي باتجاه عقارب الساعة.

سمات الجهاز

قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. للاطّلاع على مزيد من المعلومات عن معالجة SYNC intents، اطّلِع على تلبية النية.

أمثلة

جهاز يتيح التدوير بالنسب المئوية وبالدرجات

{
  "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 intents، اطّلِع على تلبية النية.

أمثلة

ما مقدار دوران الجهاز؟ (النسبة المئوية والدرجات)

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

ما مقدار دوران الجهاز؟ (درجات فقط).

{
  "rotationDegrees": 45
}

ما مقدار دوران الجهاز؟ (مستمر).

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

جهاز يدور حاليًا إلى موضع جديد (بالنسبة المئوية)

{
  "rotationPercent": 75,
  "targetRotationPercent": 100
}

أوامر الجهاز

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية EXECUTE. للاطّلاع على مزيد من المعلومات عن معالجة EXECUTE intents، اطّلِع على تلبية النية.

action.devices.commands.RotateAbsolute

اضبط الدوران المطلق للجهاز.

المعلمات

تحتوي الحمولة على أحد العناصر التالية:

اضبط الدوران المطلق بالدرجات.

اضبط التناوب المطلق كنسبة مئوية.

أمثلة

احرِّك الجهاز بزاوية 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

أخطاء الجهاز