مخطّط سمة OpenClose في المنزل الذكي

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

سمات الجهاز

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

السمات النوع الوصف
discreteOnlyOpenClose صحيح/خطأ

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

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

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

الاتجاه المسموح به

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

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose صحيح/خطأ

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

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

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

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

أمثلة

جهاز سهل الفتح والإغلاق:

{
  "discreteOnlyOpenClose": true
}

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

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

جهاز للطلبات فقط:

{
  "commandOnlyOpenClose": false
}

حالات الجهاز

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

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

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

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

مطلوبة

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

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

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

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

مطلوبة

قائمة الولايات لكل اتجاه مفتوح متوافق
[item, ...] العنصر

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

مطلوبة

يشير إلى النسبة المئوية لفتح الجهاز، حيث يشير الصفر إلى أنّ الجهاز مغلق ويشير العدد 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 intents، اطّلِع على تلبية النية.

action.devices.commands.OpenClose

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

المعلمات

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

مطلوبة

يشير إلى النسبة المئوية لفتح الجهاز، حيث يشير الصفر إلى أنّ الجهاز مغلق ويشير العدد 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%

أخطاء الجهاز

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