devices.types.thermostat.ac

A device that controls microclimate in the room, with the capability to control the temperature and operating mode.

Examples of devices

Air conditioner.

Device control phrases

Each device type has a specific set of phrases. The user can control the device using these phrases without specifying the device name.

Phrases

  • Алиса, включи кондиционер.

    Translation: Alice, turn on the air conditioner.

  • Алиса, выключи кондей.

    Translation: Alice, turn off the AC.

  • Алиса, сделай теплее.

    Translation: Alice, make it warmer.

  • Алиса, сделай холоднее.

    Translation: Alice, make it cooler.

  • Алиса, теплее на четыре градуса.

    Translation: Alice, make it four degrees warmer.

  • Алиса, выставь температуру на минимум.

    Translation: Alice, set the lowest temperature.

Where can I find all voice commands?

To open the full list of voice commands:

  1. Open the Home with Alice app.
  2. Select the desired device in the list of devices.
  3. Go to the Voice commands section at the bottom of the page.
  4. Tap More commands.

Recommended capabilities

The table of capabilities is based on popular device functions in a given category. It provides general recommendations for describing devices. Yandex Smart Home does not restrict the provider to the specified list. You can combine capabilities and devices as you wish based on your awareness of the device features.

Capability

Instances and values

devices.capabilities.on_off

Functions and values are not applicable.

devices.capabilities.range

Function: temperature.

Values: not supported.

devices.capabilities.mode

Function: fan_speed.

Values: auto, high, low, medium, quiet, turbo.

devices.capabilities.mode

Function: swing.

Values: auto, horizontal, stationary, vertical.

devices.capabilities.mode

Function: thermostat.

Values: auto, cool, dry, eco, fan_only, heat.

devices.capabilities.toggle

Function: ionization.

Values: not supported.

devices.capabilities.toggle

Function: oscillation.

Values: not supported.

Recommended properties for devices

The table of properties is based on popular device functions in a given category. It provides general recommendations for describing devices. Yandex Smart Home does not restrict the provider to the specified list. You can combine properties and devices as you wish based on your awareness of the device features.

Property type

Instances

devices.properties.float

Function: temperature.

Examples of capability and property descriptions

These structures are sent in response to the device list request.

Air conditioner with temperature control, operating mode, fan speed, and swing mode
{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "temperature",
    "random_access": true,
    "range": {
     "max": 33,
     "min": 18,
     "precision": 1
    },
    "unit": "unit.temperature.celsius"
   }
  },
  {
   "type": "devices.capabilities.mode",
   "retrievable": true,
   "parameters": {
    "instance": "fan_speed",
    "modes": [{
      "value": "high"
     },
     {
      "value": "medium"
     },
     {
      "value": "low"
     },
     {
      "value": "auto"
     }
    ]
   }
  },
  {
   "type": "devices.capabilities.mode",
   "retrievable": true,
   "parameters": {
    "instance": "thermostat",
    "modes": [{
      "value": "fan_only"
     },
     {
      "value": "heat"
     },
     {
      "value": "cool"
     },
     {
      "value": "dry"
     },
     {
      "value": "auto"
     }
    ]
   }
  },
  {
   "type": "devices.capabilities.toggle",
   "retrievable": true,
   "parameters": {
    "instance": "oscillation"
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}
Air conditioner with temperature, operating mode, and fan speed control, as well as temperature sensor
{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "temperature",
    "random_access": true,
    "range": {
     "max": 33,
     "min": 18,
     "precision": 1
    },
    "unit": "unit.temperature.celsius"
   }
  },
  {
   "type": "devices.capabilities.mode",
   "retrievable": true,
   "parameters": {
    "instance": "fan_speed",
    "modes": [{
      "value": "high"
     },
     {
      "value": "medium"
     },
     {
      "value": "low"
     },
     {
      "value": "auto"
     }
    ]
   }
  },
  {
   "type": "devices.capabilities.mode",
   "retrievable": true,
   "parameters": {
    "instance": "thermostat",
    "modes": [{
      "value": "fan_only"
     },
     {
      "value": "heat"
     },
     {
      "value": "cool"
     },
     {
      "value": "dry"
     },
     {
      "value": "auto"
     }
    ]
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": [{
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "temperature",
   "unit": "unit.celsius"
  }
 }]
}