--- metadata: - name: generator content: Diplodoc Platform v5.48.2 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 --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/en/llms.txt # Float `devices.properties.float` Displaying device property values in numeric format. ## Property description {#discovery} The structure is used in the response to the [Information about user devices](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference/get-devices.md) operation. #### Property parameters {#parameters} #| || **Parameter** | **Type** | **Description** | **Required** || || type | [String](*string) | Property type. | Yes || || retrievable | [Boolean](*boolean) | Whether it's possible to request the state of the device property. Acceptable values: - `true`: A state request is available for the property. Default value. - `false`: A state request is not available for the property. The value is available if `reportable:true`. | No || || reportable | [Boolean](*boolean) | Whether the property reports the state change to Yandex Smart Home using the [notification service](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference-alerts/post-skill_id-callback-state.md). Acceptable values: - `true`: Notification is enabled. The manufacturer notifies Yandex Smart Home of every property state change. - `false`: Notification is disabled. The manufacturer doesn't notify Yandex Smart Home of the property state change. Default value. | No || || parameters | [Object](*object) | `parameters` object. | Yes || |# **`parameters` object** #| || **Parameter** | **Type** | **Description** | **Required** || || instance | [String](*string) | Function name for the property. You can find the acceptable values in the [List of functions](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/float-instance.md) section. | Yes || || unit | [String](*string) | Function value units. You can find the acceptable values in the [List of functions](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/float-instance.md) section. | Yes || |# #### Example of use {#example} Yandex Smart Home requests the details of user devices from the provider. The provider responds that the user has a humidifier with a humidity property. {% list tabs %} - Request ```bash translate=no curl -i -X GET 'https://example.com/v1.0/user/devices' \ -H 'Authorization: Bearer 123qwe456a...' \ -H 'X-Request-Id: ff36a3cc-ec...' ``` - Response ```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 %} ## Current property state {#state} The structure is used in the response to the [Information about the states of user devices](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference/post-devices-query.md) operation and in the request body of the [Notification about device state change](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference-alerts/post-skill_id-callback-state.md) operation. #### Property parameters {#parameters} #| || **Parameter** | **Type** | **Description** | **Required** || || type | [String](*string) | Property type. | Yes || || state | [Object](*object) | Property state parameters. | Yes || |#
**`state` object** #| || **Parameter** | **Type** | **Description** | **Required** || || instance | [String](*string) | Function name for the property. You can find the acceptable values in the [List of functions](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/float-instance.md) section. | Yes || || value | [Float](*float) | Property value for this capability. | Yes || |# #### Example of use {#example} Yandex Smart Home requests the provider to change the state of the user device. The provider responds that the humidifier's property shows 55% humidity. {% list tabs %} - Request ```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" } } ] }' ``` - Response ```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 %} [*string]: String enclosed in quotation marks, for example: `"Hello, world"`. [*array]: An array of elements separated by a comma. As array items, you can use standard JSON elements: a string, number, `true`, `false`, object, or array. Arrays are enclosed in square brackets `[]`: ```json translate=no "cities": ["Moscow", "Tokyo", "New York"] ``` [*float]: Floating-point number with a precision of 6-9 decimal digits. [*object]: List of `"key": value` pairs separated by commas. The list is enclosed in curly brackets `{}`. ```json translate=no { "name": "John", "surname": "Smith" } ``` [*boolean]: Boolean value without quotes: `true` or `false`.