مخطط سمة OpenClose للأجهزة المنزلية الذكية

‫action.devices.traits.OpenClose: تنتمي هذه السمة إلى الأجهزة التي تتيح الفتح والإغلاق، وفي بعض الحالات، الفتح والإغلاق بشكل جزئي أو ربما في أكثر من اتجاه واحد.

سمات الجهاز

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

السمات النوع الوصف
discreteOnlyOpenClose Boolean

(القيمة التلقائية: false)

عند ضبطها على "صحيح"، يشير ذلك إلى أنّه يجب أن يكون الجهاز مفتوحًا بالكامل أو مغلقًا بالكامل (أي أنّه لا يتيح قيمًا بين% 0 و%100).
openDirection المصفوفة

قائمة بالاتجاهات المتوافقة التي يمكن للجهاز الفتح أو الإغلاق فيها أدرِج هذه السمة إذا كان الجهاز يتيح الفتح والإغلاق في أكثر من اتجاه واحد.
[item, ...] String

الاتجاه المتوافق

القيم المسموح بها:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Boolean

(القيمة التلقائية: false)

توضّح ما إذا كان الجهاز يتيح استخدام الاتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا كان الجهاز لا يستجيب لطلب QUERY أو Report State لهذه السمة.
queryOnlyOpenClose Boolean

(القيمة التلقائية: false)

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

أمثلة

جهاز بسيط للفتح والإغلاق

{
  "discreteOnlyOpenClose": true
}

جهاز من أعلى إلى أسفل ومن أسفل إلى أعلى يمكن فتحها في أي اتجاه.

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

جهاز يمكنه تنفيذ الأوامر فقط:

{
  "commandOnlyOpenClose": false
}

حالات الجهاز

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

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

الفتح والإغلاق في اتجاه واحد

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

مطلوبة.

تشير إلى النسبة المئوية لفتح الجهاز، حيث تكون القيمة 0 مغلقة والقيمة 100 مفتوحة بالكامل.
targetOpenPercent Number

المستوى الذي يشير إلى النسبة المئوية للفتح حيث سيتوقف الجهاز أو يتحرّك نتيجة لتغيير مستمر في الموضع.

الفتح والإغلاق في اتجاهات متعددة

الولايات النوع الوصف
openState المصفوفة

مطلوبة.

قائمة الحالات لكل اتجاه مفتوح مسموح به.
[item, ...] الكائن

الحالة الحالية لاتجاه الفتح المحدّد
openPercent Number

مطلوبة.

تشير إلى النسبة المئوية لفتح الجهاز، حيث تكون القيمة 0 مغلقة والقيمة 100 مفتوحة بالكامل.
targetOpenPercent Number

المستوى الذي يشير إلى النسبة المئوية للفتح حيث سيتوقف الجهاز أو يتحرّك نتيجة لتغيير مستمر في الموضع.
openDirection String

مطلوبة.

اتجاه فتح الجهاز

القيم المسموح بها:

UP
DOWN
LEFT
RIGHT
IN
OUT

أمثلة

جهاز بسيط للفتح والإغلاق

{
  "openPercent": 100
}

جهاز بسيط الفتح والإغلاق يتم فتحه حاليًا إلى موضع جديد.

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

افتح الجهاز بنسبة% 30 في الاتجاه الأسفل، وبنسبة% 50 في الاتجاه الأعلى.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

افتح الجهاز بنسبة% 30 في الاتجاه الأسفل، وبنسبة% 50 في الاتجاه الأعلى، ويتم حاليًا التحريك إلى% 80 في الاتجاه الأعلى.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

أوامر الجهاز

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

action.devices.commands.OpenClose

اضبط حالة فتح الجهاز أو إغلاقه.

المعلمات

المعلمات النوع الوصف
openPercent Number

مطلوبة.

تشير إلى النسبة المئوية لفتح الجهاز، حيث تكون القيمة 0 مغلقة والقيمة 100 مفتوحة بالكامل.
openDirection String

الاتجاه الذي سيتم الفتح فيه لا تظهر إلا إذا كان الجهاز يتيح اتجاهات متعددة، كما هو موضّح في السمة openDirection، وإذا حدّد المستخدم اتجاهًا.

القيم المسموح بها:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

رمز مميز مقدَّم من Google للردّ على المتابعة.

أمثلة

افتح الجهاز.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

افتح الجهاز بنسبة %50.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

حدث خطأ أثناء ضبط حالة فتح الجهاز أو إغلاقه.

القيم المسموح بها:

lockedState
deviceJammingDetected

الردود المتابعة

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

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

تم الإجراء بنجاح

الحقول النوع الوصف
followUpToken String

مطلوبة.

الرمز المميّز المقدَّم في طلب EXECUTE الأصلي
status String

مطلوبة.

نتيجة الطلب

القيم المسموح بها:

SUCCESS
openPercent Number

مطلوبة.

تشير إلى النسبة المئوية لفتح الجهاز، حيث يمثّل الرقم 0 حالة الإغلاق والرقم 100 حالة الفتح الكامل.

تعذّر إتمام العملية

الحقول النوع الوصف
followUpToken String

مطلوبة.

الرمز المميّز المقدَّم في طلب EXECUTE الأصلي
status String

مطلوبة.

نتيجة الطلب

القيم المسموح بها:

FAILURE
errorCode String

مطلوبة.

يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، مثل lockedState.

أمثلة

افتح باب المرآب. (ردّ المتابعة لحالة النجاح)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

افتح باب المرآب. (ردّ المتابعة في حال حدوث خطأ)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

action.devices.commands.OpenCloseRelative

اضبط حالة الفتح والإغلاق للجهاز بالنسبة إلى الحالة الحالية. لا يتوفّر هذا الأمر إلا في حال ضبط discreteOnlyOpenClose على false.

يتطلّب هذا الأمر السمات التالية: 
{
  "discreteOnlyOpenClose": false
}

المعلمات

المعلمات النوع الوصف
openRelativePercent Number

مطلوبة.

النسبة المئوية الدقيقة لتغيير حالة الفتح والإغلاق سيتم تحويل الأوامر النسبية الغامضة إلى مَعلمة نسبة مئوية دقيقة (على سبيل المثال، "فتح الستائر أكثر قليلاً" مقابل "فتح الستائر بنسبة %5").
openDirection String

الاتجاه الذي سيتم الفتح فيه لا تظهر إلا إذا كان الجهاز يتيح اتجاهات متعددة، كما هو موضّح في السمة openDirection، وإذا حدّد المستخدم اتجاهًا.

القيم المسموح بها:

UP
DOWN
LEFT
RIGHT
IN
OUT

أمثلة

افتح الجهاز أكثر قليلاً

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

إغلاق الجهاز بنسبة% 10 إضافية

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

افتح الجهاز بنسبة% 50 أكثر، إلى الأسفل.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

حدث خطأ أثناء ضبط حالة فتح الجهاز أو إغلاقه.

القيم المسموح بها:

lockedState
deviceJammingDetected

عبارات نموذجية

de-DE

  • Bitte öffne die Jalousien auf 30%
  • Fensterläden um 25 % schliessen
  • Ist die Jalousie zu?
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • Are the blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra mucho más la ventana
  • está abierta la puerta
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • est-ce que la porte d'entrée est ouverte
  • ferme les stores
  • ferme un peu les stores
  • ouvre les stores
  • ouvre les stores de la chambre de 25%
  • ouvre les stores à 25%

hi-IN

  • कृपया 25% पर्दे को खुला रखो
  • क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
  • पर्दे को 25% बंद करोगे
  • पर्दे खोलो
  • ब्लाइंड 25% खुले पर सेट कर दीजिए
  • ब्लाइंड को थोड़ा और बंद कर दिजिए
  • ब्लाइंड बंद करें

it-IT

  • abbassa un po' di più le tapparelle
  • apri la serranda
  • apri la tapparella al 30%
  • apri le serrande del 30%
  • chiudi le serrande
  • chiudi le tende del 25%
  • è aperta la porta d'ingresso

ja-JP

  • 25% に ブラインド を開けて
  • 25% ブラインド を閉めてください
  • 25% ブラインド 開けて
  • ブラインド 閉めて
  • ブラインド 開けて
  • 少し ブラインド を閉じて
  • 玄関のドア は開いてますか

ko-KR

  • 문 살짝만 닫아 줘
  • 블라인드 25% 열어 줘
  • 블라인드 25% 까지 열어 줘
  • 블라인드 30프로 닫아
  • 블라인드 닫아 줘
  • 블라인드 열어 줘
  • 안방 문 열렸어

nl-NL

  • doe de gordijnen 25% open
  • doe de jaloezieën voor 25% dicht
  • doe het raam ietsje meer dicht
  • is de voordeur open
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • Abrir janela 50%
  • As cortinas estão abertas?
  • Fecha a persiana toda
  • Fechar a janela 10%
  • a cortina do quarto está aberta?
  • abra a persiana até 30%
  • abre as cortinas
  • abre as cortinas a 50%
  • abrir as cortinas
  • abrir as cortinas na sala em 30%
  • fecha a persiana por favor
  • fecha um bocado a janela
  • fechar as cortinas em 25%
  • fechar um pouco mais as cortinas

sv-SE

  • Dra upp persiennerna
  • Dra upp persiennerna till 25%
  • stäng persiennen i mitt rum 25%
  • stäng persiennerna
  • är ytterdörren öppen?
  • öppna persiennerna med 25%

أخطاء الجهاز

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