devices.types.switch

Выключатель.

Примеры устройств

Настенный выключатель света, тумблер, автомат в электрическом щитке, умное реле, умная кнопка.

Фразы для управления устройством

Каждому типу устройства соответствует определенный набор фраз. С помощью этих фраз пользователь может управлять устройством без указания имени устройства.

Фразы:

  • Алиса, включи переключатель.

  • Алиса, включи выключатель.

Где посмотреть все голосовые команды
Чтобы открыть полный список голосовых команд:
  1. Откройте приложение  Дом с Алисой.
  2. В списке устройств выберите нужное устройство.
  3. Перейдите в конец страницы к разделу Голосовые команды.
  4. Нажмите кнопку Больше команд.

Особенности использования

  1. Пользователь в приложении  Дом с Алисой может изменить тип устройства devices.types.switch на devices.types.light. Это позволит использовать голосовые команды для света. Пример: выключатель управляет обычной люстрой.

  2. Если выключатель состоит из нескольких кнопок, рекомендуется описывать каждую кнопку выключателя как отдельное устройство типа devices.types.switch.

Рекомендуемые умения

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

Умение Функции (instance) и значения (value)
devices.capabilities.on_off Функции и значения не предусмотрены.
devices.capabilities.toggle

Функция: backlight.

Значения не предусмотрены.

Умение Функции (instance) и значения (value)
devices.capabilities.on_off Функции и значения не предусмотрены.
devices.capabilities.toggle

Функция: backlight.

Значения не предусмотрены.

Рекомендуемые свойства для устройств

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

Тип свойства Функции (instance)
devices.properties.float

Функция: amperage.

Функция: power.

Функция: voltage.
Тип свойства Функции (instance)
devices.properties.float

Функция: amperage.

Функция: power.

Функция: voltage.

Примеры описания умений и свойств

Приведенные структуры приходят в ответ на запрос списка устройств.

Умная кнопка (не имеет фиксированного состояния)
{
 "capabilities": [{
  "type": "devices.capabilities.on_off",
  "retrievable": false
 }],
 "properties": []
}
Обычный выключатель
{
 "capabilities": [{
  "type": "devices.capabilities.on_off",
  "retrievable": true
 }],
 "properties": []
}
Выключатель с подсветкой
{
 "capabilities": [
                {
   "type": "devices.capabilities.color_setting",
   "retrievable": true,
   "parameters": {
    "color_model": "hsv"
   }
  },
  {
   "type": "devices.capabilities.toggle",
   "retrievable": true,
   "parameters": {
    "instance": "backlight"
   }
  }, {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}
Обычный выключатель со свойствами потребления тока, напряжения и мощности
{
 "capabilities": [{
  "type": "devices.capabilities.on_off",
  "retrievable": true
 }],
 "properties": [{
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "amperage",
   "unit": "unit.ampere"
  }
 }, {
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "voltage",
   "unit": "unit.volt"
  }
 }, {
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "power",
   "unit": "unit.watt"
  }
 }]
}