Akıllı Ev Açık Kapalı Özelliği Şeması

action.devices.traits.OpenClose: Bu özellik, açma ve kapama işlemlerini destekleyen ve bazı durumlarda kısmen veya potansiyel olarak birden fazla yönde açma ve kapama işlemlerini destekleyen cihazlara aittir.

CİHAZ ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işlemi kapsamında aşağıdaki özellikleri bildirebilir. SYNC intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

Ö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çılabileceği veya kapanabileceği desteklenen yol tariflerinin listesi. Cihaz birden fazla yönde açılmayı ve 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 belirtir. Cihaz, bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremezse 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 belirtir. Yalnızca açık durumu bildirebilen sensörler bu alanı true olarak ayarlamalıdır.

Örnekler

Basit açma/kapatma cihazı.

{
  "discreteOnlyOpenClose": true
}

Yukarıdan aşağıya aşağıdan yukarıya bakan cihaz. Her iki yönde de açılabilir.

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

Yalnızca komut kullanılan cihaz.

{
  "commandOnlyOpenClose": false
}

Cihaz DURUMLARI

Bu özelliğe sahip öğeler, QUERY işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.

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

Tek yönlü açma/kapatma

Eyaletler Tür Açıklama
openPercent Number

Zorunludur.

Bir cihazın açık olma yüzdesini belirtir. 0 kapalı, 100 ise tamamen açık anlamına gelir.
targetOpenPercent Number

Cihazın gideceği veya konumdaki devam eden bir değişiklik sonucunda hareket ettiği açık yüzdeyi gösteren düzey.

Birden fazla yönde açma/kapatma

Eyaletler Tür Açıklama
openState Dizi

Zorunludur.

Her desteklenen açık yön için durumların listesi.
[item, ...] Nesne

Belirtilen açık yönün mevcut durumu.
openPercent Number

Zorunludur.

Bir cihazın açık olma yüzdesini belirtir. 0 kapalı, 100 ise tamamen açık anlamına gelir.
targetOpenPercent Number

Konumdaki sürekli değişiklik nedeniyle cihazın nereye gideceği veya taşınacağı 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çma/kapatma cihazı.

{
  "openPercent": 100
}

Basit açma/kapatma cihazı şu anda yeni bir konumda 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ı yönde %50 açın. Şu anda yukarı yönde %80'e doğru ilerliyoruz.

{
  "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 intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent karşılama 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çık olma yüzdesini belirtir. 0 kapalı, 100 ise tamamen açık anlamına gelir.
openDirection String

Açılacak yön. Yalnızca cihaz, openDirection özelliğiyle belirtildiği gibi birden çok yönü destekliyorsa ve kullanıcı tarafından bir yön belirtilmişse 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şağı açın.

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

Cihazın açık kapatma 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ü 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ı makaleyi inceleyin.

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

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çık olma yüzdesini belirtir. 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 (ör. 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. (follow-up response for failure case)

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

action.devices.commands.OpenCloseRelative

Cihazın açık kapanma durumunu mevcut duruma göre 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ı durumunu değiştirmek için 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 oranında aç").
openDirection String

Açılacak yön. Yalnızca cihaz, openDirection özelliğiyle belirtildiği gibi birden çok yönü destekliyorsa ve kullanıcı tarafından bir yön belirtilmişse 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ı aşağı doğru %50 daha açın.

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

Cihazın açık kapatma 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

Hataların ve istisnaların tam listesini inceleyin.