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

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


Функция	Описание
brightness	Изменение яркости световых элементов.
channel	Изменение канала, например телевизионного.
humidity	Изменение влажности.
open	Открывание чего-либо (открывание штор, окна).
temperature	Изменение температуры. Может обозначать температуру нагрева чайника, обогревателя или температуру кондиционера в каком-либо его режиме.
volume	Изменение громкости устройства.


Функция	Описание
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.


Объект `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.

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

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

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

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

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

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

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.


Объект `parameters`
Параметр	Тип	Описание
instance	String	Название функции для данного умения. Допустимые значения: `channel`.
random_access	Boolean	Возможность устанавливать произвольные значения функции. Если эта возможность выключена, пользователю будет доступно только последовательное изменение значений — в большую или меньшую сторону. Например, изменение громкости телевизора при работе через ИК пульт. Допустимые значения: `true` — возможность задавать произвольные значения включена; `false` — возможность выключена. По умолчанию: `true`.
range	Object	Объект с описанием диапазона значений функции.
Объект `range`
min	Float	Ограничение отсутствует.
max	Float	Ограничение отсутствует.
precision	Float	Минимальный шаг изменения значений внутри диапазона. Значение по умолчанию: 1.

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

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

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

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

{
  ...
  "parameters": {
    "instance": "channel",
    "random_access": true,
    "range": {
      "min": 0,
      "max": 999,
      "precision": 1
    }
  }
  ...
}
Скопировано

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

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.


Объект `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.

Алиса, поставь максимальную влажность.
Алиса, поставь влажность на 45%.
Алиса, увеличь влажность в детской.

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

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

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

{
  ...
  "parameters": {
    "instance": "humidity",
    "random_access": true,
    "range": {
      "max": 100,
      "min": 10,
      "precision": 10
    },
    "unit": "unit.percent"
  }
  ...
}
Скопировано

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

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.


Объект `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.

Алиса, открой шторы на 10%.
Алиса, открой окно на треть.
Алиса, приоткрой ворота.

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

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

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

{
  ...
  "parameters": {
    "instance": "open",
    "random_access": true,
    "range": {
      "max": 100,
      "min": 0,
      "precision": 10
    },
    "unit": "unit.percent"
  }
  ...
}
Скопировано

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

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.


Объект `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.

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

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

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

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

{
  ...
  "parameters": {
    "instance": "temperature",
    "random_access": true,
    "range": {
      "max": 40,
      "min": 18,
      "precision": 1
    },
    "unit": "unit.temperature.celsius"
  }
  ...
}
Скопировано

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

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.


Объект `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.

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

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

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

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

{
  ...
  "parameters": {
    "instance": "volume",
    "random_access": true,
    "unit": "unit.percent",
    "range": {
      "min": 0,
      "max": 100,
      "precision": 10
    }
  }
  ...
}
Скопировано

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