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

action.devices.traits.StartStop - Sifat ini termasuk 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 berhenti juga dapat dijeda saat melakukan operasi. Perangkat yang dapat dijeda akan berhenti beroperasi, tetapi setelah dilanjutkan, perangkat akan terus dalam status yang sama seperti saat dijeda. Membatalkan jeda berbeda dari saat memulai/memulai ulang, terlepas dari status perangkat saat ini, tindakan ini akan mulai beroperasi dari awal.

Beberapa perangkat mungkin mendukung pengoperasian di zona tertentu. Misalnya, penyemprot air mungkin memiliki berbagai zona penyiraman dan mendukung kemampuan untuk menyirami zona tertentu secara terpisah, sedangkan penyedot debu dapat mendukung pembersihan ruang khusus.

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
pausable Boolean

(Default: false)

Menunjukkan apakah perangkat dapat dijeda selama pengoperasian.

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 operasi 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 fulfillment intent.

Negara bagian Jenis Deskripsi
isRunning Boolean

Wajib.

Menunjukkan apakah perangkat sedang beroperasi.

isPaused Boolean

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

activeZones Array

Menunjukkan zona tempat perangkat saat ini 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"
  ]
}

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.StartStop

Mulai atau hentikan perangkat.

Parameter

Parameter Jenis Deskripsi
start Boolean

Wajib.

Benar untuk memulai operasi perangkat, salah untuk berhenti.

zone String

Menunjukkan zona untuk mulai menjalankan.

multipleZones Array

Menunjukkan dua zona atau lebih untuk mulai berjalan. Akan ditetapkan sebagai pengganti 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 melanjutkan operasi perangkat.

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

Parameter

Parameter Jenis Deskripsi
pause Boolean

Wajib.

True untuk menjeda, false 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

  • Bitte awal den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger abstrakten
  • Staubsauger pausieren
  • bitte start Die Waschmaschine

en-US

  • saya butuh ruang saya untuk mulai berlari ruang
  • jeda pengering sekarang
  • mulai pengering sekarang
  • hentikan pencuci piring
  • membatalkan jeda pencuci piring

es-ES

  • parar la lavadora
  • pon el aspirador en akun utama el dormitorio
  • 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
  • lanset mesin à laver
  • terpenuhi l'aspirateur id jeda

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.