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

Схема характеристик FanSpeed ​​для умного дома

action.devices.traits.FanSpeed ​​— эта черта относится к устройствам, поддерживающим настройку скорости вентилятора.

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

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

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

Атрибуты Тип Описание
reversible логический

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

Если установлено значение true, это устройство поддерживает обдув вентилятора в обоих направлениях и может принимать команду на изменение направления вентилятора.

commandOnlyFanSpeed логический

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

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

Содержит любой из следующих элементов:
0 Объект

Поддержка настроек скорости.

availableFanSpeeds Объект

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

Настройки скорости, поддерживаемые устройством.

speeds Множество

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

Список настроек скорости.

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

Настройка скорости.

speed_name Нить

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

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

speed_values Множество

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

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

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

Синоним настройки скорости на данном языке.

speed_synonym Множество

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

Синонимы для настройки скорости должны включать формы как единственного, так и множественного числа, если это применимо. Первый синоним в списке будет считаться каноническим названием настройки скорости.

[ item, ... ] Нить

Синоним.

lang Нить

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

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

ordered логический

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

Если установлено значение true, будет применяться дополнительная грамматика для логики увеличения или уменьшения в порядке (возрастании) массива скоростей.

1 Объект

Поддержка процента скорости.

supportsFanSpeedPercent логический

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

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

Если установлено значение true, это устройство будет принимать команды для регулировки скорости в процентах от 0,0 до 100,0.

Примеры

Устройство с двумя настройками скорости, поддержкой обратного направления и процентной регулировкой.

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

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

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

состояния Тип Описание
currentFanSpeedSetting Нить

Представляет собой внутреннее имя текущей настройки скорости из атрибута availableFanSpeeds .

currentFanSpeedPercent Число

Указывает текущую скорость вентилятора в процентах. Требуется, если для атрибута supportsFanSpeedPercent установлено значение true

Примеры

На какой скорости вентиляторы в гостиной?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

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

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

action.devices.commands.SetFanSpeed

Установить скорость.

Параметры

Полезная нагрузка содержит одно из следующего:

Установите скорость в настройках.

Параметры Тип Описание
fanSpeed Нить

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

Запрошенные настройки скорости вентилятора.

Установите скорость в процентах.

Параметры Тип Описание
fanSpeedPercent Число

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

Запрошенный процент настройки скорости.

Примеры

Установите вентилятор на высокую скорость.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Установите вентилятор на 50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

Установить относительную скорость.

Для этой команды требуются следующие атрибуты:
{
  "commandOnlyFanSpeed": true
}

Параметры

Полезная нагрузка содержит одно из следующего:

Установить относительную скорость по весу.

Параметры Тип Описание
fanSpeedRelativeWeight Целое число

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

Это значение указывает относительную величину изменения скорости. Абсолютное значение указывает масштабированное количество, а числовой знак указывает направление изменения.

Установите относительную скорость в процентах.

Параметры Тип Описание
fanSpeedRelativePercent Число

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

Это значение представляет процент изменения скорости.

Примеры

Немного уменьшите скорость вращения вентилятора.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Увеличьте скорость вращения вентилятора на 10 процентов.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Обратное направление вентилятора.

Для этой команды требуются следующие атрибуты:
{
  "reversible": true
}

Параметры

Параметры Тип Описание

Нет свойств

Примеры

Измените направление вентилятора.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

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

де-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop скорость the AC fan speed to medium

эс-эс

  • cambia la velocidad del ventilador дель вентиладор a medio

а как

  • au mets la ventilation maximum

привет-IN

  • बेडरूम में पंखे की गति मीडियम करें

это-это

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコンの風量を高速にセット

ко-КР

  • 선풍기 강풍 으로 틀어 줘

нл-нл

  • zet de snelheid van de ventilator op medium

пт-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

св-СЭ

  • Ställ in fläkten medel

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

См. полный список ошибок и исключений .
  • maxSpeedReached : устройство уже настроено на максимальную скорость.
  • minSpeedReached : устройство уже настроено на минимальную скорость.