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

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

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

דוגמאות

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

{
  "discreteOnlyOpenClose": true
}

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

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

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

{
  "commandOnlyOpenClose": false
}

מצבי המכשיר

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

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

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

מדינות סוג תיאור
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"
    }
  ]
}

פקודות למכשיר

מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות כחלק מהפעולה 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

תשובות למעקב

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

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

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

שדות סוג תיאור
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"
    }
  }
}

פותחים את דלת המוסך. (follow-up response for failure case)

{
  "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%

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

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