Number entity#

number 是一种允许用户向集成输入任意值的 entity。从 homeassistant.components.number.NumberEntity 派生 entity platforms。

#属性

其他在所有 entity 中通用的 properties（如 icon、name 等）也适用。

默认 step 值根据 range（max - min）值动态选择。如果 max_value 和 min_value 之间的差值大于 1.0，则默认 step 为 1.0。如果 range 较小，则 step 会迭代除以 10，直到小于 range。

#可用的设备类型

如果指定 device class，你的 number entity 还需要返回正确的计量单位。

#恢复 number 状态

在 restart 或 reload 后恢复 state 的 numbers 不应扩展 RestoreEntity，因为它不存储 native_value，而是存储可能被 number base entity 修改的 state。恢复 state 的 numbers 应扩展 RestoreNumber，并从 async_added_to_hass 调用 await self.async_get_last_number_data，以访问存储的 native_min_value、native_max_value、native_step、native_unit_of_measurement 和 native_value。

#方法

#设置值

当用户或 automation 想要更新 value 时调用。

class MyNumber(NumberEntity):
    # 实现以下方法之一。

    def set_native_value(self, value: float) -> None:
        """Update the current value."""

    async def async_set_native_value(self, value: float) -> None:
        """Update the current value."""