Home Assistant Floor Plan Generator高级配置：自定义实体图标、交互动作与显示条件

【免费下载链接】home-assistant-floor-planHome Assistant Floor Plan Generator Plugin For Sweet Home 3D项目地址: https://gitcode.com/gh_mirrors/ho/home-assistant-floor-plan

Home Assistant Floor Plan Generator是一款专为Sweet Home 3D打造的插件，能够帮助用户轻松创建智能家居可视化控制面板。通过自定义实体图标、交互动作和显示条件，你可以打造出既美观又实用的个性化智能家居控制界面，让家居管理更加直观高效。

一、自定义实体图标：打造个性化视觉体验

实体图标是家居控制界面的视觉核心，通过自定义图标可以让不同类型的设备在平面图中一目了然。

1.1 图标覆盖功能实现

在src/com/shmuelzon/HomeAssistantFloorPlan/Entity.java文件中，提供了图标覆盖（iconOverride）功能。你可以通过设置iconOverride属性来替换默认图标：

public void setIconOverride(String iconOverride) { this.iconOverride = iconOverride; settings.set(name + "." + SETTING_NAME_ICON_OVERRIDE, iconOverride.isEmpty() ? null : iconOverride); }

1.2 图标设置方法

1. 打开实体选项面板（EntityOptionsPanel）
2. 在图标覆盖文本框中输入自定义图标名称
3. 系统会自动应用新图标并保存设置

提示：图标名称需符合Home Assistant的图标命名规范，例如使用"mdi:lightbulb"表示灯泡图标。

二、配置交互动作：提升用户操作体验

交互动作决定了用户与平面图中实体的互动方式，合理配置可以大大提升操作效率。

2.1 支持的交互动作类型

在Entity.java中定义了多种交互动作类型：

public enum Action {MORE_INFO, NAVIGATE, NONE, TOGGLE}

• MORE_INFO：点击显示更多信息
• NAVIGATE：导航到指定页面
• NONE：无动作
• TOGGLE：切换设备状态（开/关）

2.2 配置点击、双击和长按动作

你可以分别为实体配置点击（tap）、双击（doubleTap）和长按（hold）三种不同的动作：

public void setTapAction(Action tapAction) { this.tapAction = tapAction; settings.set(name + "." + SETTING_NAME_TAP_ACTION, tapAction.name()); } public void setDoubleTapAction(Action doubleTapAction) { this.doubleTapAction = doubleTapAction; settings.set(name + "." + SETTING_NAME_DOUBLE_TAP_ACTION, doubleTapAction.name()); } public void setHoldAction(Action holdAction) { this.holdAction = holdAction; settings.set(name + "." + SETTING_NAME_HOLD_ACTION, holdAction.name()); }

2.3 导航动作配置

对于NAVIGATE类型的动作，还可以设置导航路径：

if (action == Action.NAVIGATE) yaml += String.format("\n" + " navigation_path: %s", value);

三、设置显示条件：优化界面信息展示

通过设置显示条件，可以根据设备状态动态控制实体在平面图中的显示方式。

3.1 显示条件类型

系统支持多种显示条件：

public enum DisplayCondition {ALWAYS, NEVER, AVAILABLE, WHEN_ON, WHEN_OFF}

• ALWAYS：始终显示
• NEVER：从不显示
• AVAILABLE：仅当设备可用时显示
• WHEN_ON：仅当设备开启时显示
• WHEN_OFF：仅当设备关闭时显示

3.2 条件应用实现

显示条件通过YAML配置应用到实体：

String state_condition = "state_not: unavailable"; if (displayCondition != DisplayCondition.AVAILABLE) state_condition = "state: " + (displayCondition == DisplayCondition.WHEN_ON ? "on" : "off"); return String.format( " - type: conditional\n" + " conditions:\n" + " - condition: state\n" + " entity: %s\n" + " %s\n" + " elements:\n" + "%s", name, state_condition, yaml.replaceAll(".*\\R", " $0") );

四、实际应用示例

下面是一个完整的智能家居平面图示例，展示了自定义图标、交互动作和显示条件的实际效果：

在这个示例中：

• 灯光设备使用自定义灯泡图标
• 温度传感器以标签形式显示当前温度
• 点击灯光图标可以切换开关状态（TOGGLE动作）
• 长按设备图标显示更多信息（MORE_INFO动作）
• 只有当设备处于开启状态时才显示某些图标

五、总结

通过Home Assistant Floor Plan Generator的高级配置功能，你可以轻松打造个性化的智能家居控制界面。无论是自定义实体图标、配置交互动作还是设置显示条件，都能帮助你创建既美观又实用的家居控制中心。

掌握这些高级配置技巧后，你可以根据自己的需求和喜好，设计出最适合自己家庭的智能家居控制界面，让家居管理变得更加简单直观。

【免费下载链接】home-assistant-floor-planHome Assistant Floor Plan Generator Plugin For Sweet Home 3D项目地址: https://gitcode.com/gh_mirrors/ho/home-assistant-floor-plan