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

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

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

ATTRIBUTES للجهاز

يمكن أن تُبلغ الأجهزة التي تتضمّن هذه السمة عن ما يلي: كجزء من عملية 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
}

CommandS للجهاز

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

أخطاء الجهاز

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