devices.types.vacuum_cleaner

A device that functions as a vacuum cleaner.

Examples of devices

Robotic vacuum cleaner.

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 vacuum cleaner.

• Алиса, включи робот-пылесос.

  Translation: Alice, turn on the robotic vacuum cleaner.

• Алиса, пропылесось.

  Translation: Alice, do the vacuuming.

• Алиса, уберись.

  Translation: Alice, tidy up.

• Алиса, верни пылесос на зарядку.

  Translation: Alice, put vacuum cleaner back on the charger.

• Алиса, верни пылесос на базу.

  Translation: Alice, return the vacuum cleaner to the charger.

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.

Robotic vacuum cleaner with speed control and multiple cleaning modes

{
 "capabilities": [{
   "type": "devices.capabilities.mode",
   "retrievable": true,
   "parameters": {
    "instance": "work_speed",
    "modes": [{
      "value": "slow"
     },
     {
      "value": "medium"
     },
     {
      "value": "fast"
     },
     {
      "value": "turbo"
     },
     {
      "value": "auto"
     }
    ]
   }
  },
  {
   "type": "devices.capabilities.mode",
   "retrievable": true,
   "parameters": {
    "instance": "cleanup_mode",
    "modes": [{
      "value": "quiet"
     },
     {
      "value": "normal"
     },
     {
      "value": "eco"
     },
     {
      "value": "express"
     },
     {
      "value": "auto"
     },
     {
      "value": "wet_cleaning"
     },
     {
      "value": "dry_cleaning"
     },
     {
      "value": "mixed_cleaning"
     }
    ]
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": []
}

Robotic wet and dry vacuum cleaner with speed control and water tank-in position sensor

{
 "capabilities": [{
   "type": "devices.capabilities.mode",
   "retrievable": true,
   "parameters": {
    "instance": "work_speed",
    "modes": [{
      "value": "slow"
     },
     {
      "value": "medium"
     },
     {
      "value": "fast"
     },
     {
      "value": "turbo"
     },
     {
      "value": "auto"
     }
    ]
   }
  },
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": [{
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "water_level",
   "unit": "unit.percent"
  }
 }]
}

Robotic vacuum cleaner with battery level display

{
 "capabilities": [
  {
   "type": "devices.capabilities.on_off",
   "retrievable": true
  }
 ],
 "properties": [{
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "battery_level",
   "unit": "unit.percent"
  }
 }]
}