Список функций

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

Функция

Описание

brightness

Изменение яркости световых элементов.

channel

Изменение канала, например телевизионного.

humidity

Изменение влажности.

open

Открывание чего-либо (открывание штор, окна).

temperature

Изменение температуры. Может обозначать температуру нагрева чайника, обогревателя или температуру кондиционера в каком-либо его режиме.

volume

Изменение громкости устройства.

brightness

Изменение яркости световых элементов.

Ниже приведено описание объекта parameters из раздела Описание умения.

Объект parameters

Параметр

Тип

Описание

instance

String

Название функции для данного умения. Допустимые значения: brightness.

unit

String

Единицы измерения значений функции. Допустимые значения: unit.percent — измеряется в процентах.

random_access

Boolean

Возможность устанавливать произвольные значения функции. Если эта возможность выключена, пользователю будет доступно только последовательное изменение значений — в большую или меньшую сторону. Например, изменение громкости телевизора при работе через ИК пульт.

Допустимые значения:

  • true — возможность задавать произвольные значения включена;
  • false — возможность выключена.

По умолчанию: true.

range

Object

Объект с описанием диапазона значений функции.

Объект range

Параметр

Тип

Описание

min

Float

Минимальное допустимое значение: 0.

max

Float

Максимальное допустимое значение: 100.

precision

Float

Минимальный шаг изменения значений внутри диапазона. Значение по умолчанию: 1.

  1. Алиса, установи яркость ночника на минимум.

  2. Алиса, прибавь яркость люстры.

Использование данной функции при описании возможностей различных устройств:

Пример объекта parameters

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

{
  ...
  "parameters": {
    "instance": "brightness",
    "unit": "unit.percent",
    "range": {
      "min": 0,
      "max": 100,
      "precision": 10
    }
  }
  ...
}

Примеры устройств с функцией brightness

  1. devices.types.light

channel

Изменение канала, например телевизионного.

Ниже приведено описание объекта parameters из раздела Описание умения.

Объект parameters

Параметр

Тип

Описание

instance

String

Название функции для данного умения. Допустимые значения: channel.

random_access

Boolean

Возможность устанавливать произвольные значения функции. Если эта возможность выключена, пользователю будет доступно только последовательное изменение значений — в большую или меньшую сторону. Например, изменение громкости телевизора при работе через ИК пульт.

Допустимые значения:

  • true — возможность задавать произвольные значения включена;
  • false — возможность выключена.

По умолчанию: true.

range

Object

Объект с описанием диапазона значений функции.

Объект range

Параметр

Тип

Описание

min

Float

Ограничение отсутствует.

max

Float

Ограничение отсутствует.

precision

Float

Минимальный шаг изменения значений внутри диапазона. Значение по умолчанию: 1.

  1. Алиса, включи следующий канал на телевизоре.

  2. Алиса, переключи телевизор на предыдущий канал.

  3. Алиса, включи пятый канал на телевизоре.

Использование данной функции при описании возможностей различных устройств:

Пример объекта parameters

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

{
  ...
  "parameters": {
    "instance": "channel",
    "random_access": true,
    "range": {
      "min": 0,
      "max": 999,
      "precision": 1
    }
  }
  ...
}

Примеры устройств с функцией channel

  1. devices.types.media_device
  2. devices.types.media_device.tv
  3. devices.types.media_device.tv_box
  4. devices.types.media_device.receiver

humidity

Изменение влажности.

Ниже приведено описание объекта parameters из раздела Описание умения.

Объект parameters

Параметр

Тип

Описание

instance

String

Название функции для данного умения. Допустимые значения: humidity.

unit

String

Единицы измерения значений функции. Допустимые значения: unit.percent — измеряется в процентах.

random_access

Boolean

Возможность устанавливать произвольные значения функции. Если эта возможность выключена, пользователю будет доступно только последовательное изменение значений — в большую или меньшую сторону. Например, изменение громкости телевизора при работе через ИК пульт.

Допустимые значения:

  • true — возможность задавать произвольные значения включена;
  • false — возможность выключена.

По умолчанию: true.

range

Object

Объект с описанием диапазона значений функции.

Объект range

Параметр

Тип

Описание

min

Float

Минимальное допустимое значение: 0.

max

Float

Максимальное допустимое значение: 100.

precision

Float

Минимальный шаг изменения значений внутри диапазона. Значение по умолчанию: 1.

  1. Алиса, поставь максимальную влажность.

  2. Алиса, поставь влажность на 45%.

  3. Алиса, увеличь влажность в детской.

Использование данной функции при описании возможностей различных устройств:

Пример объекта parameters

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

{
  ...
  "parameters": {
    "instance": "humidity",
    "random_access": true,
    "range": {
      "max": 100,
      "min": 10,
      "precision": 10
    },
    "unit": "unit.percent"
  }
  ...
}

Примеры устройств с функцией humidity

  1. devices.types.humidifier

open

Открывание чего-либо (открывание штор, окна).

Ниже приведено описание объекта parameters из раздела Описание умения.

Объект parameters

Параметр

Тип

Описание

instance

String

Название функции для данного умения. Допустимые значения: open.

unit

String

Единицы измерения значений функции. Допустимые значения: unit.percent — измеряется в процентах.

random_access

Boolean

Возможность устанавливать произвольные значения функции. Если эта возможность выключена, пользователю будет доступно только последовательное изменение значений — в большую или меньшую сторону. Например, изменение громкости телевизора при работе через ИК пульт.

Допустимые значения:

  • true — возможность задавать произвольные значения включена;
  • false — возможность выключена.

По умолчанию: true.

range

Object

Объект с описанием диапазона значений функции.

Объект range

Параметр

Тип

Описание

min

Float

Минимальное допустимое значение: 0.

max

Float

Максимальное допустимое значение: 100.

precision

Float

Минимальный шаг изменения значений внутри диапазона. Значение по умолчанию: 1.

  1. Алиса, открой шторы на 10%.

  2. Алиса, открой окно на треть.

  3. Алиса, приоткрой ворота.

Использование данной функции при описании возможностей различных устройств:

Пример объекта parameters

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

{
  ...
  "parameters": {
    "instance": "open",
    "random_access": true,
    "range": {
      "max": 100,
      "min": 0,
      "precision": 10
    },
    "unit": "unit.percent"
  }
  ...
}

Примеры устройств с функцией open

  1. devices.types.openable
  2. devices.types.openable.curtain
  3. devices.types.openable.valve

temperature

Изменение температуры. Может обозначать температуру нагрева чайника, обогревателя или температуру кондиционера в каком-либо его режиме.

Ниже приведено описание объекта parameters из раздела Описание умения.

Объект parameters

Параметр

Тип

Описание

instance

String

Название функции для данного умения. Допустимые значения: temperature.

unit

String

Единицы измерения значений функции. Допустимые значения:

  • unit.temperature.celsius — измеряется в градусах по цельсию;
  • unit.temperature.kelvin — измеряется в кельвинах.

random_access

Boolean

Возможность устанавливать произвольные значения функции. Если эта возможность выключена, пользователю будет доступно только последовательное изменение значений — в большую или меньшую сторону. Например, изменение громкости телевизора при работе через ИК пульт.

Допустимые значения:

  • true — возможность задавать произвольные значения включена;
  • false — возможность выключена.

По умолчанию: true.

range

Object

Объект с описанием диапазона значений функции.

Объект range

Параметр

Тип

Описание

min

Float

Ограничение отсутствует.

max

Float

Ограничение отсутствует.

precision

Float

Минимальный шаг изменения значений внутри диапазона. Значение по умолчанию: 1.

  1. Алиса, установи температуру кондиционера на 20 градусов.

  2. Алиса, убавь температуру кондиционера.

  3. Алиса, сделай теплее в детской.

  4. Алиса, сделай прохладнее в гостиной.

Использование данной функции при описании возможностей различных устройств:

Пример объекта parameters

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

{
  ...
  "parameters": {
    "instance": "temperature",
    "random_access": true,
    "range": {
      "max": 40,
      "min": 18,
      "precision": 1
    },
    "unit": "unit.temperature.celsius"
  }
  ...
}

Примеры устройств с функцией temperature

  1. devices.types.thermostat
  2. devices.types.thermostat.ac
  3. devices.types.cooking
  4. devices.types.cooking.kettle
  5. devices.types.iron
  6. devices.types.ventilation

volume

Изменение громкости устройства.

Ниже приведено описание объекта parameters из раздела Описание умения.

Объект parameters

Параметр

Тип

Описание

instance

String

Название функции для данного умения. Допустимые значения: volume.

random_access

Boolean

Возможность устанавливать произвольные значения функции. Если эта возможность выключена, пользователю будет доступно только последовательное изменение значений — в большую или меньшую сторону. Например, изменение громкости телевизора при работе через ИК пульт.

Допустимые значения:

  • true — возможность задавать произвольные значения включена;
  • false — возможность выключена.

По умолчанию: true.

range

Object

Объект с описанием диапазона значений функции.

unit

String

Единицы измерения значений функции. Допустимые значения:

  • unit.percent — измеряется в процентах.

Если параметр отсутствует, функция измеряется в абстрактных единицах. Пример голосовой команды:

Алиса, увеличь громкость телевизора на 3.

Объект range

Параметр

Тип

Описание

min

Float

Ограничение отсутствует.

max

Float

Ограничение отсутствует.

precision

Float

Минимальный шаг изменения значений внутри диапазона. Значение по умолчанию: 1.

  1. Алиса, сделай телевизор потише.

  2. Алиса, прибавь громкость телевизора.

  3. Алиса, поставь громкость на 3 на телевизоре.

Использование данной функции при описании возможностей различных устройств:

Пример объекта parameters

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

{
  ...
  "parameters": {
    "instance": "volume",
    "random_access": true,
    "unit": "unit.percent",
    "range": {
      "min": 0,
      "max": 100,
      "precision": 10
    }
  }
  ...
}

Примеры устройств с функцией volume

  1. devices.types.media_device
  2. devices.types.media_device.tv
  3. devices.types.media_device.tv_box
  4. devices.types.media_device.receiver

Предыдущая
Range
Следующая
Toggle