Skema Sifat Tombol Smart Home

action.devices.traits.Toggles - Ciri ini dimiliki oleh perangkat apa pun dengan setelan yang hanya dapat ada dalam salah satu dari dua status.

Setelan ini dapat mewakili 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 yang tidak memilih salah satu opsi biner, setelan tersebut lebih baik direpresentasikan sebagai sifat Modes, yang setara dengan tombol multi-status, tombol pilihan (fisik atau HTML), atau status biner yang tidak secara eksplisit aktif/nonaktif (misalnya, "AM/FM" atau "panas/dingin").

Sifat ini mencakup satu atau beberapa tombol individual yang dapat ditetapkan 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 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

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

ERROR Perangkat