مخطط سمة تدوير المنزل الذكي
action.devices.traits.Rotation
: تنتمي هذه السمة إلى الأجهزة المتوافقة مع ميزة التدوير.
يمكن تحديد التدوير بنسبة مئوية أو درجات، وإذا كان الجهاز يتيح التدوير بدرجات، يكون الاتجاه التلقائي للتدوير هو اتجاه عقارب الساعة.
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
supportsDegrees |
منطقي |
مطلوبة. يمكنك ضبط هذه السياسة على "صحيح" إذا كان الجهاز يسمح بالتدوير حسب الدرجة. |
supportsPercent |
منطقي |
مطلوبة. يمكنك الضبط على "true" إذا كان الجهاز يسمح بالتدوير بنسبة مئوية. |
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 }
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
الولايات | النوع | الوصف |
---|---|---|
rotationDegrees |
Number |
المستوى الحالي داخل |
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 |
مطلوبة. قيمة مطلقة بالدرجات تحدّد الدوران النهائي للجهاز في اتجاه عقارب الساعة يجب أن تكون القيمة داخل سمة |
تعيين التدوير المطلق بالنسبة المئوية.
المَعلمات | النوع | الوصف |
---|---|---|
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