مخطط سمة OpenClose "لمنزل مزوّد بأجهزة ذكية"

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

ATTRIBUTES للجهاز

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

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

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

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

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

اتجاه مدعوم.

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

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose منطقي

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

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

(القيمة التلقائية: 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"
    }
  ]
}

CommandS للجهاز

قد تستجيب الأجهزة التي تتضمن هذه السمة لما يلي: الأوامر كجزء من عملية 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

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

يتطلب هذا الأمر السمات التالية: 
{
  "commandOnlyOpenClose": 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%

أخطاء الجهاز

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