סכימת תכונה של OpenClose לבית חכם

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

מאפייני המכשיר

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

מאפיינים סוג תיאור
discreteOnlyOpenClose בוליאני

(ברירת המחדל: false)

אם המדיניות מוגדרת כ-True, המכשיר חייב להיות פתוח לחלוטין או סגור לחלוטין (כלומר, המכשיר לא תומך בערכים בין 0% ל-100%).
openDirection מערך

רשימת מסלולים נתמכים שבהם המכשיר יכול לפתוח או להיסגר. יש לכלול את המאפיין הזה אם המכשיר תומך בפתיחה ובסגירה ביותר בכיוון אחד.
[item, ...] String

כיוון נתמך.

ערכים נתמכים:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose בוליאני

(ברירת המחדל: false)

מציין אם המכשיר תומך בתקשורת חד-כיוונית (true) או בתקשורת דו-כיוונית (FALSE). יש להגדיר את המאפיין הזה כ-True אם המכשיר לא יכול להגיב ל-Intent של QUERY או למצב דיווח לגבי התכונה הזו.
queryOnlyOpenClose בוליאני

(ברירת המחדל: false)

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

דוגמאות

מכשיר פשוט לסגירה ולפתיחה.

{
  "discreteOnlyOpenClose": true
}

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

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

מכשיר שניתן להשתמש בו רק בפקודה.

{
  "commandOnlyOpenClose": false
}

מכשיר STATES

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

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

פתיחה-סגירה בכיוון אחד

מדינות סוג תיאור
openPercent מספר

חובה.

מציין את אחוז הפתיחה של מכשיר, כאשר 0 סגור ו-100 פתוח לחלוטין.
targetOpenPercent מספר

רמה שמציינת את האחוז הפתוח שאליו יועבר המכשיר או עובר אליו כתוצאה משינוי מתמשך במיקום.

פתיחה וסגירה מרובה כיוונים

מדינות סוג תיאור
openState מערך

חובה.

רשימת המדינות לכל כיוון פתוח נתמך.
[item, ...] מפגע

המצב הנוכחי של כיוון הפתיחה הנתון.
openPercent מספר

חובה.

מציין את אחוז הפתיחה של מכשיר, כאשר 0 סגור ו-100 פתוח לחלוטין.
targetOpenPercent מספר

רמה שמציינת את האחוז הפתוח שאליו יועבר המכשיר או עובר אליו כתוצאה משינוי מתמשך במיקום.
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"
    }
  ]
}

מכשיר COMMANDS

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

action.devices.commands.OpenClose

מגדירים את מצב הסגירה הפתוחה של המכשיר.

פרמטרים

פרמטרים סוג תיאור
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. מידע נוסף על הטמעת תגובות המשך זמין במאמר התראות על פעולות בבית חכם.

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

הפעולה הצליחה

שדות סוג תיאור
followUpToken String

חובה.

האסימון סופק בבקשת ה-EXECUTE המקורית.
status String

חובה.

תוצאת הבקשה.

ערכים נתמכים:

SUCCESS
openPercent מספר

חובה.

מציין את אחוז הפתיחה של מכשיר כאשר 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 מספר

חובה.

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

שגיאות במכשיר

ראו את הרשימה המלאה של שגיאות וחריגים.