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

مخطط سمة OpenHome Open Smart Lock

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

سمات الجهاز

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

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

(تلقائي: false)

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

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

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

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

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

(تلقائي: false)

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

(تلقائي: false)

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

أمثلة

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

{
  "discreteOnlyOpenClose": true
}

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

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

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

{
  "commandOnlyOpenClose": false
}

حالات الجهاز

قد تُبلِغ الكيانات التي تحمل هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

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

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

الولايات Type الوصف
openPercent Number

مطلوب:

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

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

الولايات Type الوصف
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"
    }
  ]
}

حوالات الجهاز

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

action.devices.commands.OpenClose

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

المعلّمات

المعلّمات Type الوصف
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. ولمزيد من المعلومات حول تنفيذ استجابات المتابعة، يُرجى الاطّلاع على إشعارات الإجراءات المنزلية الذكية.

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

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

الحقول Type الوصف
followUpToken سلسلة

مطلوب:

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

مطلوب:

نتيجة الطلب

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

SUCCESS
openPercent Number

مطلوب:

يشير هذا المصطلح إلى النسبة المئوية التي تم فتح الجهاز عند إغلاق الجهاز وهي 100.

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

الحقول Type الوصف
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 على false.

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

المعلّمات

المعلّمات Type الوصف
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
  • 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%

أخطاء الجهاز

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