Skema Fitur Mode Smart Home

action.devices.traits.Modes - Sifat ini mencakup semua mode yang tersedia dan setelan khusus mode untuk perangkat.

Sifat ini akan dimiliki oleh perangkat apa pun dengan jumlah mode "n-way" arbitrer yang mana mode dan setelan untuk setiap mode bersifat arbitrer dan unik untuk tiap perangkat atau jenis perangkat. Setiap mode memiliki beberapa kemungkinan setelan, tetapi hanya satu yang dapat dipilih pada satu waktu; pengering tidak dapat berada dalam mode "halus", "normal", dan "tugas berat" secara bersamaan. Setelan yang hanya dapat diaktifkan atau dinonaktifkan dimiliki oleh fitur Toggle.

Misalnya, mesin cuci dapat memiliki setelan untuk ukuran dan suhu muatan. Keduanya akan menjadi mode karena terpisah satu sama lain, tetapi masing-masing hanya dapat berada dalam satu status pada satu waktu. Pengguna dapat menyetel mode seperti temperatur secara eksplisit dengan perintah seperti Setel suhu mesin cuci ke dingin.

Beberapa mode "diurutkan" dan juga dapat disesuaikan dengan kenaikan/penurunan huruf besar/kecil. Misalnya, ukuran pemuatan (kecil, sedang, besar) dan temperatur diurutkan dengan jelas (perhatikan bahwa suhu bukan merupakan termostat sebenarnya dengan target numerik, seperti pada perangkat lain), tetapi jenis beban (delida, normal, wol, dll) mungkin tidak.

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

ATRIBUT Perangkat

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

Atribut	Jenis	Deskripsi
availableModes	Array	Wajib. Daftar mode yang tersedia.
[item, ...]	Objek	Mode yang tersedia.
name	String	Wajib. Nama internal mode, yang akan digunakan dalam perintah dan status. Link ini dapat tidak mudah digunakan dan akan dibagikan dalam semua bahasa.
name_values	Array	Wajib. Sinonim mode dalam setiap bahasa yang didukung.
[item, ...]	Objek	Sinonim mode dalam bahasa tertentu.
name_synonym	Array	Wajib. Sinonim mode. 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.
settings	Array	Wajib. Setelan yang didukung untuk mode ini.
[item, ...]	Objek	Setelan yang didukung. Memerlukan setidaknya 2 item.
setting_name	String	Wajib. Nama internal setelan mode, yang akan digunakan dalam perintah dan status. Link ini dapat tidak mudah digunakan dan akan dibagikan dalam semua bahasa.
setting_values	Array	Wajib. Sinonim setelan dalam setiap bahasa yang didukung.
[item, ...]	Objek	Sinonim setelan dalam bahasa tertentu.
setting_synonym	Array	Wajib. Sinonim setelan. 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.
ordered	Boolean	(Default: false) Jika disetel ke benar (true), tata bahasa tambahan untuk logika penambahan/penurunan akan diterapkan, dalam urutan (meningkatkan) array setelan.
commandOnlyModes	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 fitur ini.
queryOnlyModes	Boolean	(Default: false) Diperlukan jika perangkat mendukung eksekusi khusus kueri. Atribut ini menunjukkan apakah perangkat hanya dapat dikueri untuk mengetahui informasi status, dan tidak dapat dikontrol.

Contoh

Perangkat dengan beberapa mode dan setelan.

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

Perangkat dengan mode khusus perintah.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

STATUS Perangkat

Perangkat dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat fulfillment intent.

Negara bagian	Jenis	Deskripsi
currentModeSettings	Objek	Wajib. Key-value pair dengan mode name perangkat sebagai kunci, dan setting_name saat ini sebagai nilai.
<string>	String	Saat ini setting_name.

Contoh

Mode perangkat apa yang digunakan?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

COMMAND Perangkat

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

Perbarui setelan mode.

Parameter

Parameter	Jenis	Deskripsi
updateModeSettings	Objek	Wajib. Key-value pair dengan mode name perangkat sebagai kunci, dan setting_name baru sebagai nilai.
<string>	String	setting_name baru.

Contoh

Tetapkan ke pemuatan besar.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

Contoh ucapan

de-DE

• Stelle den Staubsauger auf Ruhemodus

en-US

• set the vacuum to energy saver mode

es-ES

• pon la lavadora en modo frío

fr-FR

• mets l'aspirateur en silencieux

hi-IN

• वैक्यूम पर कार्पेट मोड लगाएं

it-IT

• imposta l'aspirapolvere su silenzioso

ja-JP

• 掃除機 を 静音 モードに設定して

ko-KR

• 세탁기 세탁량 많음 으로 설정해

pt-BR

• acionar a função autolimpeza do aspirador
• ligar o modo de aquecimento

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.