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 Atribut StartStop Smart Home

action.devices.traits.StartStop - Sifat ini termasuk dalam perangkat yang mendukung operasi mulai dan berhenti.

Memulai dan menghentikan perangkat memiliki fungsi yang serupa dengan mengaktifkan dan menonaktifkannya. Perangkat yang mewarisi fitur ini memiliki fungsi yang berbeda saat diaktifkan dan saat dimulai. Misalnya, mesin cuci tertentu dapat diaktifkan dan setelannya diubah sebelum benar-benar mulai beroperasi.

Tidak seperti perangkat yang hanya memiliki status aktif dan nonaktif, beberapa perangkat yang dapat dimulai dan dihentikan juga dapat dijeda saat melakukan operasi. Perangkat yang dapat dijeda akan berhenti beroperasi, tetapi setelah dilanjutkan, perangkat akan tetap dalam status yang sama seperti saat dijeda. Membatalkan jeda berbeda dengan memulai/memulai ulang, terlepas dari status perangkat saat ini, operasi ini akan dimulai dari awal.

Beberapa perangkat mungkin mendukung berjalan di zona tertentu. Misalnya, alat penyiram mungkin memiliki berbagai zona penyiraman dan mendukung kemampuan menyiram zona tertentu secara terpisah, sedangkan penyedot debu dapat mendukung pembersihan ruangan tertentu.

ATRIBUT Perangkat

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

Atribut Jenis Deskripsi
pausable Boolean

(Default: false)

Menunjukkan apakah perangkat dapat dijeda selama operasi.

availableZones Array

Menunjukkan nama zona yang didukung. String harus dilokalkan seperti yang ditetapkan oleh pengguna. Daftar ini tidak eksklusif; pengguna dapat melaporkan nama apa pun yang mereka inginkan.

[item, ...] String

Nama zona tempat perangkat awal didukung.

Contoh

Perangkat yang dapat dijeda dan mendukung pengoperasian di beberapa zona.

{
  "pausable": true,
  "availableZones": [
    "kitchen",
    "living room",
    "office",
    "bedroom"
  ]
}

STATUS Perangkat

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

Negara bagian Jenis Deskripsi
isRunning Boolean

Wajib.

Menunjukkan apakah perangkat saat ini beroperasi.

isPaused Boolean

Menunjukkan apakah perangkat dijeda secara eksplisit. Jika nilai ini benar, menyiratkan bahwa isRunning salah, tetapi dapat dilanjutkan.

activeZones Array

Menunjukkan zona tempat perangkat berjalan, dari daftar availableZones.

[item, ...] String

Nama zona.

Contoh

Apakah perangkat dijeda?

{
  "isRunning": false,
  "isPaused": true
}

Apakah perangkat dijeda?

{
  "isRunning": true,
  "isPaused": false
}

Apakah perangkat berjalan?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "kitchen",
    "living room"
  ]
}

PERMINTAAN Perangkat

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

action.devices.commands.StartStop

Mulai atau hentikan perangkat.

Parameter

Parameter Jenis Deskripsi
start Boolean

Wajib.

True untuk memulai operasi perangkat, false untuk berhenti.

zone String

Menunjukkan zona tempat untuk mulai menjalankan.

multipleZones Array

Menunjukkan dua atau beberapa zona untuk mulai menjalankan. Akan ditetapkan sebagai ganti zone parameter.

[item, ...] String

Nama zona untuk memulai perangkat.

Contoh

Mulai perangkat.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

Hentikan perangkat.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

Mulai perangkat di kantor.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

Mulai perangkat di dapur, ruang makan, dan ruang keluarga.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "kitchen",
      "dining room",
      "living room"
    ]
  }
}

action.devices.commands.PauseUnpause

Menjeda atau membatalkan jeda operasi perangkat.

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

Parameter

Parameter Jenis Deskripsi
pause Boolean

Wajib.

Benar untuk menjeda, salah untuk membatalkan jeda.

Contoh

Jeda perangkat.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

Pengguna mencoba menjeda perangkat, tetapi dalam keadaan tertentu, perangkat tidak dapat dijeda.

Nilai yang didukung:

unpausableState

Contoh ucapan

de-DE

  • Bite starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger absachalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine

en-US

  • aku butuh kamarku untuk mulai berjalan di ruang
  • jeda pengering sekarang
  • mulai pengering sekarang
  • stop pencuci piring
  • aktifkan lagi pencuci piring

es-ES

  • parar la lavadora
  • pon el aspiradorio principal
  • pon el lavavajillas en paus
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Lanjutan l'aspirateur .
  • arrête l'aspirateur
  • tombak la machine à laver
  • memenuhi l'aspirateur id jeda

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.