مخطط سمة تدوير المنزل المزوّد بأجهزة ذكية

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

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

صفات الجهاز

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

السمات النوع الوصف
supportsDegrees منطقية

مطلوبة.

يتم ضبطه على "صحيح" إذا كان الجهاز يسمح بالتدوير حسب الدرجة.
supportsPercent منطقية

مطلوبة.

يتم ضبطه على "صحيح" إذا كان الجهاز يسمح بالتدوير حسب النسبة المئوية.
rotationDegreesRange كائن

مثِّل النطاق بالدرجات التي يمكن للجهاز تدويرها.
rotationDegreesMin Number

مطلوبة.

الحد الأدنى للتدوير بالدرجات.
rotationDegreesMax Number

مطلوبة.

أقصى دوران بالدرجات.
supportsContinuousRotation منطقية

(القيمة التلقائية: false)

يتم ضبطها على "صحيح" إذا كان الجهاز يسمح بالتدوير المستمر. عند تقديم طلب بحث نسبي، سيدور الأمر RotateAbsolute حول نطاق التدوير المتوافق.
commandOnlyRotation منطقية

(القيمة التلقائية: false)

تشير هذه العلامة إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو اتصال ثنائي الاتجاه (خطأ). يجب ضبط هذه السمة على "صحيح" إذا لم يتمكن الجهاز من الاستجابة لغرض QUERY أو "حالة التقرير" لهذه السمة.

أمثلة

جهاز متوافق مع كل من التدوير بالنسبة المئوية والدرجات

{
  "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 Number

المستوى الحالي ضمن النطاق rotationDegreesRange يشير إلى عدد درجات تدوير الجهاز. يجب أن تكون هذه القيمة نسبية دائمًا إلى التدوير في اتجاه عقارب الساعة.
rotationPercent Number

المستوى الحالي الذي يشير إلى النسبة المئوية لتدوير الجهاز حاليًا 0.0 يتجاوب مع المغلقة و100.0 للفتح.
targetRotationPercent Number

مستوى يشير إلى نسبة التدوير إلى المكان الذي سينتقل إليه الجهاز أو الذي سينتقل إليه نتيجةً لتغيير مستمر في الدوران.

أمثلة

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

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

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

{
  "rotationDegrees": 45
}

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

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

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

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

مرات الاستلام على الجهاز

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

action.devices.commands.RotateAbsolute

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

المَعلمات

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

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

المَعلمات النوع الوصف
rotationDegrees Number

مطلوبة.

قيمة مطلقة، بالدرجات، تحدد التدوير النهائي في اتجاه عقارب الساعة للجهاز. يجب أن تندرج القيمة ضمن السمة rotationDegreesRange.

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

المَعلمات النوع الوصف
rotationPercent Number

مطلوبة.

قيمة مطلقة، بالنسبة المئوية، تحدِّد التدوير النهائي للجهاز.

أمثلة

أمِل الجهاز إلى نسبة 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

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.