数值实体#

number 是一种允许用户向集成输入任意数值的实体平台。请从 homeassistant.components.number.NumberEntity 派生你的实体。

#属性

所有实体通用的其他属性（例如 icon、name 等）同样适用。

默认步长会根据取值范围（最大值减最小值）动态选择。如果 max_value 和 min_value 之间的差值大于 1.0，则默认步长为 1.0。否则，步长会持续除以 10，直到小于该范围为止。

#可用设备类别

如果指定了设备类别，你的数值实体还需要返回正确的测量单位。

#恢复数值状态

如果数值实体需要在重启或重新加载后恢复状态，不应继承 RestoreEntity，因为它保存的是 state，而不是 native_value，而 state 可能已经被数值实体基类修改过。

需要恢复状态的数值实体应继承 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。

#方法

#设置值

当用户或自动化希望更新该值时，会调用以下方法。

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."""