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

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

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

الجهاز ATTRIBUTES

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

السمات	النوع	الوصف
supportsDegrees	منطقي	مطلوبة. يمكنك ضبط هذه السياسة على "صحيح" إذا كان الجهاز يسمح بالتدوير حسب الدرجة.
supportsPercent	منطقي	مطلوبة. يمكنك الضبط على "true" إذا كان الجهاز يسمح بالتدوير بنسبة مئوية.
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
}

حالة الجهاز STATES

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

الولايات	النوع	الوصف
rotationDegrees	Number	المستوى الحالي داخل rotationDegreesRange الذي يشير إلى عدد الدرجات التي تم تدوير الجهاز بها. يجب أن تكون هذه القيمة نسبية دائمًا لدوران اتجاه عقارب الساعة.
rotationPercent	Number	المستوى الحالي الذي يشير إلى النسبة المئوية لتدوير الجهاز حاليًا. 0.0 يقابله مغلق و100.0 للفتح.

أمثلة

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

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

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

{
  "rotationDegrees": 45
}

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

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

مفاتيح COMMAND

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية 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

أخطاء الجهاز

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