مخطط سمة دوران المنزل الذكي
action.devices.traits.Rotation
: تنتمي هذه السمة إلى الأجهزة التي تتيح استخدام ميزة التدوير.
يمكن تحديد التدوير في نسبة مئوية أو درجة، وإذا كان الجهاز يتيح التدوير حسب الدرجات، يكون اتجاه التدوير التلقائي في اتجاه عقارب الساعة.
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات
التالية كجزء من عملية SYNC
. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في SYNC
، يُرجى الاطّلاع على تنفيذ النية بالشراء.
السمات | Type | الوصف |
---|---|---|
supportsDegrees |
منطقي |
مطلوب: يتم ضبطها على "صحيح" إذا كان الجهاز يسمح بالتدوير حسب الدرجة. |
supportsPercent |
منطقي |
مطلوب: يتم الضبط على "صحيح" إذا كان الجهاز يتيح التدوير بنسبة مئوية. |
rotationDegreesRange |
العنصر |
يمكنك تمثيل النطاق بالدرجات التي يمكن للجهاز تدويرها. |
rotationDegreesMin |
Number |
مطلوب: الحد الأدنى للتدوير بالدرجات |
rotationDegreesMax |
Number |
مطلوب: الحد الأقصى للتدوير بالدرجات |
supportsContinuousRotation |
منطقي |
(تلقائي: يتم ضبطها على "صحيح" إذا كان الجهاز يسمح بالتدوير المستمر. عند تقديم طلب بحث نسبي، سيلتفّ الأمر |
commandOnlyRotation |
منطقي |
(تلقائي: تشير إلى ما إذا كان الجهاز يتيح استخدام الاتصال الأحادي (صحيح) أو الثنائي (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز استجابة هدف 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 |
المستوى الحالي داخل |
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 |
مطلوب: هي قيمة مطلقة بالدرجات تحدّد الدوران النهائي للجهاز في اتجاه عقارب الساعة. يجب أن تندرج القيمة ضمن سمة |
ضبط التناوب المطلق بالنسبة المئوية
المعلّمات | 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