Schemat Inteligentnego trybu domu

action.devices.traits.Modes – ten atrybut obejmuje wszystkie dostępne tryby i ustawienia trybu urządzenia.

Ta cecha należy do każdego urządzenia z dowolną liczbą trybów „n-way”, w której tryby i ustawienia dla każdego z nich mogą być inne i niepowtarzalne dla każdego urządzenia lub typu urządzenia. Każdy tryb może mieć wiele ustawień, ale tylko jeden może być wybierany naraz. Suszarka nie może działać w trybie „delikatnym”, „normalnym” i „intensywnym” (jednocześnie). Ustawienie, które można łatwo włączyć lub wyłączyć, należy do kategorii Przełączniki.

Pralka może na przykład mieć ustawienia rozmiaru i temperatury wczytywania. Oba te tryby są niezależne od siebie, ale mogą występować tylko w jednym stanie. Użytkownik może ustawić tryb taki jak temperatura, używając polecenia takiego jak Ustaw temperaturę prania na zimno.

Niektóre tryby są „uporządkowane” i można je dostosowywać, zwiększając lub zmniejszając szczegółowość. Na przykład rozmiar obciążenia (mały, średni, duży) i temperatura są wyraźnie podane (uwaga: temperatura nie jest wartością termiczną z celem liczbowym, jak na innych urządzeniach), ale typ wczytywania (delikatne, normalne, wełna itp.) może nie być regulowany.

Ta cecha obejmuje co najmniej jeden tryb, który może skonfigurować użytkownik. Ogólnie tych trybów należy używać w przypadku funkcji, które nie są powiązane z innym zachowaniem urządzenia. Połączone zachowanie, na przykład włączanie i wyłączanie urządzenia, powinno korzystać z bardziej szczegółowych cech (np. thermostatMode w typie TemperatureSetting).

ATRYBUTY urządzenia

W ramach operacji SYNC urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w sekcji Realizacja intencji.

Atrybuty	Typ	Opis
availableModes	Tablica	Wymagany. Lista dostępnych trybów.
[item, ...]	Obiekt	Tryb dostępny.
name	Ciąg	Wymagany. Wewnętrzna nazwa trybu, która będzie używana w poleceniach i stanach. Może nie być odpowiedni dla użytkowników i będzie dostępny we wszystkich językach.
name_values	Tablica	Wymagany. Synonimy trybu w każdym obsługiwanym języku.
[item, ...]	Obiekt	Synonimy trybu w danym języku.
name_synonym	Tablica	Wymagany. Synonimy trybu. Pierwszy ciąg znaków z tej listy jest używany jako kanoniczna nazwa poziomu w danym języku.
[item, ...]	Ciąg	Nazwa synonimu.
lang	Ciąg	Wymagany. Kod języka (ISO 639-1). Zobacz obsługiwane języki.
settings	Tablica	Wymagany. Obsługiwane ustawienia tego trybu.
[item, ...]	Obiekt	Obsługiwane ustawienie. Wymagany jest co najmniej 2 elementy.
setting_name	Ciąg	Wymagany. Wewnętrzna nazwa ustawienia trybu, które będzie używane w poleceniach i stanach. Może nie być odpowiedni dla użytkowników i będzie dostępny we wszystkich językach.
setting_values	Tablica	Wymagany. Synonimy ustawienia w każdym obsługiwanym języku.
[item, ...]	Obiekt	Synonimy ustawienia w danym języku.
setting_synonym	Tablica	Wymagany. Synonimy ustawienia. Pierwszy ciąg znaków z tej listy jest używany jako kanoniczna nazwa poziomu w danym języku.
[item, ...]	Ciąg	Nazwa synonimu.
lang	Ciąg	Wymagany. Kod języka (ISO 639-1). Zobacz obsługiwane języki.
ordered	Wartość logiczna	(domyślnie: false) Jeśli zasada ma wartość Prawda, obowiązuje gramatyka dodatkowa w celu zwiększenia lub zmniejszania wartości w kolejności (rosnąco) tablicy ustawień.
commandOnlyModes	Wartość logiczna	(domyślnie: false) Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na wartość „true”, jeśli urządzenie nie może odpowiedzieć na intencję QUERY lub stan raportu w przypadku tego atrybutu.
queryOnlyModes	Wartość logiczna	(domyślnie: false) Wymagane, jeśli urządzenie obsługuje wykonywanie tylko zapytań. Ten atrybut wskazuje, że do urządzenia można wysyłać zapytania tylko o informacje o stanie i nie można nim sterować.

Przykłady

Urządzenie z różnymi trybami i ustawieniami.

{
  "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
    }
  ]
}

Urządzenie w trybie poleceń.

{
  "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
}

Urządzenie STATES

W ramach operacji QUERY encje o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany	Typ	Opis
currentModeSettings	Obiekt	Wymagany. Para klucz-wartość korzysta z trybu name urządzenia jako klucza i bieżącej wartości setting_name jako wartości.
<string>	Ciąg	Obecnie setting_name.

Przykłady

W jakim trybie jest urządzenie?

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

Polecenie urządzenia

W ramach operacji EXECUTE urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w sekcji Realizacja intencji.

action.devices.commands.SetModes

Zaktualizuj ustawienia trybu.

Parametry

Parametry	Typ	Opis
updateModeSettings	Obiekt	Wymagany. Para klucz-wartość korzysta z trybu name urządzenia jako klucza i nowej wartości setting_name jako wartości.
<string>	Ciąg	Nowy setting_name.

Przykłady

Ustaw duże obciążenie

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

Przykładowe wypowiedzi

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

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.