Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Properti OpenClose Smart Home

action.devices.traits.OpenClose - Sifat ini termasuk perangkat yang mendukung aktivitas membuka dan menutup, serta dalam kasus tertentu membuka dan menutup sebagian atau berpotensi di lebih dari satu arah.

ATRIBUT Perangkat

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

Atribut Jenis Deskripsi
discreteOnlyOpenClose Boolean

(Default: false)

Jika disetel ke benar (true), ini akan menunjukkan bahwa perangkat harus terbuka sepenuhnya atau tertutup sepenuhnya (artinya, tidak mendukung nilai antara 0% dan 100%).

openDirection Array

Daftar rute yang didukung yang dapat dibuka atau ditutup oleh perangkat. Sertakan atribut ini jika perangkat mendukung pembukaan dan penutupan 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). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk fitur 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 (benar).

Contoh

Perangkat buka-tutup yang sederhana.

{
  "discreteOnlyOpenClose": true
}

Perangkat dari atas ke bawah. Dapat dibuka di kedua arah.

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

Perangkat khusus perintah.

{
  "commandOnlyOpenClose": true
}

STATUS Perangkat

Perangkat 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 dari hal berikut:

Menutup satu arah

Negara bagian Jenis Deskripsi
openPercent Number

Wajib.

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

Buka di 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 diberikan.

openPercent Number

Wajib.

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

openDirection String

Wajib.

Arah perangkat dibuka.

Nilai yang didukung:

UP
DOWN
LEFT
RIGHT
IN
OUT

Contoh

Perangkat buka-tutup yang sederhana.

{
  "openPercent": 100
}

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

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

COMMAND Perangkat

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 Jenis Deskripsi
openPercent Number

Wajib.

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

openDirection String

Arah pembukaan. Hanya muncul 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 disediakan Google untuk respons tindak lanjut.

Contoh

Buka perangkat.

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

Buka perangkat dengan diskon 50 persen.

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

Respons tindak lanjut

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

Payload berisi salah satu dari hal berikut:

Berhasil

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token disediakan dalam permintaan EXECUTE asli.

status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

SUCCESS
openPercent Number

Wajib.

Menunjukkan persentase perangkat dibuka saat 0 tertutup dan 100 terbuka penuh.

Kegagalan

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token disediakan dalam permintaan EXECUTE asli.

status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

FAILURE
errorCode String

Wajib.

Nilainya dapat berupa kode error untuk sifat ini, misalnya, lockedState.

Contoh

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

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

Buka pintu garasi. (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 ditetapkan ke true.

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

Parameter

Parameter Jenis Deskripsi
openRelativePercent Number

Wajib.

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

openDirection String

Arah pembukaan. Hanya muncul 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 lebih banyak

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

Tutup 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 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
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schliessle die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • Tutup tirai 25% di kamar saya
  • Tutup pintu lainnya
  • Dekatkan pintu depan
  • buka tirai di kamar saya
  • buka gorden hingga 25%
  • buka pintu dari 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 persia

fr-FR

  • baisse toko les de 10%
  • ferme toko tertentu
  • ferme un peu toko les
  • ouvre toko tertentu
  • ouvre les store de la chambre de 25%
  • ons toko toko à 25%

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.