סכימה של גרסת OpenClose לבתים חכמים

action.devices.traits.OpenClose - התכונה הזו שייכת למכשירים שתומכים בפתיחה וסגירה, ובמקרים מסוימים הם נפתחים או נסגרים באופן חלקי או בכיוון מסוים.

ATTRIBUTES במכשיר

מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC. מידע נוסף על טיפול ב-SYNC כוונות זמין בקטע מימוש כוונה.

מאפיינים	Type	תיאור
discreteOnlyOpenClose	בוליאני	(ברירת מחדל: false) כשהמדיניות מקבלת את הערך True, צריך לציין שהמכשיר פתוח או סגור באופן מלא (כלומר, הוא לא תומך בערכים בין 0% ל-100%).
openDirection	מערך	רשימת הוראות נסיעה נתמכות שבהן המכשיר יכול לפתוח או לסגור. יש לכלול את המאפיין הזה אם המכשיר תומך בפתיחה ובסגירה ביותר מכיוון אחד.
[item, ...]	String	הכיוון הנתמך. ערכים נתמכים: UP DOWN LEFT RIGHT IN OUT
commandOnlyOpenClose	בוליאני	(ברירת מחדל: false) מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונת QUERY או למצב הדוח עבור התכונה הזו.
queryOnlyOpenClose	בוליאני	(ברירת מחדל: false) מציינת אם ניתן לשלוח שאילתה לגבי המכשיר רק לגבי מידע על המדינה ולא ניתן לשלוט בו. החיישנים שיכולים לדווח רק על מצב פתוח צריכים להגדיר את השדה הזה כ-True.

דוגמאות

המכשיר פשוט נסגר.

{
  "discreteOnlyOpenClose": true
}

מכשיר כלפי מטה מלמעלה למטה. אפשר לפתוח בכל כיוון.

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

מכשיר עם פקודה בלבד.

{
  "commandOnlyOpenClose": false
}

מצבים של המכשיר

ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים במסגרת הפעולה QUERY. מידע נוסף על טיפול ב-QUERY כוונות זמין בקטע מימוש כוונה.

המטען הייעודי כולל אחד מהבאים:

כיוון אחד סגור

מדינות	Type	תיאור
openPercent	מספר	חובה. מציין את אחוז שבו המכשיר פתוח, כאשר 0 סגור ו-100 פתוח.

מספר כיוונים פתוחים

מדינות	Type	תיאור
openState	מערך	חובה. רשימת מצבים לכל כיוון פתוח נתמך.
[item, ...]	אובייקט	המצב הנוכחי של הכיוון הפתוח.
openPercent	מספר	חובה. מציין את אחוז שבו המכשיר פתוח, כאשר 0 סגור ו-100 פתוח.
openDirection	String	חובה. הכיוון שבו המכשיר נפתח. ערכים נתמכים: UP DOWN LEFT RIGHT IN OUT

דוגמאות

המכשיר פשוט נסגר.

{
  "openPercent": 100
}

יש לפתוח את המכשיר ב-30% בכיוון הלמטה, וב-50% בכיוון מעלה.

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

פקודות מכשיר

מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות, במסגרת הפעולה EXECUTE. מידע נוסף על טיפול ב-EXECUTE כוונות זמין בקטע מימוש כוונה.

action.devices.commands.OpenClose

הגדרת מצב סגירה של המכשיר.

פרמטרים

פרמטרים	Type	תיאור
openPercent	מספר	חובה. מציין את אחוז שבו המכשיר פתוח, כאשר 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

תשובות להמשך טיפול

מכשירים עם התכונה הזו עשויים להחזיר את המטען הייעודי (payload) של התגובה הבאה כחלק מהפעולה של EXECUTE. מידע נוסף על הטמעת התשובות למעקב מפורט במאמר התראות על פעולות בבית החכם.

המטען הייעודי כולל אחד מהבאים:

כרטיס החיפוש עודכן

שדות	Type	תיאור
followUpToken	String	חובה. האסימון סופק בבקשה המקורית להחרגה.
status	String	חובה. התוצאה של הבקשה. ערכים נתמכים: SUCCESS
openPercent	מספר	חובה. מציין את האחוז שבו המכשיר נפתח כאשר 0 סגור ו-100 נפתח באופן מלא.

כשל

שדות	Type	תיאור
followUpToken	String	חובה. האסימון סופק בבקשה המקורית להחרגה.
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
}

פרמטרים

פרמטרים	Type	תיאור
openRelativePercent	מספר	חובה. האחוז המדויק שבו יש לשנות את מצב הסגירה. פקודות יחסיות דו-משמעיות יומרו לפרמטר אחוז מדויק (לדוגמה, "פתחו את התריסים קצת יותר" לעומת "פתח את התריסים ב-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%

ERRORS מכשיר

לצפייה ברשימה המלאה של השגיאות והחריגים