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

‫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 אם המכשיר לא יכול להגיב לאינטנט QUERY או ל-Report State עבור התכונה הזו.
queryOnlyOpenClose בוליאני

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

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

דוגמאות

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

{
  "discreteOnlyOpenClose": true
}

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

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

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

{
  "commandOnlyOpenClose": false
}

מצבי המכשיר

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

המטען הייעודי (payload) מכיל את אחד מהערכים הבאים:

Single direction open-close

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

חובה.

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

הערך צריך להיות בין 0 ל-100.
targetOpenPercent Number

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

הערך צריך להיות בין 0 ל-100.

פתיחה וסגירה של כמה מסלולי נסיעה

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

חובה.

רשימת המצבים לכל כיוון פתיחה נתמך.
[item, ...] אובייקט

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

חובה.

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

הערך צריך להיות בין 0 ל-100.
targetOpenPercent Number

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

הערך צריך להיות בין 0 ל-100.
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 הוא פתוח לגמרי.

הערך צריך להיות בין 0 ל-100.
openDirection String

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

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

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

אסימון ש-Google מספקת לתשובה להמשך השיחה.

דוגמאות

פותחים את המכשיר.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

Open device 50 percent down.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

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

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

lockedState
deviceJammingDetected

תשובות המשך

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

המטען הייעודי (payload) מכיל את אחד מהערכים הבאים:

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

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

חובה.

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

חובה.

תוצאת הבקשה.

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

SUCCESS
openPercent Number

חובה.

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

הערך צריך להיות בין 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

שינוי מצב הפתיחה והסגירה של המכשיר ביחס למצב הנוכחי. הפקודה הזו זמינה רק אם discreteOnlyOpenClose מוגדר ל-false.

הפקודה הזו דורשת את המאפיינים הבאים: 
{
  "discreteOnlyOpenClose": false
}

פרמטרים

פרמטרים סוג תיאור
openRelativePercent Number

חובה.

האחוז המדויק לשינוי הסטטוס של העסק (פתוח/סגור). פקודות יחסיות לא ברורות יומרו לפרמטר מדויק של אחוזים (לדוגמה, "Open the blinds a little more" לעומת "Open the blinds by 5%").

הערך צריך להיות בין -100 ל-100.
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%

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

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