Smart Home Beralih ke Skema Trait

action.devices.traits.Toggles - Sifat ini dimiliki oleh perangkat apa pun dengan setelan yang hanya dapat berada di salah satu dari dua status.

Setelan ini dapat menampilkan tombol fisik dengan aktif/nonaktif atau aktif/tidak aktif status, kotak centang di HTML, atau jenis lain apa pun yang diaktifkan/dinonaktifkan secara khusus . Jika setelan memiliki lebih dari dua status, atau memiliki status tidak satu pun dari opsi biner yang dipilih, lebih baik direpresentasikan sebagai Modes, yang sama dengan dial multi-negara bagian, 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 alih individual yang dapat disetel pengguna. Di beberapa umum, tombol alih ini harus digunakan untuk fungsionalitas yang dibatalkan tautannya dari perilaku perangkat lain. Perilaku terkait, seperti memutar perangkat itu sendiri harus menggunakan ciri yang lebih spesifik (misalnya, thermostatMode dalam sifat TemperatureSetting).

ATTRIBUTES Perangkat

Perangkat dengan karakteristik ini mungkin melaporkan hal berikut sebagai bagian dari operasi SYNC. Untuk mempelajari selengkapnya tentang menangani intent SYNC, lihat Pemenuhan intent.

Atribut	Jenis	Deskripsi
availableToggles	Array	Wajib. Daftar tombol alih yang tersedia.
[item, ...]	Objek	Tombol tersedia.
name	String	Wajib. Nama internal tombol, yang akan digunakan dalam perintah dan status. URL ini mungkin tidak mudah digunakan dan akan dibagikan dalam semua bahasa.
name_values	Array	Wajib. Sinonim tombol dalam setiap bahasa yang didukung.
[item, ...]	Objek	Sinonim tombol dalam bahasa tertentu.
name_synonym	Array	Wajib. Sinonim tombol. String pertama dalam daftar ini digunakan sebagai nama kanonis level 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) Diperlukan jika perangkat mendukung eksekusi hanya kueri. Atribut ini menunjukkan apakah perangkat hanya dapat dikueri untuk mengetahui 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 alih khusus perintah.

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

Perangkat dengan tombol alih khusus kueri.

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

NEGARA Perangkat

Entitas dengan karakteristik ini dapat melaporkan hal berikut status sebagai bagian dari operasi QUERY. Untuk mempelajari selengkapnya tentang menangani intent QUERY, lihat Pemenuhan 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
  }
}

Perangkat COMMANDS

Perangkat dengan karakteristik ini dapat merespons hal berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari selengkapnya tentang menangani intent EXECUTE, lihat Pemenuhan intent.

action.devices.commands.SetToggles

Menetapkan status tombol yang ditentukan.

Parameter

Parameter	Jenis	Deskripsi
updateToggleSettings	Objek	Wajib. Pasangan kunci/nilai dengan tombol name perangkat sebagai kunci, dan status baru sebagai nilai.
<string>	Boolean	Status pengalihan baru

Contoh

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

de-DE

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

en-US

• activate power freeze for the freezer
• cancel power cool for the kitchen fridge

es-ES

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

fr-FR

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

hi-IN

• रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
• रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

• disattiva il power freeze del freezer
• imposta la funzione power freeze del surgelatore

ja-JP

• 冷蔵庫 の 急速冷凍 つけて
• 冷蔵庫 の 急速冷凍 を切ってくれる

ko-KR

• 냉장고 급속 냉장 해제해
• 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

• Zet de power cool uit op de koelkast
• zet de koelkast op superkoelen

pt-BR

• Ativa a função power freeze no congelador .
• Desativa o bloqueio infantil do forno .
• desligar o power cool da geladeira
• iniciar o modo power freeze do freezer

sv-SE

• Stäng av power cool i kylskåpet
• sätt på power freeze på frysen

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.