devices.types.cooking.kettle

A device that can boil water and/or make tea.

devices.types.cooking.kettle-on

devices.types.cooking.kettle-off

Examples of devices

Smart kettle, thermo pot.

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, put the kettle on.
Алиса, вскипяти чайник.

Translation: Alice, boil the kettle.
Алиса, нагрей чайник.

Translation: Alice, warm up the kettle.
Алиса, подогрей чайник.

Translation: Alice, warm the kettle.

Where can I find all voice commands?

To open the full list of voice commands:

Open the Home with Alice app.
Select the desired device in the list of devices.
Go to the Voice commands section at the bottom of the page.
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.color_setting	Functions and values are not applicable.
devices.capabilities.on_off	Functions and values are not applicable.
devices.capabilities.mode	Function: `tea_mode` Values: `black_tea`, `flower_tea`, `green_tea`, `herbal_tea`, `oolong_tea`, `puerh_tea`, `red_tea`, `white_tea`.
devices.capabilities.range	Function: `temperature`. Values: not supported.
devices.capabilities.toggle	Function: `backlight`. Values: not supported.
devices.capabilities.toggle	Function: `controls_locked`. Values: not supported.
devices.capabilities.toggle	Function: `keep_warm`. 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`.
devices.properties.float	Function: `water_level`.
devices.properties.event	Function: `water_level`.

Examples of capability and property descriptions

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

Smart kettle with temperature control

{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "temperature",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 40,
     "precision": 10
    },
    "unit": "unit.temperature.celsius"
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}

Smart kettle with temperature control and color backlight that be turned off

{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "temperature",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 40,
     "precision": 10
    },
    "unit": "unit.temperature.celsius"
   }
  },
  {
   "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": []
}

Kettle with temperature control, keep warm, and lock

{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "temperature",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 40,
     "precision": 10
    },
    "unit": "unit.temperature.celsius"
   }
  },
  {
   "type": "devices.capabilities.toggle",
   "retrievable": true,
   "parameters": {
    "instance": "keep_warm"
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}

Kettle with three tea brewing programs

{
 "capabilities": [{
   "type": "devices.capabilities.mode",
   "retrievable": true,
   "parameters": {
    "instance": "tea_mode",
    "modes": [{
      "value": "black_tea"
     },
     {
      "value": "green_tea"
     },
     {
      "value": "puerh_tea"
     }
    ]
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}

Smart kettle with temperature control and water level and temperature sensors

{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "temperature",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 40,
     "precision": 10
    },
    "unit": "unit.temperature.celsius"
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": [{
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "temperature",
   "unit": "unit.temperature.celsius"
  }
 }, {
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "water_level",
   "unit": "unit.percent"
  }
 }]
}

Was the article helpful?

cooking.coffee_maker

cooking.multicooker