Skema Sifat Mode Smart Home

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

Sifat ini dimiliki oleh perangkat apa pun dengan jumlah mode "n-way" acak, dengan mode dan setelan untuk setiap mode bersifat acak dan unik untuk setiap perangkat atau jenis perangkat. Setiap mode memiliki beberapa kemungkinan setelan, tetapi hanya satu yang dapat dipilih dalam satu waktu; pengering tidak dapat berada dalam mode "delicate", "normal", dan "heavy duty" secara bersamaan. Setelan yang hanya dapat diaktifkan atau dinonaktifkan termasuk dalam sifat Toggles.

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

Beberapa mode "terurut" dan juga dapat disesuaikan dengan kata-kata atas/bawah, kenaikan/penurunan. Misalnya, ukuran beban (kecil, sedang, besar) dan suhu diurutkan dengan jelas (perhatikan bahwa suhu bukan termostat aktual dengan target numerik, seperti di perangkat lain), tetapi jenis beban (lembut, 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 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.

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. Hal ini dapat membuat pengguna tidak nyaman, dan akan dibagikan ke 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 minimal 2 item.
setting_name String

Wajib.

Nama internal setelan mode, yang akan digunakan dalam perintah dan status. Hal ini dapat membuat pengguna tidak nyaman, dan akan dibagikan ke 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 peningkatan/penurunan akan diterapkan, dalam urutan (peningkatan) array setelan.
commandOnlyModes Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (true) atau dua arah (false). Tetapkan atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Status Pelaporan untuk karakteristik ini.
queryOnlyModes Boolean

(Default: false)

Wajib jika perangkat mendukung eksekusi khusus kueri. Atribut ini menunjukkan apakah perangkat hanya dapat dikueri untuk 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

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani intent QUERY, 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

Dalam mode apa perangkat berada?

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

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

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.