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

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

صفات الجهاز

يمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية 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"
    }
  ]
}

مرات الاستلام على الجهاز

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

أخطاء الجهاز

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