Skema Trait OpenClose Smart Home

action.devices.traits.OpenClose - Sifat ini dimiliki oleh perangkat yang mendukung pembukaan dan penutupan, dan dalam beberapa kasus membuka dan menutup sebagian atau berpotensi dalam lebih dari satu arah.

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani intent SYNC, lihat Fulfillment intent.

Atribut Jenis Deskripsi
discreteOnlyOpenClose Boolean

(Default: false)

Jika ditetapkan ke benar, ini menunjukkan bahwa perangkat harus terbuka sepenuhnya atau tertutup sepenuhnya (yaitu, tidak mendukung nilai antara 0% dan 100%).
openDirection Array

Daftar arah yang didukung tempat perangkat dapat dibuka atau ditutup. Sertakan atribut ini jika perangkat mendukung pembukaan dan penutupan dalam lebih dari satu arah.
[item, ...] String

Arah yang didukung.

Nilai yang didukung:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (true) atau dua arah (false). Tetapkan atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Status Pelaporan untuk karakteristik ini.
queryOnlyOpenClose Boolean

(Default: false)

Menunjukkan apakah perangkat hanya dapat dikueri untuk informasi status dan tidak dapat dikontrol. Sensor yang hanya dapat melaporkan status terbuka harus menetapkan kolom ini ke true.

Contoh

Perangkat buka-tutup sederhana.

{
  "discreteOnlyOpenClose": true
}

Perangkat top-down bottom-up. Dapat dibuka dalam kedua arah.

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

Perangkat khusus perintah.

{
  "commandOnlyOpenClose": false
}

Status PERANGKAT

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat fulfillment intent.

Payload berisi salah satu hal berikut:

Buka-tutup satu arah

Negara bagian Jenis Deskripsi
openPercent Number

Wajib.

Menunjukkan persentase perangkat yang terbuka, dengan 0 berarti tertutup dan 100 berarti terbuka sepenuhnya.
targetOpenPercent Number

Level yang menunjukkan persentase terbuka tempat perangkat akan pergi atau berpindah sebagai akibat dari perubahan posisi yang sedang berlangsung.

Buka-tutup beberapa arah

Negara bagian Jenis Deskripsi
openState Array

Wajib.

Daftar status untuk setiap arah terbuka yang didukung.
[item, ...] Objek

Status saat ini untuk arah terbuka yang ditentukan.
openPercent Number

Wajib.

Menunjukkan persentase perangkat yang terbuka, dengan 0 berarti tertutup dan 100 berarti terbuka sepenuhnya.
targetOpenPercent Number

Level yang menunjukkan persentase terbuka tempat perangkat akan berpindah atau sedang berpindah sebagai akibat dari perubahan posisi yang sedang berlangsung.
openDirection String

Wajib.

Arah perangkat dibuka.

Nilai yang didukung:

UP
DOWN
LEFT
RIGHT
IN
OUT

Contoh

Perangkat buka-tutup sederhana.

{
  "openPercent": 100
}

Perangkat sederhana dengan sistem buka-tutup, saat ini membuka ke posisi baru.

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

Buka perangkat sebesar 30% ke arah bawah, dan 50% ke arah atas.

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

Buka perangkat sebesar 30% ke arah bawah, dan 50% ke arah atas, saat ini berpindah ke 80% ke arah atas.

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

Perangkat COMMANDS

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat fulfillment intent.

action.devices.commands.OpenClose

Menyetel status buka-tutup perangkat.

Parameter

Parameter Jenis Deskripsi
openPercent Number

Wajib.

Menunjukkan persentase perangkat yang terbuka, dengan 0 berarti tertutup dan 100 berarti terbuka sepenuhnya.
openDirection String

Arah untuk membuka. Hanya ada jika perangkat mendukung beberapa arah, seperti yang ditunjukkan oleh atribut openDirection, dan arah ditentukan oleh pengguna.

Nilai yang didukung:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

Token yang disediakan Google untuk respons tindak lanjut.

Contoh

Buka perangkat.

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

Buka perangkat 50 persen ke bawah.

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

Terjadi error saat menetapkan status buka-tutup perangkat.

Nilai yang didukung:

lockedState
deviceJammingDetected

Respons tindak lanjut

Perangkat dengan karakteristik ini dapat menampilkan payload respons tindak lanjut berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penerapan respons lanjutan lebih lanjut, lihat Notifikasi untuk Action smart home.

Payload berisi salah satu hal berikut:

Berhasil

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token yang diberikan dalam permintaan EXECUTE asli.
status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

SUCCESS
openPercent Number

Wajib.

Menunjukkan persentase perangkat yang terbuka dengan 0 berarti tertutup dan 100 berarti terbuka sepenuhnya.

Gagal

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token yang diberikan dalam permintaan EXECUTE asli.
status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

FAILURE
errorCode String

Wajib.

Nilainya dapat berupa kode error apa pun untuk karakteristik ini, misalnya, lockedState.

Contoh

Buka pintu garasi. (respons lanjutan untuk kasus sukses)

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

Buka pintu garasi. (respons tindak lanjut untuk kasus kegagalan)

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

action.devices.commands.OpenCloseRelative

Sesuaikan status buka-tutup perangkat relatif terhadap status saat ini. Perintah ini hanya tersedia jika commandOnlyOpenClose disetel ke false.

Perintah ini memerlukan atribut berikut: 
{
  "commandOnlyOpenClose": false
}

Parameter

Parameter Jenis Deskripsi
openRelativePercent Number

Wajib.

Persentase yang tepat untuk mengubah status buka-tutup. Perintah relatif yang ambigu akan dikonversi menjadi parameter persentase yang tepat (misalnya, "Buka tirai lebih banyak lagi" vs "Buka tirai sebesar 5%").
openDirection String

Arah untuk membuka. Hanya ada jika perangkat mendukung beberapa arah, seperti yang ditunjukkan oleh atribut openDirection, dan arah ditentukan oleh pengguna.

Nilai yang didukung:

UP
DOWN
LEFT
RIGHT
IN
OUT

Contoh

Buka perangkat sedikit lebih lebar

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

Menutup perangkat 10% lebih banyak

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

Buka perangkat 50% lebih banyak, ke bawah.

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

Terjadi error saat menetapkan status buka-tutup perangkat.

Nilai yang didukung:

lockedState
deviceJammingDetected

Contoh ucapan

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%

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.