مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

الجهاز ATTRIBUTES

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

السمات النوع الوصف
supportsDegrees منطقي

مطلوبة.

يمكنك ضبط هذه السياسة على "صحيح" إذا كان الجهاز يسمح بالتدوير حسب الدرجة.

supportsPercent منطقي

مطلوبة.

يمكنك الضبط على "true" إذا كان الجهاز يسمح بالتدوير بنسبة مئوية.

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
}

حالة الجهاز STATES

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

الولايات النوع الوصف
rotationDegrees Number

المستوى الحالي داخل rotationDegreesRange الذي يشير إلى عدد الدرجات التي تم تدوير الجهاز بها. يجب أن تكون هذه القيمة نسبية دائمًا لدوران اتجاه عقارب الساعة.

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

مطلوبة.

قيمة مطلقة بالدرجات تحدّد الدوران النهائي للجهاز في اتجاه عقارب الساعة يجب أن تكون القيمة داخل سمة 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

أخطاء الجهاز

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