Home Assistant 中用 unifiprotect.remove_doorbell_text 自动化移除 UniFi Protect 门铃自定义文字【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南讲解 Home Assistant 中 UniFi Protect 集成的unifiprotect.remove_doorbell_text服务它的作用边界、UI 与 YAML 两种调用方式、全部参数含义以及如何与unifiprotect.add_doorbell_text搭配实现“白天添加门屏提示语、傍晚自动清除”的定时清理方案。读完后你可以独立编写该服务的完整自动化并理解“按实例而非按设备”这一行为特征。服务定位与适用场景unifiprotect.remove_doorbell_text的功能很单一但很实用从 UniFi Protect 门铃的可用文字列表中删除一条自定义消息。UniFi Protect 门铃如 G4 系列门铃的 LCD 屏可以显示自定义文字或预设文字UniFi Protect 集成文档在“Device Configuration”部分明确列出了这一能力configuration text and select for LCD Screen for doorbells to either set custom messages or use predefined messages也就是说集成不仅提供实体级的 LCD 文字控制还提供成对的服务action来管理文字列表本身unifiprotect.add_doorbell_text向列表添加一条自定义消息文档unifiprotect.remove_doorbell_text从列表中删除一条已存在的自定义消息本文主角。典型使用场景你通过 Add doorbell text 在出门期间添加了一条“Leave parcels next door”包裹放旁边之类的提示语傍晚回家后希望它自动从列表里清掉避免下次误选。删除操作不会改变当前屏幕上正在显示的文字只影响“可选文字列表”。运行前提结合 UniFi Protect 集成文档可以确认几条适用前提连接模式该服务属于“Actions”在API key only模式下不可用文档明确写道 “Actions, the media source, and the proxy views are not available in this mode”。因此必须使用Full access本地用户 API key模式配置集成软件版本Home Assistant 要求 UniFi Protect7.2.105或更高版本且仅支持运行在 UniFi OS Console 上的 UniFi Protect不支持容器自托管的第三方移植版本设备要求门铃需具备可显示自定义文字的 LCD 屏G4 系列门铃支持。在用户界面UI中使用如果你习惯可视化方式编写自动化Home Assistant 会引导你逐步完成。操作步骤如下进入SettingsAutomations scenes打开一个已有的自动化或脚本或选择Create新建若是新建自动化先在When部分添加触发器脚本不需要触发器在Then do部分选择Add action在搜索框中搜索并选择UniFi Protect: Remove doorbell text从你想变更的 UniFi Protect 实例中选择任意一台设备在Custom message字段中输入要删除的完全一致的文字内容选择Save保存。UI 中的选项说明选项UI 显示名说明UniFi Protect NVR要变更的 UniFi Protect 实例中的任意一台设备。当接入多个 Protect 实例时这个选择决定了操作作用在哪个实例上Custom message要删除的已有自定义消息必须与现有文字完全匹配在 YAML 中使用在 YAML 中该服务的名称为unifiprotect.remove_doorbell_text。最基础的最小调用示例action: | action: unifiprotect.remove_doorbell_text data: device_id: 1234567890abcdef1234567890abcdef message: Come in这条语句的作用从该 UniFi Protect 实例的门铃文字选项中删除消息 “Come in”。注意示例中device_id是一串十六进制 ID可在 Home Assistant 的设备信息页设备信息 复制设备 ID中查到。YAML 参数全解参数类型必填说明device_idstring是目标 UniFi Protect 实例中任意一台设备的 ID。它的作用不是指定“要操作哪台门铃”而是把请求路由到正确的 Protect 实例——因为门铃文字列表是实例级资源选同一实例下的任何设备门铃、摄像头、NVR 均可都能定位到该实例messagestring是要删除的已有自定义消息。必须与该消息逐字符完全匹配区分大小写和空格不匹配时该服务不会删除任何东西也不报错行为要点Good to know原文档特别强调了两点这也是实际使用中最容易踩坑的地方精确匹配静默失败你提供的message必须与现有门铃文字完全一致否则什么都不会被删除。建议删除前先在门铃 App 或 UniFi Protect 界面上确认文字原文注意末尾空格和英文标点按实例寻址而非按门铃由于该操作作用于整个 UniFi Protect 实例文字列表挂在 NVR/实例上而不是某台具体门铃上你只需要挑选该实例中的任意一台设备作为device_id即可。手动试跑开发者工具不想先写 YAML 验证效果进入SettingsToolsActions开发者工具搜索unifiprotect.remove_doorbell_text填入device_id和message两个字段后点击Perform action即可在不修改任何配置文件的情况下对真实设备做一次实测。这是调试这类“静默失败”服务的最佳手段先确认实例选对了、再确认文字拼写对了最后才落到自动化里。实战自动化傍晚定时清理临时提示语原文档给出的完整实战案例与 Add doorbell text 配对使用——白天添加一条临时提示傍晚定时移除形成“有进有出”的完整闭环。触发器定时scheduled time动作UniFi Protect: Remove doorbell text完整 YAML 如下automation: | alias: Remove the morning doorbell message triggers: - trigger: time at: 18:00:00 actions: - action: unifiprotect.remove_doorbell_text data: device_id: 1234567890abcdef1234567890abcdef message: Leave parcels next door配套的另一半早上 08:00 添加消息可直接复用 Add doorbell text 文档中的示例automation: | alias: Add a morning doorbell message triggers: - trigger: time at: 08:00:00 actions: - action: unifiprotect.add_doorbell_text data: device_id: 1234567890abcdef1234567890abcdef message: Leave parcels next door两条自动化共用同一条消息文本与同一device_id即可实现 08:00 提示语上架、18:00 自动下架。注意添加侧还有一条约束消息必须短于 30 个字符来自 add 服务文档删除侧则没有长度限制只有精确匹配要求。与相邻服务的关系UniFi Protect 域内与门铃相关的服务从文档结构上看形成一个小组Add doorbell text向文字列表添加消息30 字符以内Remove doorbell text本文主题按精确文本删除Set chime paired doorbells管理 Smart Chime 与门铃的配对关系——它管“哪台门铃让哪个门铃响铃器响”与文字列表管理相互独立。集成文档中同样记录了 Smart Chime 会获得一个手动触发响铃的 Button 实体和音量滑块可结合响铃类自动化一并设计。小结unifiprotect.remove_doorbell_text通过device_id实例内任意设备message逐字符精确匹配两个必填字符串参数从 UniFi Protect 实例级文字列表中删除一条自定义门铃消息该服务仅在 Full access 连接模式下可用要求 UniFi Protect ≥ 7.2.105 且运行于 UniFi OS Console不匹配时静默失败建议先用开发者工具Settings Tools Actions手动试跑确认拼写与实例与unifiprotect.add_doorbell_text组成添加/移除闭环配合time触发器即可实现门屏提示语的定时发布与自动清理。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考