devices.types.switch

Switch.

Examples of devices

A wall-mounted light switch, a toggle switch, or smart button.

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 toggle switch.

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

  Translation: Alice, turn on the switch.

Specifics of use

1. In the Home with Alice app, the user can change the device type from devices.types.switch to devices.types.light. This will enable voice commands for light. Example: the switch is used to control a chandelier.

2. If the switch consists of several buttons, we recommend describing each switch button as a separate devices.types.switch device.

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.

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.

Examples of capability and property descriptions

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

Smart button (no fixed state)

{
 "capabilities": [{
  "type": "devices.capabilities.on_off",
  "retrievable": false
 }],
 "properties": []
}

Basic switch

{
 "capabilities": [{
  "type": "devices.capabilities.on_off",
  "retrievable": true
 }],
 "properties": []
}

Switch with backlight

{
 "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": []
}

Regular switch with amperage, voltage, and power consumption 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"
  }
 }]
}