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

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

أخطاء الجهاز

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