devices.types.sensor.button

A device that notifies when the button is pressed.

Examples of devices

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, when was the last time the button was pressed?

• Алиса, отключи кнопку до 10 утра.

  Translation: Alice, disable the button until 10:00.

Recommended capabilities

Any available capabilities describing 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

{
  "capabilities": [],
  "properties": [
    {
      "type": "devices.properties.event",
      "retrievable": true,
      "reportable": true,
      "parameters": {
        "instance": "button",
        "events": [
          {
            "value": "click",
            "name": "одиночное нажатие"
          },
          {
            "value": "double_click",
            "name": "двойное нажатие"
          },
          {
            "value": "long_press",
            "name": "долгое нажатие"
          }
        ]
      },
      "state": {
        "instance": "button",
        "value": "click"
      },
      "state_changed_at": "2022-10-18T15:53:54Z",
      "last_updated": "2022-10-18T15:53:54Z"
    }
  ]
}