---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/float.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/float.md
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/float.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741

# Float

<!-- source: ru/_includes/reusables/neuroexpert-button.md -->



<!-- endsource: ru/_includes/reusables/neuroexpert-button.md -->


`devices.properties.float`

Отображение значений свойств устройства в числовом формате.

## Описание свойства {#discovery}

<!-- source: ru/_includes/concepts/range/id-discovery/discovery-p.md -->
Структура используется в ответе операции [Информация об устройствах пользователя](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/get-devices.md).
<!-- endsource: ru/_includes/concepts/range/id-discovery/discovery-p.md -->


#### Параметры свойства {#parameters}

<!-- source: ru/_includes/reference/struct-table/id-struct-table/discovery-parameters-float-table.md -->
<!-- Свойства / Properties -->

<!-- Описание свойства float discovery -->


#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
<!-- source: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-1.md -->
type
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-2.md -->
[String](*string)
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-3.md -->
Тип свойства.
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-4.md -->
Да
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-4.md -->
||

||
<!-- source: ru/_includes/reference/struct-table/id-struct-table/retrievable-properties-row-col-1.md -->
retrievable
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/retrievable-properties-row-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/retrievable-properties-row-col-2.md -->
[Boolean](*boolean)
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/retrievable-properties-row-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/retrievable-properties-row-col-3.md -->
Доступен ли для свойства устройства запрос состояния. Допустимые значения:
- `true` — для свойства доступен запрос состояния. Является значением по умолчанию;
- `false` — для свойства недоступен запрос состояния. Значение доступно, если `reportable:true`.
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/retrievable-properties-row-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/retrievable-properties-row-col-4.md -->
Нет
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/retrievable-properties-row-col-4.md -->
||

||
<!-- source: ru/_includes/reference/struct-table/id-struct-table/reportable-properties-row-col-1.md -->
reportable
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/reportable-properties-row-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/reportable-properties-row-col-2.md -->
[Boolean](*boolean)
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/reportable-properties-row-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/reportable-properties-row-col-3.md -->
Оповещает ли свойство об изменении состояния платформу умного дома, используя [сервис уведомлений](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference-alerts/post-skill_id-callback-state.md). Допустимые значения:
- `true` — оповещение включено. Производитель оповещает платформу умного дома о каждом изменении состояния свойства;
- `false` — оповещение выключено. Производитель не оповещает платформу об изменении состояния свойства. Является значением по умолчанию.
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/reportable-properties-row-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/reportable-properties-row-col-4.md -->
Нет
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/reportable-properties-row-col-4.md -->
||

||
<!-- source: ru/_includes/reference/struct-table/id-struct-table/parameters-properties-row-col-1.md -->
parameters
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/parameters-properties-row-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/parameters-properties-row-col-2.md -->
[Object](*object)
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/parameters-properties-row-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/parameters-properties-row-col-3.md -->
Объект `parameters`.
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/parameters-properties-row-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/parameters-properties-row-col-4.md -->
Да
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/parameters-properties-row-col-4.md -->
||
|#

<!-- source: ru/_includes/reference/struct-table/id-struct-table/parameters-object-ph.md -->
**Объект `parameters`**
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/parameters-object-ph.md -->

#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
<!-- source: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-1.md -->
instance
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-2.md -->
[String](*string)
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-3.md -->
Название функции для свойства. Допустимые значения можно посмотреть в разделе [Список функций](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/float-instance.md).
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-4.md -->
Да
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-4.md -->
||
||
unit
|
[String](*string)
|
Единицы измерения значений функции. Допустимые значения можно посмотреть в разделе [Список функций](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/float-instance.md).
|
Да
||
|#
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/discovery-parameters-float-table.md -->


#### Пример использования {#example}

Платформа умного дома отправляет провайдеру запрос на получение информации об устройствах пользователя. Провайдер в ответ передает информацию о том, что у пользователя есть увлажнитель со свойством влажности.


{% list tabs %}

- Запрос


  ```bash translate=no
  curl -i -X GET 'https://example.com/v1.0/user/devices' \
  -H 'Authorization: Bearer 123qwe456a...' \
  -H 'X-Request-Id: ff36a3cc-ec...'
  ```


- Ответ


  ```json translate=no
  HTTP/1.1 200 OK

  {
      "request_id": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
      "payload": {
          "user_id": "user-001",
          "devices": [{
              "id": "humidifier-001-hmdfr",
              "name": "увлажнитель",
              "description": "умный увлажнитель hmdfr",
              "room": "спальня",
              "type": "devices.types.humidifier",
              "custom_data": {
                  "api_location": "rus"
              },
              "capabilities": [{
                  "type": "devices.capabilities.on_off"
              }],
              "properties": [{
                  "type": "devices.properties.float",
                  "retrievable": true,
                  "reportable": true,
                  "parameters": {
                      "instance": "humidity",
                      "unit": "unit.percent"
                  }
              }],
              "device_info": {
                  "manufacturer": "Provider-01",
                  "model": "hmdfr 1",
                  "hw_version": "1.2",
                  "sw_version": "5.4"
              }
          }]
      }
  }
  ```

{% endlist %}


## Текущее состояние свойства {#state}

<!-- source: ru/_includes/concepts/on_off/id-state/state-p.md -->
Структура используется в ответе операции [Информация о состояниях устройств пользователя](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/post-devices-query.md) и в теле запроса операции [Уведомление об изменении состояния устройства](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference-alerts/post-skill_id-callback-state.md).
<!-- endsource: ru/_includes/concepts/on_off/id-state/state-p.md -->


#### Параметры свойства {#parameters}

<!-- source: ru/_includes/reference/struct-table/id-struct-table/state-parameters-float-table.md -->
<!-- Текущее состояние свойства float state -->

#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
<!-- source: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-1.md -->
type
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-2.md -->
[String](*string)
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-3.md -->
Тип свойства.
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-4.md -->
Да
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/type-properties-row-col-4.md -->
||

||
<!-- source: ru/_includes/reference/struct-table/id-struct-table/state-row-properties-float-col-1.md -->
state
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/state-row-properties-float-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/state-row-properties-float-col-2.md -->
[Object](*object)
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/state-row-properties-float-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/state-row-properties-float-col-3.md -->
Параметры состояния свойства.
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/state-row-properties-float-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/state-row-properties-float-col-4.md -->
Да
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/state-row-properties-float-col-4.md -->
||
|#

<br>

<!-- source: ru/_includes/reference/struct-table/id-struct-table/range-state-ph.md -->
**Объект `state`**
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/range-state-ph.md -->

#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
<!-- source: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-1.md -->
instance
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-2.md -->
[String](*string)
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-3.md -->
Название функции для свойства. Допустимые значения можно посмотреть в разделе [Список функций](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/float-instance.md).
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-4.md -->
Да
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/instance-row-properties-float-col-4.md -->
||

||
<!-- source: ru/_includes/reference/struct-table/id-struct-table/value-range-row-col-1.md -->
value
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/value-range-row-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/value-range-row-col-2.md -->
[Float](*float)
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/value-range-row-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/value-range-row-col-3.md -->
Значение свойства для данного умения.
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/value-range-row-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table/id-struct-table/value-range-row-col-4.md -->
Да
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/value-range-row-col-4.md -->
||
|#
<!-- endsource: ru/_includes/reference/struct-table/id-struct-table/state-parameters-float-table.md -->


#### Пример использования {#example}

Платформа умного дома отправляет провайдеру запрос о состоянии устройств пользователя. Провайдер в ответ передает информацию о том, что свойство увлажнителя показывает 55% влажности.


{% list tabs %}

- Запрос


  ```bash translate=no
  curl -i -X POST 'https://example.com/v1.0/user/devices/query' \
  -H 'Authorization: Bearer 123qwe456a...' \
  -H 'X-Request-Id: ff36a3cc-ec...' \
  -H 'Content-Type: application/json' \
  -d '{
        "devices":
        [
          {
              "id": "humidifier-001-hmdfr",
              "custom_data": {
                  "api_location": "rus"
              }
          }
        ]
      }'
  ```


- Ответ


  ```json translate=no
  HTTP/1.1 200 OK

  {
      "request_id": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
      "payload": {
          "devices": [{
              "id": "humidifier-001-hmdfr",
              "properties": [{
                  "type": "devices.properties.float",
                  "state": {
                      "instance": "humidity",
                      "value": 55
                  }
              }]
          }]
      }
  }
  ```

{% endlist %}

<!-- source: ru/_includes/about/id-support/support-button.md -->
[![Служба поддержки](../_images/support-image.svg)](https://yandex.ru/dev/dialogs/smart-home/doc/ru/feedback.md)
<!-- endsource: ru/_includes/about/id-support/support-button.md -->

[*string]:
  Cтрока, выделяется кавычками, например `"Hello world"`.

[*array]:
  Массив элементов, разделенных запятой. Элементом могут быть стандартные элементы JSON: строка, число, `true`, `false`, объект или массив. Массив выделяется квадратными скобками `[]`:

```json translate=no
"cities": ["Moscow", "Tokyo", "New York"]
```

[*float]:
  Число с плавающей точкой с точностью до 6-9 десятичных знаков.

[*object]:
  Список пар `"ключ": значение`, разделенных запятой. Выделяется фигурными скобками `{}`.

```json translate=no
{
  "name": "John",
  "surname": "Smith"
}
```

[*boolean]:
  Логическое значение без кавычек: `true` (истина) или `false` (ложь).