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

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

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

سمات الجهاز

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

السمات	Type	الوصف
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. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

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

أمثلة

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

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

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

{
  "rotationDegrees": 45
}

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

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

حوالات الجهاز

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

action.devices.commands.RotateAbsolute

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

المعلّمات

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

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

المعلّمات	Type	الوصف
rotationDegrees	Number	مطلوب: هي قيمة مطلقة بالدرجات تحدّد الدوران النهائي للجهاز في اتجاه عقارب الساعة. يجب أن تندرج القيمة ضمن سمة rotationDegreesRange.

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

المعلّمات	Type	الوصف
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

أخطاء الجهاز

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