Home Assistant 中 Nintendo Switch 家长控制 Bonus Time 动作配置指南与自动化实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读nintendo_parental_controls.add_bonus_time是 Home Assistant 中Nintendo Switch 家长控制Parental Controls集成提供的动作action用于在 Nintendo Switch 的每日最大屏幕时间之上追加额外游戏时间。本文面向使用该集成的家长用户讲解如何通过 UI 与 YAML 两种方式调用此动作、各参数含义与取值范围并给出可复制的自动化示例如完成家务后奖励额外游戏时间。读完本文你将能独立编写、调试并部署基于该动作的自动化与脚本。动作是什么一次额外游戏时间的发放Add bonus time添加奖励时间动作会在 Nintendo Switch 当前允许的最大屏幕时间之上额外授予一段屏幕使用时间。典型使用场景是当希望某个自动化在孩子完成家务或适逢特殊场合时奖励一点点额外的游玩时间。在 Home Assistant 中动作本身并不支持 targets。也就是说在 UI 中你不会被提示选择区域area、实体entity或标签label取而代之的是通过Device选项直接选定要发放奖励时间的 Nintendo Switch 设备。这一点与支持 target 的通用动作如开关类动作有明显区别使用时需注意。从集成整体看该动作隶属于在 2025.11 版本发布、质量等级为 bronze 的 Nintendo Switch 家长控制集成ha_domain: nintendo_parental_controlsIoT 类别为Cloud Polling即云端轮询。集成本身通过 Home Assistant Config Flow 完成配置并提供了number最大屏幕时间、select限制模式、sensor已用时间/剩余时间、switch挂起软件、time就寝时间等实体平台本文的动作正是对这套实体体系在额外奖励维度上的补充。通过 UI 使用该动作如果偏好可视化地构建自动化和脚本Home Assistant 会引导你逐步完成此动作的配置——选择设备、微调选项并保存全程无需编写 YAML。操作步骤进入SettingsAutomations scenes自动化与场景。打开一个现有的自动化或脚本或者选择Create automationCreate new automation新建自动化 新建自动化。如果正在新建自动化请在When何时执行部分添加一个触发器。脚本不需要触发器它们在被其他内容调用时运行。在Then do然后执行部分选择Add action添加动作。在搜索框中搜索并选择Nintendo Switch parental controls: Add bonus time。选择Device设备然后输入Bonus time奖励时间。选择Save保存。UI 中的选项选项说明Device要添加奖励时间的 Nintendo Switch 设备。Bonus time要添加的奖励时间量单位为分钟取值范围为5 到 30。通过 YAML 使用该动作如果直接使用 YAML 工作或想确切了解 Home Assistant 在底层做了什么可使用以下技术参考。它列出了 YAML 中使用的字段名、类型以及哪些是必填项。在 YAML 中该动作的标识为nintendo_parental_controls.add_bonus_time。一个基础示例action: nintendo_parental_controls.add_bonus_time data: device_id: 1b4a46c6d0f3406c80d275f5b0c6483b bonus_time: 15此示例向选定的 Nintendo Switch 添加15 分钟的奖励屏幕时间。YAML 选项字段必填类型说明device_id是string要添加奖励时间的 Nintendo Switch 设备的 ID。bonus_time是integer要添加的奖励时间量单位为分钟取值范围为5 到 30。提示device_id与实体 ID 不同它是设备在 Home Assistant 设备注册表中的唯一标识。可在Settings Devices services中打开对应 Nintendo Switch 设备页面获取也可在 YAML 编辑器中通过自动补全选择。参数边界说明bonus_time的取值范围5–30 分钟由任天堂在服务端设定并非 Home Assistant 侧可更改的配置。这一点也在集成文档的 Known limitations 中明确说明The range used for bonus time is set by Nintendo and therefore cannot be changed.用于奖励时间的范围由任天堂设定因此无法更改。若传入超出范围的值动作会被拒绝或按服务端规则处理建议在自动化中严格控制输入。先试后用Developer Tools 直接执行想在编写任何 YAML 之前先验证动作是否正常打开SettingsToolsActions开发工具 操作搜索该动作填写字段并选择Perform action执行操作。你会在真实实体上看到效果而无需编写一行 YAML——这对于验证device_id是否填写正确尤其方便。实战自动化完成家务奖励屏幕时间这是官方文档提供的真实场景示例每当记录家务完成状态的 helper辅助元素被开启时自动化即发放 15 分钟额外屏幕时间。触发器chores-done helper 被打开动作向 Nintendo Switch 添加奖励时间设备孩子的 Nintendo Switch奖励时间15automation: alias: Bonus screen time for finished chores triggers: - trigger: state entity_id: input_boolean.chores_done to: on actions: - action: nintendo_parental_controls.add_bonus_time data: device_id: 1b4a46c6d0f3406c80d275f5b0c6483b bonus_time: 15使用要点先创建input_boolean.chores_done这个辅助元素在Settings Devices services Helpers中创建否则触发器引用的实体不存在自动化无法生效。触发器在chores_done变为on时触发一次。若希望再次开启也能再次奖励注意 state 触发默认只在状态变化时触发可在触发器高级选项勾选Trigger even if the state is the same或结合其他条件设计。若家中有多台 Switch可针对不同device_id分别创建自动化避免奖励发错设备。延伸与集成其他实体的配合思路从 集成文档 可知该集成提供的实体可与本动作形成完整的限时—奖励—监控闭环Max screentime todaynumber设置今日允许的最大屏幕时间设为-1表示不限时。将其设为0并打开Suspend software开关可以实现锁定 Switch 的效果——当孩子想继续玩时自动化触发本动作追加 5–30 分钟奖励时间实现任务驱动解锁。Used screen time / Time remainingsensor单位分钟device classduration可读取当前已用与剩余屏幕时间作为自动化的触发条件或通知内容。Bedtime alarm / Bedtime end timetime设定就寝时间到点后 Switch 会锁屏或左上角显示提醒与奖励动作形成时间窗口管理。例如可以构建一个自动化当sensor.time_remaining低于 5 分钟且孩子完成了某项任务时才调用本动作追加 15 分钟。将传感器状态变化、输入布尔辅助元素与add_bonus_time组合即可实现真正贴合家庭规则的自定义家长控制策略。常见问题与注意事项动作不生效时先查设备device_id必须属于 Nintendo Switch 家长控制集成下的设备。若提示设备无效请在Settings Devices services确认该设备已正确配置且在线。数据未更新集成依赖云端轮询Cloud Polling必须保证 Switch 可以联网否则使用数据不会上报到任天堂动作与传感器可能表现异常。奖励时间范围不可修改5–30 分钟是任天堂设定的固定范围Home Assistant 无法更改。多设备管理每一台 Switch 对应一个device_id同一个自动化若需覆盖多台设备需要分别调用动作或在脚本中循环处理。小结nintendo_parental_controls.add_bonus_time是 Nintendo Switch 家长控制集成中正向激励的关键动作通过 UI 三步即可完成配置通过 YAML 可精确控制device_id与bonus_time5–30 分钟。将其与状态触发器、传感器和辅助元素组合即可构建完成任务 → 自动奖励游戏时间的完整自动化闭环。相关姊妹动作 Update PIN code 可用于定期重置家长控制密码两者常搭配使用以完善家长控制策略。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考