Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Akıllı Ev OpenClose Trait Şeması

action.devices.traits.OpenClose: Bu özellik, açılıp kapanmayı destekleyen, bazı durumlarda ise kısmen veya muhtemelen birden fazla yönde açılabilen ve kapatılabilen 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 için Amaç karşılama bölümüne bakın.

Özellikler Type Açıklama
discreteOnlyOpenClose Boole

(Varsayılan: false)

Doğru değerine ayarlanırsa cihazın tamamen açık veya tamamen kapalı olması (yani% 0 ile %100 arasındaki değerleri desteklemediği) anlamına gelir.

openDirection Dizi

Cihazın açabileceği veya kapatabileceği desteklenen yol tariflerinin listesi. Cihaz birden fazla yönde açılıp kapanmayı destekliyorsa bu özelliği ekleyin.

[item, ...] Dize

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 doğru olarak ayarlayın.

queryOnlyOpenClose Boole

(Varsayılan: false)

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

Örnekler

Basit, açık kapatılabilen cihaz.

{
  "discreteOnlyOpenClose": true
}

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

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

Yalnızca komut kullanılan cihaz.

{
  "commandOnlyOpenClose": false
}

Cihaz STATUS

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

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

Tek yön açık kapatma

Eyaletler Type Açıklama
openPercent Number

Zorunludur.

0'ın kapalı ve 100'ün tamamen açık olduğu bir cihazın açılma yüzdesini gösterir.

Çok yönlü açma/kapatma

Eyaletler Type Açıklama
openState Dizi

Zorunludur.

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

[item, ...] Nesne

Verilen açık yol tarifinin mevcut durumu.

openPercent Number

Zorunludur.

0'ın kapalı ve 100'ün tamamen açık olduğu bir cihazın açılma yüzdesini gösterir.

openDirection Dize

Zorunludur.

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

Desteklenen değerler:

UP
DOWN
LEFT
RIGHT
IN
OUT

Örnekler

Basit, açık kapatılabilen cihaz.

{
  "openPercent": 100
}

Cihazı% 30 aşağı, %50 yukarı doğru açın.

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

Cihaz Komisyonları

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 için Amaç karşılama bölümüne bakın.

action.devices.commands.OpenClose

Cihazın açık kapanma durumunu ayarlayın.

Parametreler

Parametreler Type Açıklama
openPercent Number

Zorunludur.

0'ın kapalı ve 100'ün tamamen açık olduğu bir cihazın açılma yüzdesini gösterir.

openDirection Dize

Açılacak yön. Yalnızca cihaz birden fazla yol tarifini desteklediğinde (openDirection özelliği tarafından belirtildiği şekilde) ve kullanıcı tarafından belirtilen bir yön varsa kullanılabilir.

Desteklenen değerler:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken Dize

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ı %50 aşağı doğru açın.

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

Cihazın açık kapanma 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ı uygulama hakkında daha fazla bilgi için Akıllı ev İşlemleri bildirimlerine bakın.

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

Başarılı

Alanlar Type Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal EXECUTE isteğinde sağlanır.

status Dize

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
openPercent Number

Zorunludur.

0'ın kapalı ve 100'ün tamamen açık olduğu bir cihazın açılma yüzdesini gösterir.

Hata

Alanlar Type Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal EXECUTE isteğinde sağlanır.

status Dize

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

FAILURE
errorCode Dize

Zorunludur.

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

Örnekler

garaj kapısını açın. (başarılı durum için takip yanıtı)

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

garaj kapısını açın. (hata durumunda destek kaydı)

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

action.devices.commands.OpenCloseRelative

Cihazın mevcut kapanma durumunu geçerli 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 Type Açıklama
openRelativePercent Number

Zorunludur.

Açık kapanma durumunu değiştirmek için kullanılan tam yüzde. Belirsiz göreli komutlar tam yüzde parametresine dönüştürülecektir (örneğin, "panjurları biraz daha aç" yerine "panjurları %5 aç"").

openDirection Dize

Açılacak yön. Yalnızca cihaz birden fazla yol tarifini desteklediğinde (openDirection özelliği tarafından belirtildiği şekilde) ve kullanıcı tarafından belirtilen bir yön varsa kullanılabilir.

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 kapalı tutun

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

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

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

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