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 Tombol Smart Home

action.devices.traits.Toggles - Sifat ini termasuk pada perangkat apa pun dengan setelan yang hanya dapat ada di salah satu dari dua status.

Setelan ini dapat merepresentasikan tombol fisik dengan status aktif/nonaktif atau aktif/tidak aktif, kotak centang di HTML, atau jenis elemen lain yang diaktifkan/dinonaktifkan secara khusus. Jika setelan memiliki lebih dari dua status, atau memiliki status saat salah satu opsi biner dipilih, opsi tersebut lebih baik ditampilkan sebagai fitur Mode, yang setara dengan panggilan multi-status, tombol pilihan (fisik atau HTML), atau status biner yang tidak secara eksplisit aktif/nonaktif (misalnya, "AM/FM" atau "hot/cold").

Sifat ini mencakup satu atau beberapa tombol beralih yang dapat ditetapkan pengguna. Secara umum, tombol alih ini harus digunakan untuk fungsi yang dibatalkan tautannya dari perilaku perangkat lain. Perilaku tertaut, seperti mengaktifkan atau menonaktifkan perangkat itu sendiri, harus menggunakan karakteristik yang lebih spesifik (misalnya, thermostatMode dalam karakteristik TemperatureSetting).

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
availableToggles Array

Wajib.

Daftar tombol yang tersedia.

[item, ...] Objek

Tombol yang tersedia.

name String

Wajib.

Nama internal tombol, yang akan digunakan dalam perintah dan status. Setelan ini dapat dibuat tidak mudah digunakan dan akan dibagikan dalam semua bahasa.

name_values Array

Wajib.

Sinonim tombol alih dalam setiap bahasa yang didukung.

[item, ...] Objek

Sinonim tombol alih dalam bahasa tertentu.

name_synonym Array

Wajib.

Sinonim tombol alih. String pertama dalam daftar ini digunakan sebagai nama kanonis tingkat dalam bahasa tersebut.

[item, ...] String

Nama sinonim.

lang String

Wajib.

Kode bahasa (ISO 639-1). Lihat bahasa yang didukung.

commandOnlyToggles 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 karakteristik ini.

queryOnlyToggles Boolean

(Default: false)

Wajib jika perangkat mendukung eksekusi khusus kueri. Atribut ini menunjukkan apakah perangkat hanya dapat dikueri untuk informasi status, dan tidak dapat dikontrol.

Contoh

Perangkat dengan beberapa tombol.

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "clean",
            "bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "energy saving",
            "eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

Perangkat dengan tombol khusus perintah.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "filtered",
            "filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

Perangkat dengan tombol khusus kueri.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "filtered",
            "filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

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
currentToggleSettings Objek

Wajib.

Pasangan kunci/nilai dengan tombol name perangkat sebagai kunci, dan status saat ini sebagai nilai.

<string> Boolean

Status tombol saat ini.

Contoh

Apakah sterilisasi aktif?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

Menetapkan status tombol akses tertentu.

Parameter

Parameter Jenis Deskripsi
updateToggleSettings Objek

Wajib.

Pasangan kunci/nilai dengan tombol name perangkat sebagai kunci, dan status baru sebagai nilainya.

<string> Boolean

Status tombol baru

Contoh

Aktifkan penghematan energi.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Nonaktifkan filter.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Contoh ucapan

de-DE

  • Bitte schalte Power Cool am Kühlschrank aus
  • stelle den Kühlschrank auf Power Cool

en-US

  • aktifkan pembekuan daya untuk freezer
  • batalkan daya keren untuk kulkas dapur

es-ES

  • pon el enfriamiento rápido en la Nevera
  • quita el enfriamiento rápido

fr-FR

  • mode meets le power cool sur le réfrigérateur
  • Éteins le mode power freeze du réfrigérateur .

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.