在hass-xiaomi-miot项目中为小米香薰机添加手动喷香功能
项目地址: https://gitcode.com/gh_mirrors/ha/hass-xiaomi-miot 小米智能香薰机XW002通过hass-xiaomi-miot插件接入Home Assistant后，默认可能缺少手动触发喷香的功能。本文将详细介绍如何通过配置扩展这一实用功能。
设备功能分析
XW002香薰机在小米生态中支持两种喷香模式：
- 自动模式：按照预设时间间隔自动释放香气
- 手动模式：用户主动触发即时喷香
通过查阅设备规范文档，可以确认该设备确实支持手动喷香功能（fragrance-delivery），对应的服务ID为2，属性ID为1。
实现方案
方案一：通过服务直接调用
使用Home Assistant的xiaomi_miot.set_miot_property服务可以直接触发喷香动作：
service: xiaomi_miot.set_miot_property
data:
entity_id: switch.xiaomi_diffuser # 替换为实际的开关实体ID
siid: 2 # 服务ID
piid: 1 # 属性ID
value: true # 触发喷香
这种方法适合在自动化场景中使用，可以精确控制喷香时机。
方案二：通过配置添加按钮实体
更友好的方式是在配置文件中添加按钮动作，系统会自动创建一个专用按钮实体：
xiaomi_miot:
device_customizes:
xiaomi.diffuser.xw002:
button_actions: fragrance_delivery
配置完成后需要重启Home Assistant，之后会在设备实体列表中出现一个新的按钮实体，点击即可手动触发喷香。
使用建议
- 响应延迟：由于指令需要通过小米云端中转，可能会有1-2秒的执行延迟
- 频率限制：不建议设置过于频繁的触发，避免设备保护机制启动
- 状态反馈：喷香动作执行后，可以通过设备的剩余香氛时间属性来确认是否成功
进阶应用
结合Home Assistant的自动化功能，可以实现更多智能场景：
- 当检测到有人进入房间时自动喷香
- 根据时间段调节喷香频率
- 与其他智能设备联动（如开启空调时同步喷香）
通过以上方法，用户可以充分发挥小米香薰机的全部功能，实现更加个性化的智能家居体验。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
