Selamat datang di Pusat Developer Google Home, tempat baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.

Halaman ini diterjemahkan oleh Cloud Translation API.

Switch to English

Skema Trait OpenClose Smart Home

action.devices.traits.OpenClose - Trait ini milik perangkat yang mendukung pembukaan dan penutupan, dan dalam beberapa kasus membuka dan menutup sebagian atau mungkin di lebih dari satu arah.

ATTRIBUTE Perangkat

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

Atribut	Type	Deskripsi
`discreteOnlyOpenClose`	Boolean	(Default: `false`) Jika disetel ke benar (true), hal ini menunjukkan bahwa perangkat harus terbuka sepenuhnya atau tertutup sepenuhnya (artinya, perangkat tidak mendukung nilai antara 0% dan 100%).
`openDirection`	Array	Daftar petunjuk arah yang didukung yang dapat digunakan untuk membuka atau menutup perangkat. Sertakan atribut ini jika perangkat mendukung buka dan tutup di 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 (benar) atau dua arah (salah). Setel atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini.
`queryOnlyOpenClose`	Boolean	(Default: `false`) Menunjukkan jika perangkat hanya bisa dikueri untuk informasi status dan tidak bisa dikontrol. Sensor yang hanya dapat melaporkan status terbuka harus menetapkan kolom ini ke benar (true).

Contoh

Perangkat buka-buka sederhana.

{
  "discreteOnlyOpenClose": true
}

Perangkat dari bawah ke atas yang vertikal. Dapat dibuka di 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

Status Type Deskripsi

Status	Type	Deskripsi
`openPercent`	Number	Wajib. Menunjukkan persentase perangkat dibuka, dengan 0 tertutup dan 100 terbuka sepenuhnya.

openPercent

Number

Wajib.

Menunjukkan persentase perangkat dibuka, dengan 0 tertutup dan 100 terbuka sepenuhnya.

Buka-tutup beberapa arah

Status	Type	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 dibuka, dengan 0 tertutup dan 100 terbuka sepenuhnya.
`openDirection`	String	Wajib. Arah saat perangkat dibuka. Nilai yang didukung: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

Contoh

Perangkat buka-buka sederhana.

{
  "openPercent": 100
}

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

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

Perangkat COMMAND

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`

Menetapkan status buka-tutup perangkat.

Parameter

Parameter Type Deskripsi

Parameter	Type	Deskripsi
`openPercent`	Number	Wajib. Menunjukkan persentase perangkat dibuka, dengan 0 tertutup dan 100 terbuka sepenuhnya.
`openDirection`	String	Arah buka. Hanya ada jika perangkat mendukung beberapa rute, seperti yang ditunjukkan oleh atribut `openDirection`, dan rute ditentukan oleh pengguna. Nilai yang didukung: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	String	Token yang diberikan Google untuk respons tindak lanjut.

openPercent

Number

Wajib.

Menunjukkan persentase perangkat dibuka, dengan 0 tertutup dan 100 terbuka sepenuhnya.

openDirection

String

Arah buka. Hanya ada jika perangkat mendukung beberapa rute, seperti yang ditunjukkan oleh atribut openDirection, dan rute ditentukan oleh pengguna.

Nilai yang didukung:

UP
DOWN
LEFT
RIGHT
IN
OUT

followUpToken

String

Token yang diberikan Google untuk respons tindak lanjut.

Contoh

Buka perangkat.

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

Buka perangkat 50 persen bawah.

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

Terjadi error saat menyetel status buka-tutup perangkat.

Nilai yang didukung:

lockedState
deviceJammingDetected

Tindak lanjut tanggapan

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

Payload berisi salah satu hal berikut:

Berhasil

Kolom Type Deskripsi

Kolom	Type	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 dibuka dengan 0 tertutup dan 100 terbuka sepenuhnya.

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 dibuka dengan 0 tertutup dan 100 terbuka sepenuhnya.

Kegagalan

Kolom Type Deskripsi

Kolom	Type	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 fitur ini, misalnya, `lockedState`.

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 fitur ini, misalnya, lockedState.

Contoh

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

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

Menyesuaikan 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 Type Deskripsi

Parameter	Type	Deskripsi
`openRelativePercent`	Number	Wajib. Persentase yang tepat untuk mengubah status buka-tutup. Perintah relatif yang tidak besar akan dikonversi ke parameter persentase yang tepat (misalnya, "Buka tirai sedikit lebih" vs "Buka tirai sebesar 5%").
`openDirection`	String	Arah buka. Hanya ada jika perangkat mendukung beberapa rute, seperti yang ditunjukkan oleh atribut `openDirection`, dan rute ditentukan oleh pengguna. Nilai yang didukung: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

Number

Wajib.

Persentase yang tepat untuk mengubah status buka-tutup. Perintah relatif yang tidak besar akan dikonversi ke parameter persentase yang tepat (misalnya, "Buka tirai sedikit lebih" vs "Buka tirai sebesar 5%").

openDirection

String

Arah buka. Hanya ada jika perangkat mendukung beberapa rute, seperti yang ditunjukkan oleh atribut openDirection, dan rute ditentukan oleh pengguna.

Nilai yang didukung:

UP
DOWN
LEFT
RIGHT
IN
OUT

Contoh

Buka perangkat sedikit lagi

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

Menutup perangkat 10% lebih lama

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

Skema Trait OpenClose Smart Home

ATTRIBUTE Perangkat

Contoh

STATUS Perangkat

Buka-tutup satu arah

Buka-tutup beberapa arah

Contoh

Perangkat COMMAND

action.devices.commands.OpenClose

Parameter

Contoh

Error terkait

Tindak lanjut tanggapan

Berhasil

Kegagalan

Contoh

action.devices.commands.OpenCloseRelative

Parameter

Contoh

Error terkait

Contoh ucapan

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

Perangkat ERRORS

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`