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

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

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

ATTRIBUTES للجهاز

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

السمات النوع الوصف
supportsDegrees صحيح/خطأ

مطلوبة

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

مطلوبة

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

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

مطلوبة

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

مطلوبة

الحد الأقصى للتدوير بالدرجات
supportsContinuousRotation صحيح/خطأ

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

اضبطها على true إذا كان الجهاز يسمح بالدوران المستمر. عند إدخال طلب بحث نسبي، سيظهر الأمر 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

أخطاء الجهاز

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