Smart Home OpenClose Trait Schema

action.devices.traits.OpenClose: Bu özellik, açma ve kapamayı, bazı durumlarda ise kısmen veya birden fazla yönde açma ve kapamayı destekleyen cihazlara aittir.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacın karşılanması başlıklı makaleyi inceleyin.

Özellikler Tür Açıklama
discreteOnlyOpenClose Boole

(Varsayılan: false)

Doğru olarak ayarlandığında, cihazın tamamen açık veya tamamen kapalı olması gerektiğini (yani% 0 ile %100 arasındaki değerleri desteklemediğini) gösterir.
openDirection Array

Cihazın açılabileceği veya kapatılabileceği desteklenen yönlerin listesi. Cihaz birden fazla yönde açılıp kapanmayı destekliyorsa bu özelliği ekleyin.
[item, ...] String

Desteklenen yön.

Desteklenen değerler:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Boole

(Varsayılan: false)

Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimi destekleyip desteklemediğini gösterir. Cihaz, bu özellik için QUERY amacına veya durum raporuna yanıt veremiyorsa bu özelliği true olarak ayarlayın.
queryOnlyOpenClose Boole

(Varsayılan: false)

Cihazın yalnızca durum bilgileri için sorgulanıp sorgulanamayacağını ve kontrol edilip edilemeyeceğini gösterir. Yalnızca açık durumu bildirebilen sensörler bu alanı doğru olarak ayarlamalıdır.

Örnekler

Basit açma-kapama cihazı.

{
  "discreteOnlyOpenClose": true
}

Yukarıdan aşağıya ve aşağıdan yukarıya cihaz. İki yönde de açılabilir.

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

Yalnızca komut cihazı.

{
  "commandOnlyOpenClose": false
}

Cihaz DURUMLARI

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacın karşılanması başlıklı makaleyi inceleyin.

Yük aşağıdakilerden birini içeriyor:

Tek yönlü açma-kapama

Eyaletler Tür Açıklama
openPercent Number

Zorunludur.

Bir cihazın açılma yüzdesini gösterir. 0 kapalı, 100 ise tamamen açık anlamına gelir.
targetOpenPercent Number

Cihazın, devam eden bir konum değişikliği sonucunda gideceği veya hareket ettiği açık yüzdesini gösteren seviye.

Çok yönlü açma-kapama

Eyaletler Tür Açıklama
openState Array

Zorunludur.

Desteklenen her açık yön için eyaletlerin listesi.
[item, ...] Nesne

Belirli bir açık yön için geçerli durum.
openPercent Number

Zorunludur.

Bir cihazın açılma yüzdesini gösterir. 0 kapalı, 100 ise tamamen açık anlamına gelir.
targetOpenPercent Number

Cihazın, devam eden bir konum değişikliği sonucunda gideceği veya hareket ettiği açık yüzdesini gösteren seviye.
openDirection String

Zorunludur.

Cihazın açıldığı yön.

Desteklenen değerler:

UP
DOWN
LEFT
RIGHT
IN
OUT

Örnekler

Basit açma-kapama cihazı.

{
  "openPercent": 100
}

Basit açma-kapama cihazı şu anda yeni bir konuma açılıyor.

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

Cihazı aşağı yönde% 30, yukarı yönde% 50 aç.

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

Cihazı aşağı yönde% 30, yukarı yönde% 50 aç. Şu anda yukarı yönde% 80 açılıyor.

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

Cihaz KOMUTLARI

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını ele alma hakkında daha fazla bilgi edinmek için Amacın karşılanması başlıklı makaleyi inceleyin.

action.devices.commands.OpenClose

Cihazın açık/kapalı durumunu ayarlayın.

Parametreler

Parametreler Tür Açıklama
openPercent Number

Zorunludur.

Bir cihazın açılma yüzdesini gösterir. 0 kapalı, 100 ise tamamen açık anlamına gelir.
openDirection String

Açılma yönü. Yalnızca cihazın openDirection özelliğiyle belirtildiği gibi birden fazla yönü desteklemesi ve kullanıcının bir yön belirtmesi durumunda gösterilir.

Desteklenen değerler:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

Takip yanıtı için Google tarafından sağlanan jeton.

Örnekler

Cihazı açın.

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

Cihazı yüzde 50 aç.

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

Cihazın açık/kapalı durumu ayarlanırken bir hata oluştu.

Desteklenen değerler:

lockedState
deviceJammingDetected

Ek yanıtlar

Bu özelliğe sahip cihazlar, EXECUTE işlemi kapsamında aşağıdaki takip yanıtı yükünü döndürebilir. Takip yanıtlarını uygulama hakkında daha fazla bilgi edinmek için Akıllı ev işlemleri için bildirimler başlıklı makaleye bakın.

Yük aşağıdakilerden birini içeriyor:

Başarılı

Alanlar Tür Açıklama
followUpToken String

Zorunludur.

Orijinal EXECUTE isteğinde sağlanan jeton.
status String

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
openPercent Number

Zorunludur.

Bir cihazın açılma yüzdesini gösterir. 0 kapalı, 100 ise tamamen açık anlamına gelir.

Hata

Alanlar Tür Açıklama
followUpToken String

Zorunludur.

Orijinal EXECUTE isteğinde sağlanan jeton.
status String

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

FAILURE
errorCode String

Zorunludur.

Değer, bu özellik için herhangi bir hata kodu olabilir. Örneğin, lockedState.

Örnekler

Garaj kapısını aç. (Başarı durumuna yönelik takip yanıtı)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

Garaj kapısını aç. (follow-up response for failure case)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

action.devices.commands.OpenCloseRelative

Cihazın açma/kapama durumunu mevcut duruma göre ayarlayın. Bu komut yalnızca discreteOnlyOpenClose, false olarak ayarlandıysa kullanılabilir.

Bu komut için aşağıdaki özellikler gerekir: 
{
  "discreteOnlyOpenClose": false
}

Parametreler

Parametreler Tür Açıklama
openRelativePercent Number

Zorunludur.

Açık/kapalı durumunu değiştirmek için gereken tam yüzde. Belirsiz göreceli komutlar, tam bir yüzde parametresine dönüştürülür (örneğin, "Panjurları biraz daha aç" yerine "Panjurları %5 aç").
openDirection String

Açılma yönü. Yalnızca cihazın openDirection özelliğiyle belirtildiği gibi birden fazla yönü desteklemesi ve kullanıcının bir yön belirtmesi durumunda gösterilir.

Desteklenen değerler:

UP
DOWN
LEFT
RIGHT
IN
OUT

Örnekler

Cihazı biraz daha açın

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

Cihazı% 10 daha fazla kapatın

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

Cihazı% 50 daha fazla açın.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

Cihazın açık/kapalı durumu ayarlanırken bir hata oluştu.

Desteklenen değerler:

lockedState
deviceJammingDetected

Örnek ifadeler

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%

Cihaz HATALARI

Hata ve istisnaların tam listesini inceleyin.