devices.types.light

A device that has controllable lighting elements.

Examples of devices

Light bulb, lamp, night light.

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

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

    Translation: Alice, turn off the light.

  • Алиса, прибавь яркость света.

    Translation: Alice, make the light brighter.

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

    Translation: Alice, make the light warmer.

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

Functions and values are not applicable.

devices.capabilities.range

Function: brightness.

Values: not supported.

devices.capabilities.toggle

Function: backlight.

Values: not supported.

Examples of capability and property descriptions

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

Light bulb with color mode, brightness control, white color temperature range
{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "brightness",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 1,
     "precision": 1
    },
    "unit": "unit.percent"
   }
  },
  {
   "type": "devices.capabilities.color_setting",
   "retrievable": true,
   "parameters": {
    "color_model": "hsv",
    "temperature_k": {
     "max": 6500,
     "min": 2700
    }
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}
Light bulb with color mode, brightness control, white color
{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "brightness",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 1,
     "precision": 1
    },
    "unit": "unit.percent"
   }
  },
  {
   "type": "devices.capabilities.color_setting",
   "retrievable": true,
   "parameters": {
    "color_model": "hsv",
    "temperature_k": {
     "max": 5600,
     "min": 5600
    }
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}
Light bulb with brightness control, white temperature range
{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "brightness",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 1,
     "precision": 1
    },
    "unit": "unit.percent"
   }
  },
  {
   "type": "devices.capabilities.color_setting",
   "retrievable": true,
   "parameters": {
    "temperature_k": {
     "max": 6500,
     "min": 2700
    }
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}
White light bulb with one color temperature and brightness control
{
 "capabilities": [{
   "type": "devices.capabilities.range",
   "retrievable": true,
   "parameters": {
    "instance": "brightness",
    "random_access": true,
    "range": {
     "max": 100,
     "min": 1,
     "precision": 1
    },
    "unit": "unit.percent"
   }
  },
  {
   "type": "devices.capabilities.color_setting",
   "retrievable": true,
   "parameters": {
    "temperature_k": {
     "max": 5600,
     "min": 5600
    }
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}
Light bulb with color mode, brightness control, white color temperature range, and color effects mode
{
    "capabilities": [{
            "type": "devices.capabilities.range",
            "retrievable": true,
            "parameters": {
                "instance": "brightness",
                "random_access": true,
                "range": {
                    "max": 100,
                    "min": 1,
                    "precision": 1
                },
                "unit": "unit.percent"
            }
        },
        {
            "type": "devices.capabilities.color_setting",
            "retrievable": true,
            "parameters": {
                "color_model": "hsv",
                "temperature_k": {
                    "max": 6500,
                    "min": 2700
                },
                "color_scene": {
                    "scenes": [{
                            "id": "party"
                        },
                        {
                            "id": "alarm"
                        },
                        {
                            "id": "fantasy"
                        },
                        {
                            "id": "reading"
                        }
                    ]
                }
            }
        },
        {
            "type": "devices.capabilities.on_off",
            "retrievable": true
        }
    ],
    "properties": []
}
Previous
iron
Next
light.ceiling