Skema Trait Beralih Smart Home

action.devices.traits.Toggles - Trait ini milik 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 lainnya yang diaktifkan/dinonaktifkan secara khusus. Jika setelan memiliki lebih dari dua status, atau memiliki status saat tidak satu pun opsi biner dipilih, setelan tersebut lebih baik direpresentasikan sebagai ciri Modes, yang setara dengan dial multi-status, tombol pilihan (fisik atau HTML), atau status biner yang tidak aktif/nonaktif secara eksplisit (misalnya, "AM/FM" atau "panas/cold").

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

ATTRIBUTE Perangkat

Perangkat dengan ciri ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari penanganan intent SYNC lebih lanjut, lihat Fulfillment intent.

Atribut Type Deskripsi
availableToggles Array

Wajib.

Daftar tombol yang tersedia.

[item, ...] Objek

Tombol tersedia.

name String

Wajib.

Nama internal tombol, yang akan digunakan dalam perintah dan status. Bagian ini mungkin tidak mudah digunakan, dan akan dibagikan dalam semua bahasa.

name_values Array

Wajib.

Sinonim tombol di setiap bahasa yang didukung.

[item, ...] Objek

Sinonim tombol dalam bahasa tertentu.

name_synonym Array

Wajib.

Sinonim tombol beralih. 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). Setel atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini.

queryOnlyToggles Boolean

(Default: false)

Diperlukan jika perangkat mendukung eksekusi khusus kueri. Atribut ini menunjukkan jika 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 beralih 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 penanganan intent QUERY lebih lanjut, lihat Fulfillment intent.

Status Type 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 COMMAND

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

Menetapkan status tombol tertentu.

Parameter

Parameter Type Deskripsi
updateToggleSettings Objek

Wajib.

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

<string> Boolean

Status tombol baru

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

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 frysen

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.