devices.types.cooking

Various smart kitchen appliances.

devices.types.cooking-on

devices.types.cooking-off

Examples of devices

Refrigerator, oven. We recommend using the dedicated devices.types.cooking.kettle type for an electric kettle, the devices.types.cooking.coffee_maker type for a coffee maker, and the devices.types.cooking.multicooker type for a multicooker.

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.mode

Function: program.

Values: one, two, three, four, five, six, seven, eight, nine, ten, express, normal.

devices.capabilities.range

Function: temperature.

Values: not supported.

devices.capabilities.toggle

Function: controls_locked.

Values: not supported.

devices.capabilities.toggle

Function: keep_warm.

Values: not supported.

devices.capabilities.toggle

Function: pause.

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.

Smart refrigerator with temperature sensor
{
  "capabilities": [
    {
      "type": "devices.capabilities.range",
      "retrievable": true,
      "parameters": {
        "instance": "temperature",
        "random_access": true,
        "range": {
          "max": 18,
          "min": 4,
          "precision": 0.5
        },
        "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"
      }
    }
  ]
}