Home Assistant 中 Reolink Chime 铃声播放动作 `reolink.play_chime` 完整使用指南

Home Assistant 中 Reolink Chime 铃声播放动作reolink.play_chime完整使用指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文基于 source/_actions/reolink.play_chime.markdown 编写系统讲解 Home Assistant Reolink 集成中“播放铃声Play chime”动作的用途、UI 配置流程、YAML 调用语法、参数细节与典型自动化场景并结合 Reolink 集成文档 补充 Chime 相关实体与联动配置帮助你快速让门铃铃声在指定 Reolink Chime 设备上响起。动作概述什么是reolink.play_chimereolink.play_chime是 Home AssistantReolink 集成提供的一个动作action用于在一台或多台 Reolink Chime 设备上播放指定的铃声ringtone。它最常见的用途是在自动化中触发——例如当摄像机检测到运动、人或门铃被按下时播放铃声以提醒家人。从源码文档的 front matter 可以看出该动作的核心定义见 source/_actions/reolink.play_chime.markdown动作名reolink.play_chime所属域domainreolink功能描述在一台或多台 Reolink Chime 上播放铃声关联动作reolink.ptz_move云台移动需要特别强调的是该动作只适用于 Reolink Chime 设备。其他 Reolink 设备摄像头、NVR、Home Hub 等不会出现在可选目标中。前置条件正确接入 Chime 设备要使用该动作首先需要完成以下前置工作在 Home Assistant 中通过配置流程Config Flow接入 Reolink 集成详见 Reolink 集成文档 的 “Prerequisites” 与 “Initial setup” 章节需要网络连通、管理员账号、符合字符集要求的密码等。将 Reolink Chime 正确连接到门铃Video Doorbell或 Home Hub使其出现在 Home Assistant 的设备列表中。集成文档的“Tested directly connected models”一节明确列出了Reolink Chime当连接到门铃或 Home Hub 时属于已测试可用型号见 source/_integrations/reolink.markdown。如果 Chime 没有出现在 Home Assistant 中请确认它已配对成功若需要移除旧 Chime可按集成文档 “Removing a chime” 的步骤操作见 source/_integrations/reolink.markdown。与 Chime 相关的实体配置联动在 Reolink 集成文档 中与 Chime 强相关的实体还包括Chime volumenumber 实体控制 Chime 的音量。Chime silent timenumber 实体设置静音时间段。Chime motion ringtone / person ringtone / pet ringtone / vehicle ringtone / visitor ringtoneselect 实体分别为运动、人、宠物、车辆、访客等事件配置对应的铃声。Chime LEDswitch 实体控制 Chime 的 LED 指示灯。Hardwired chime enabledswitch 实体有线门铃鸣响开关注意轮询该开关状态可能让部分型号的 Chime 轻微发出咔嗒声因此其状态仅在集成启动后约 1 分钟轮询一次。这些实体配合reolink.play_chime动作可以构建完整的“事件触发 铃声提醒”体验事件触发类实体负责检测play_chime负责主动播放指定铃声。从用户界面UI使用该动作如果你更喜欢可视化地构建自动化和脚本Home Assistant 会逐步引导你完成配置无需编写 YAML。操作步骤如下原文见 source/_actions/reolink.play_chime.markdown进入设置Settings 自动化与场景Automations scenes。打开一个已有的自动化或脚本或者选择创建自动化Create automation 创建新自动化Create new automation。如果是新建自动化在当…时When部分添加一个触发器脚本不需要触发器脚本在被其他内容调用时才运行。在然后执行Then do部分选择添加动作Add action。在搜索框中搜索并选择Reolink: Play chime。选择要播放铃声的Target chime目标 Chime和Ringtone铃声。点击保存Save。注意该动作不支持 targets目标选择器。在 UI 中它不会提示你选择区域、设备、实体或标签area、device、entity、label而是通过Target chime选项直接指定 Chime 设备。这是该动作与多数支持 targets 的动作的重要区别。UI 中的选项UI 中提供两个选项见 source/_actions/reolink.play_chime.markdown选项说明Target chime要播放铃声的 Reolink Chime 设备。Ringtone要播放的铃声。在 YAML 中使用该动作在自动化、脚本或开发者工具中直接写 YAML 时动作名为reolink.play_chime。文档给出的基础示例如下见 source/_actions/reolink.play_chime.markdownaction: reolink.play_chime data: device_id: - 12a34b56c7d8ef9ghijklm0n1op2345q ringtone: operetta该示例会在指定的 Reolink Chime 上播放operetta铃声。YAML 选项详解YAML 字段定义见 source/_actions/reolink.play_chime.markdown字段必填类型说明device_id是list列表要播放铃声的 Reolink Chime 的设备 ID 列表。注意此处填的是 Chime 设备的 device ID而非实体 ID。ringtone是string字符串要播放的铃声名称可选值固定为以下 10 种之一citybird、originaltune、pianokey、loop、attraction、hophop、goodday、operetta、moonlight、waybackhome。由于device_id是列表类型你可以同时向多台 Chime播放同一铃声例如action: reolink.play_chime data: device_id: - 12a34b56c7d8ef9ghijklm0n1op2345q - 98z76y54x32w1v0u9t8s7r6q5p4o3n2m ringtone: goodday在自动化中组合使用一个典型的“检测到运动后播放铃声”自动化示例如下结合 UI 流程与 YAML 字段可在设置 自动化与场景中通过“编辑为 YAML”直接粘贴alias: Play chime on motion triggers: - trigger: state entity_id: binary_sensor.reolink_motion_detected to: on actions: - action: reolink.play_chime data: device_id: - 12a34b56c7d8ef9ghijklm0n1op2345q ringtone: hophop快速测试在开发者工具中试运行想在不写任何 YAML 的情况下验证动作效果打开设置Settings 工具Tools 动作Actions搜索该动作填写字段并点击执行动作Perform action即可在真实实体上看到播放效果见 source/_includes/actions/try_it.md。这是调试铃声选择与设备 ID 是否正确的快捷途径。Good to know注意事项仅限 Reolink Chime该动作只适用于 Reolink Chime 设备其他 Reolink 设备不会显示为目标见 source/_actions/reolink.play_chime.markdown。device_id 而非实体 IDYAML 中传入的是 Chime 的设备 ID 列表建议先在开发者工具中查看目标 Chime 设备的 device ID 再填入。不支持 targets无法使用区域、设备、实体或标签作为目标只能通过Target chime/device_id显式指定 Chime。铃声名称必须精确匹配ringtone取值是固定枚举共 10 个拼写错误会导致动作失败。相关动作该动作的 front matter 中声明了一个相关动作reolink.ptz_move云台移动用于与 PTZ 摄像头联动。若你需要在播放铃声的同时控制摄像头云台可参考 reolink.ptz_move 动作文档 组合使用。小结reolink.play_chime是一个聚焦、轻量的动作一次调用即可让一台或多台 Reolink Chime 播放指定铃声非常适合在运动检测、访客到达等自动化场景中作为本地音频提醒。掌握它的关键在于三点确认 Chime 已正确接入 Reolink 集成、在 UI 或 YAML 中使用Target chime/device_id显式指定设备、并从 10 个固定铃声枚举中选择准确的ringtone值。配合 Reolink 集成文档 中提到的 Chime 音量、静音时间、事件铃声等实体可以构建出完整的本地化铃声提醒方案。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考