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

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

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

سمات الجهاز

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

السمات النوع الوصف
supportsDegrees Boolean

مطلوبة.

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

مطلوبة.

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

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

مطلوبة.

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

يجب أن تكون القيمة بين 0 و360.
rotationDegreesMax Number

مطلوبة.

الحد الأقصى للتدوير بالدرجات.

يجب أن تكون القيمة بين 0 و360.
supportsContinuousRotation Boolean

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

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

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

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

أمثلة

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

{
  "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 إلى الفتح.

يجب أن تكون القيمة بين 0 و100.
targetRotationPercent Number

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

يجب أن تكون القيمة بين 0 و100.

أمثلة

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

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

مطلوبة.

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

يجب أن تكون القيمة بين 0 و100.

أمثلة

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

أخطاء الجهاز

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