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

Entitas 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 starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine
  • ist die Waschmaschine fertig

en-US

  • I need my roomba to start running in the den
  • is the vacuum running
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • dime si ha acabado el lavavajillas
  • parar la lavadora
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • est-ce que l'aspirateur est en marche
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • क्या वैक्यूम चल रहा है?
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • la lavatrice è in funzione
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 は作動してる
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 건조기 돌아가고 있나
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • Is de stofzuiger klaar
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • o aspirador está parado?
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.