Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Умный дом переключает схему признаков

action.devices.traits.Toggles — эта черта относится к любым устройствам с настройками, которые могут существовать только в одном из двух состояний.

Эти настройки могут представлять собой физическую кнопку с включенным/выключенным или активным/неактивным состоянием, флажок в HTML или любой другой тип специально включенного/отключенного элемента. Если параметр имеет более двух состояний или имеет состояние, в котором не выбран ни один из бинарных параметров, его лучше представить как характеристику Modes , которая соответствует циферблатам с несколькими состояниями, переключателям (физическим или HTML) или бинарным состояния, которые явно не включены/выключены (например, "AM/FM" или "горячо/холодно").

Эта черта охватывает один или несколько отдельных переключателей, которые могут устанавливать пользователи. Как правило, эти переключатели следует использовать для функций, не связанных с другим поведением устройства. Связанное поведение, такое как включение или выключение самого устройства, должно использовать более конкретные трейты (например, thermostatMode в трейте TemperatureSetting ).

АТРИБУТЫ устройства

Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC . Дополнительные сведения об обработке намерений SYNC см. в разделе Выполнение намерений .

Атрибуты Тип Описание
availableToggles Множество

Необходимый.

Список доступных переключателей.

[ item, ... ] Объект

Доступный переключатель.

name Нить

Необходимый.

Внутреннее имя переключателя, которое будет использоваться в командах и состояниях. Это может быть неудобным для пользователя и будет общим для всех языков.

name_values Множество

Необходимый.

Синонимы переключателя на всех поддерживаемых языках.

[ item, ... ] Объект

Синонимы слова toggle на заданном языке.

name_synonym Множество

Необходимый.

Синонимы слова переключатель. Первая строка в этом списке используется как каноническое имя уровня на этом языке.

[ item, ... ] Нить

Синоним имени.

lang Нить

Необходимый.

Код языка (ISO 639-1). См. поддерживаемые языки .

commandOnlyToggles логический

(По умолчанию: false )

Указывает, поддерживает ли устройство одностороннюю (правда) или двустороннюю (ложь) связь. Установите для этого атрибута значение true, если устройство не может ответить на намерение QUERY или отчет о состоянии для этой характеристики.

queryOnlyToggles логический

(По умолчанию: false )

Требуется, если устройство поддерживает выполнение только запросов. Этот атрибут указывает, можно ли запрашивать только информацию о состоянии устройства и нельзя ли им управлять.

Примеры

Устройство с несколькими переключателями.

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

Устройство с переключателями только для команд.

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

Устройство с переключателями только для запроса.

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

СОСТОЯНИЯ устройства

Устройства с этой чертой могут сообщать о следующих состояниях как часть операции QUERY . Дополнительные сведения об обработке намерений QUERY см. в разделе Выполнение намерений .

состояния Тип Описание
currentToggleSettings Объект

Необходимый.

Пара ключ/значение с переключаемым name устройства в качестве ключа и текущим состоянием в качестве значения.

<string> логический

Текущее состояние переключения.

Примеры

Стерилизация включена?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

КОМАНДЫ устройства

Устройства с этой чертой могут отвечать на следующие команды как часть операции EXECUTE . Дополнительные сведения об обработке намерений EXECUTE см. в разделе Выполнение намерений .

action.devices.commands.SetToggles

Установите заданное состояние переключения.

Параметры

Параметры Тип Описание
updateToggleSettings Объект

Необходимый.

Пара "ключ-значение" с переключаемым name устройства в качестве ключа и новым состоянием в качестве значения.

<string> логический

Новое состояние переключения

Примеры

Включите энергосбережение.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Отключить фильтр.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Примеры высказываний

де-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

эс-эс

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

а как

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

привет-IN

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

это-это

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

ja-JP

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

ко-КР

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

нл-нл

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

пт-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

св-СЭ

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

ОШИБКИ устройства

См. полный список ошибок и исключений .