2025.3.4
首页 ▸ Integrations ▸

计数器

计数器集成允许您计数自动化触发的事件。

配置

配置计数器助手的首选方式是通过用户界面。要添加一个，请前往 设置 > 设备与服务 > 辅助工具 并点击添加按钮； 接下来选择 计数器 选项。

要能够通过用户界面添加 辅助工具，您应在您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 中包含 default_config:，默认情况下应该会存在，除非您将其删除。如果您从配置中删除了 default_config:，您必须首先将 counter: 添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 中，然后才能使用界面。

计数器也可以通过 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 配置：

# 示例 configuration.yaml 条目
counter:
  my_custom_counter:
    initial: 30
    step: 1

Configuration Variables

Looking for your configuration file?
[alias] map Required

计数器的别名。允许多个条目。alias 应由用户替换为实际值。

name string (Optional)

计数器的友好名称。

initial integer (Optional, default: 0)

Home Assistant 启动时或计数器重置时的初始值（0 或正整数）。

restore boolean (Optional, default: true)

尝试在 Home Assistant 启动时恢复上一个已知值。

step integer (Optional, default: 1)

计数器的增量/步长值。

minimum integer (Optional)

计数器的最小值

maximum integer (Optional)

计数器的最大值

icon icon (Optional)

显示的计数器图标。

选择一个来自 Material Design Icons 的图标用于输入，并将名称前缀为 mdi:。例如 mdi:car、mdi:ambulance 或 mdi:motorbike。

恢复状态

只要您的实体的 restore 设置为 true（默认情况下就是这样），该集成会自动恢复其在 Home Assistant 停止之前的状态。要禁用此功能，请将 restore 设置为 false。

如果 restore 设置为 true，则只有在未找到之前的状态或计数器重置时，initial 值才会使用。

操作

可用的操作：increment、decrement、reset 和 set_value。

操作 counter.increment

将计数器增加 1 或给定的步骤值。

数据属性 可选 描述
entity_id 否 采取行动的实体名称，例如 counter.my_custom_counter。

操作 counter.decrement

将计数器减少 1 或给定的步骤值。

数据属性 可选 描述
entity_id 否 采取行动的实体名称，例如 counter.my_custom_counter。

操作 counter.reset

此操作将计数器重置为其初始值。

数据属性 可选 描述
entity_id 否 采取行动的实体名称，例如 counter.my_custom_counter。

操作 counter.set_value

此操作允许将计数器设置为特定值。

数据属性 可选 描述
entity_id 否 采取行动的实体名称，例如 counter.my_custom_counter。
value 是 将计数器设置为给定的值。

使用操作

从 开发者工具 中选择 操作 选项卡。从 域 列表中选择 counter，选择 操作，在 数据 字段中输入类似以下示例的内容，然后选择 执行操作。

{
  "entity_id": "counter.my_custom_counter"
}

示例

计数 Home Assistant 错误

要使用计数器计数 Home Assistant 捕捉到的错误，您需要在您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 中添加 fire_event: true，如下所示：

# 示例 configuration.yaml 条目
system_log:
  fire_event: true

错误计数 - 示例配置 

# 示例 configuration.yaml 条目
automation:
- alias: "错误计数自动化"
  triggers:
    - trigger: event
      event_type: system_log_event
      event_data:
        level: ERROR
  actions:
    - action: counter.increment
      target:
        entity_id: counter.error_counter
    
counter:
  error_counter:
    name: 错误
    icon: mdi:alert