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

مخطّط سمات Openclose Smart Home

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

الجهاز ATTRIBUTES

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

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

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

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

openDirection المصفوفة

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

[item, ...] سلسلة

الاتجاه المعتمد.

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

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

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

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

queryOnlyOpenClose منطقي

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

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

أمثلة

جهاز بسيط ومفتوح.

{
  "discreteOnlyOpenClose": true
}

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

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

الجهاز المخصّص للأوامر فقط:

{
  "commandOnlyOpenClose": true
}

حالة الجهاز STATES

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

تحتوي الحمولة على واحد مما يلي:

اتجاه واحد مفتوح

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

مطلوبة.

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

إغلاق الاتجاه المتعدد

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

مطلوبة.

قائمة بالحالات لكل اتجاه مفتوح متاح.

[item, ...] العنصر

الحالة الحالية للاتجاه المفتوح المحدد.

openPercent Number

مطلوبة.

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

openDirection سلسلة

مطلوبة.

الاتجاه الذي يتم فيه فتح الجهاز.

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

UP
DOWN
LEFT
RIGHT
IN
OUT

أمثلة

جهاز بسيط ومفتوح.

{
  "openPercent": 100
}

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

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

مفاتيح COMMAND

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

action.devices.commands.OpenClose

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

المَعلمات

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

مطلوبة.

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

openDirection سلسلة

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

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

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken سلسلة

رمز مميز تقدمه 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 سلسلة

مطلوبة.

تم تقديم الرمز المميز في طلب EXECUTE الأصلي.

status سلسلة

مطلوبة.

نتيجة الطلب.

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

SUCCESS
openPercent Number

مطلوبة.

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

تعذّر الإجراء

الحقول النوع الوصف
followUpToken سلسلة

مطلوبة.

تم تقديم الرمز المميز في طلب EXECUTE الأصلي.

status سلسلة

مطلوبة.

نتيجة الطلب.

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

FAILURE
errorCode سلسلة

مطلوبة.

يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، مثل 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 على true.

يتطلب هذا الأمر السمات التالية:
{
  "commandOnlyOpenClose": true
}

المَعلمات

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

مطلوبة.

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

openDirection سلسلة

الاتجاه المراد فتحه. لا تتوفّر هذه السمة إلا إذا كان الجهاز يتيح استخدام اتجاهات متعدّدة، كما هو موضّح في السمة 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
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • 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
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • 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%

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
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • Abrir janela 50%
  • Fecha a persiana toda
  • Fechar a janela 10%
  • 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
  • öppna persiennerna med 25%

أخطاء الجهاز

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