Skema Fitur Tombol Smart Home

action.devices.traits.Toggles - Fitur ini termasuk dalam perangkat apa pun dengan setelan yang hanya dapat berada dalam salah satu dari dua status.

Setelan ini dapat merepresentasikan tombol fisik dengan status aktif/nonaktif atau on/off, kotak centang di HTML, atau jenis elemen lain yang diaktifkan/dinonaktifkan secara khusus. Jika setelan memiliki lebih dari dua status, atau memiliki status yang tidak memilih salah satu opsi biner, setelan tersebut lebih baik direpresentasikan sebagai karakteristik Modes, yang setara dengan tombol multi-status, tombol radio (fisik atau HTML), atau status biner yang tidak secara eksplisit aktif/nonaktif (misalnya, "AM/FM" atau "panas/dingin").

Ciri ini mencakup satu atau beberapa tombol individual yang dapat disetel pengguna. Secara umum, tombol ini harus digunakan untuk fungsi yang tidak ditautkan 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 lebih lanjut cara menangani intent SYNC, lihat Fulfillment intent.

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 hanya perintah.

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

Perangkat dengan tombol hanya kueri.

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

STATUS Perangkat

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani intent QUERY, lihat Fulfillment intent.

Contoh

Apakah sterilisasi aktif?

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

PERINTAH perangkat

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

action.devices.commands.SetToggles

Menetapkan status tombol tertentu.

Parameter

Contoh

Aktifkan hemat 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

ERROR Perangkat