Akıllı Ev OpenClose Trait Şeması

action.devices.traits.OpenClose: Bu özellik, açıp kapatmayı destekleyen ve bazı durumlarda kısmen ya da birden fazla yönde açılıp kapanabilen cihazlara aittir.

Cihaz ATTRIBUTES

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Özellikler Tür Açıklama
discreteOnlyOpenClose Boole

(Varsayılan: false)

Doğru değerine ayarlandığında bu, cihazın tamamen açık veya tamamen kapalı olması gerektiğini (yani% 0 ile %100 arasındaki değerleri desteklemediğini) belirtir.

openDirection Dizi

Cihazın açılıp kapanabileceği desteklenen yol tariflerinin 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şimin kullanılmasını destekleyip desteklemediğini belirtir. Cihaz bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremiyorsa bu özelliği true olarak ayarlayın.

queryOnlyOpenClose Boole

(Varsayılan: false)

Cihazın yalnızca durum bilgisi için sorgulanabileceğini ve kontrol edilemeyeceğini belirtir. Yalnızca açık durum raporlayabilen sensörler bu alanı true olarak ayarlamalıdır.

Örnekler

Basit açık kapanan cihaz.

{
  "discreteOnlyOpenClose": true
}

Yukarıdan aşağı, aşağıdan yukarıya doğru cihaz. Her iki yönde açılabilir.

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

Yalnızca komut içeren cihaz.

{
  "commandOnlyOpenClose": false
}

Cihaz STATES

Bu özelliğe sahip varlıklar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

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

Tek yönlü açık-kapat

Eyaletler Tür Açıklama
openPercent Number

Zorunludur.

Bir cihazın açılma yüzdesini belirtir. 0 kapalı, 100 ise tamamen açık olur.

targetOpenPercent Number

Konumda devam eden bir değişiklik nedeniyle cihazın nereye gideceği veya taşınacağı konusunda açık yüzdeyi gösteren seviye.

Çok yönlü açık-kapat

Eyaletler Tür Açıklama
openState Dizi

Zorunludur.

Desteklenen her bir açık yön için durum listesi.

[item, ...] Nesne

Belirtilen açık yön için mevcut durum.

openPercent Number

Zorunludur.

Bir cihazın açılma yüzdesini belirtir. 0 kapalı, 100 ise tamamen açık olur.

targetOpenPercent Number

Konumda devam eden bir değişiklik nedeniyle cihazın nereye gideceği veya taşınacağı konusunda açık yüzdeyi gösteren seviye.

openDirection String

Zorunludur.

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

Desteklenen değerler:

UP
DOWN
LEFT
RIGHT
IN
OUT

Örnekler

Basit açık kapanan cihaz.

{
  "openPercent": 100
}

Basit açık-kapalı cihaz şu anda yeni bir konuma açılıyor.

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

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

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

Cihazı aşağı yönde% 30, yukarıya doğru% 50 oranında açın. Şu anda yukarı yönde% 80'e yükseliyor.

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

Cihaz COMMANDS

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

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 belirtir. 0 kapalı, 100 ise tamamen açık olur.

openDirection String

Açılacak yön. Yalnızca cihaz, openDirection özelliğiyle birlikte birden fazla yönü destekliyorsa ve kullanıcı tarafından bir yön belirtilmişse mevcut olur.

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şağıda olacak şekilde açın.

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

Takip yanıtları

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki takip yanıtı yükünü döndürebilir. Takip yanıtlarının uygulanması hakkında daha fazla bilgi edinmek için Akıllı ev İşlemleri bildirimleri başlıklı makaleyi inceleyin.

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

Başarılı

Alanlar Tür Açıklama
followUpToken String

Zorunludur.

Jeton, orijinal EXECUTE isteğinde sağlandı.

status String

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
openPercent Number

Zorunludur.

0 kapalı, 100 tamamen açık olduğunda bir cihazın açılma yüzdesini belirtir.

Hata

Alanlar Tür Açıklama
followUpToken String

Zorunludur.

Jeton, orijinal EXECUTE isteğinde sağlandı.

status String

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

FAILURE
errorCode String

Zorunludur.

Değer, bu özelliğe ait herhangi bir hata kodu olabilir; örneğin, lockedState.

Örnekler

Garaj kapısını açın. (başarılı destek kaydı için takip yanıtı)

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

Garaj kapısını açın. (başarısız sonuç için takip yanıtı)

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

action.devices.commands.OpenCloseRelative

Mevcut duruma göre cihazın açık-kapalı durumunu ayarlayın. Bu komut yalnızca commandOnlyOpenClose, false olarak ayarlandıysa kullanılabilir.

Bu komut, aşağıdaki özellikleri gerektirir:
{
  "commandOnlyOpenClose": false
}

Parametreler

Parametreler Tür Açıklama
openRelativePercent Number

Zorunludur.

Açık-kapalı durumunun değiştirileceği tam yüzde. Belirsiz göreli komutlar, tam yüzde parametresine dönüştürülür (örneğin, "Panjurları biraz daha aç" ve "Panjurları %5 aç").

openDirection String

Açılacak yön. Yalnızca cihaz, openDirection özelliğiyle birlikte birden fazla yönü destekliyorsa ve kullanıcı tarafından bir yön belirtilmişse mevcut olur.

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

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

Cihazı% 50 daha fazla, aşağı doğru aç.

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

Hataların ve istisnaların tam listesine bakın.