Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Akıllı Ev OpenClose İşlem Şeması

action.devices.traits.OpenClose - Bu özellik, açılıp kapanan ve bazı durumlarda kısmen veya tamamen birden fazla yönde açılıp kapanan cihazlara aittir.

Cihaz ÖZELLİKLERİ

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC niyetlerini 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 cihazın tamamen açık veya tamamen kapalı olması gerekir (yani% 0 ile %100 arasında değerleri desteklemez).

openDirection Dizi

Cihazın açılabileceği veya kapatabileceği desteklenen yol tariflerinin listesi. Cihaz birden fazla yönde açılmayı ve 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ü (true) veya iki yönlü (false) iletişimin kullanılmasını destekleyip desteklemediğini belirtir. Cihaz, bu özellik için bir QUERY amacına veya rapor durumuna yanıt vermiyorsa bu özelliği "true" olarak ayarlayın.

queryOnlyOpenClose Boole

(Varsayılan: false)

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

Örnekler

Basit bir açık cihaz.

{
  "discreteOnlyOpenClose": true
}

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

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

Yalnızca komut amaçlı kullanılan cihaz.

{
  "commandOnlyOpenClose": true
}

Cihaz durumu

Bu özelliğe sahip cihazlar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY niyetlerini 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ön açık-kapa

Eyaletler Tür Açıklama
openPercent Number

Zorunludur.

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

Çok yönlü açma/kapatma

Eyaletler Tür Açıklama
openState Dizi

Zorunludur.

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

[item, ...] Nesne

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

openPercent Number

Zorunludur.

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

openDirection Dize

Zorunludur.

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

Desteklenen değerler:

UP
DOWN
LEFT
RIGHT
IN
OUT

Örnekler

Basit bir açık cihaz.

{
  "openPercent": 100
}

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

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

Cihaz FTC'leri

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE niyetlerini 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 kapatma durumunu ayarlayın.

Parametreler

Parametreler Tür Açıklama
openPercent Number

Zorunludur.

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

openDirection Dize

Açılacak yön. Yalnızca cihaz openDirection özelliğinde belirtildiği gibi birden fazla yol tarifini destekliyorsa ve kullanıcı tarafından bir yön belirtilmişse mevcut olur.

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ı yüzde 50 aşağı açın.

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

Cihazın açılma durumu ayarlanırken bir hata oluştu.

Desteklenen değerler:

lockedState
deviceJammingDetected

Yanıtlar

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki takip yanıtını yükleyebilir. Takip yanıtlarını uygulama hakkında daha fazla bilgi için Akıllı ev işlemleri bildirimleri bölümüne bakın.

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

Başarılı

Alanlar Tür Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal Yürütme isteğinde sağlanır.

status Dize

Zorunludur.

İsteğin sonucu.

Desteklenen değerler:

SUCCESS
openPercent Number

Zorunludur.

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

Hata

Alanlar Tür Açıklama
followUpToken Dize

Zorunludur.

Jeton, orijinal Yürütme 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 (ör. lockedState).

Örnekler

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

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

garaj kapısını açın. (başarısızlık durumunda takip yanıtı)

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

action.devices.commands.OpenCloseRelative

Cihazın açma/kapatma durumunu geçerli duruma göre ayarlayın. Bu komut yalnızca commandOnlyOpenClose, true olarak ayarlanmışsa kullanılabilir.

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

Parametreler

Parametreler Tür Açıklama
openRelativePercent Number

Zorunludur.

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

openDirection Dize

Açılacak yön. Yalnızca cihaz openDirection özelliğinde belirtildiği gibi birden fazla yol tarifini 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 kapat

{
  "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çılma durumu ayarlanırken bir hata oluştu.

Desteklenen değerler:

lockedState
deviceJammingDetected

Örnek sözler

de-DE

  • Bitte öffne die Jalousien auf 30%
  • Fensterläden um 25 % schliessen
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • 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
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • 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%

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
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • Abrir janela 50%
  • Fecha a persiana toda
  • Fechar a janela 10%
  • 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
  • öppna persiennerna med 25%

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.