Android小部件
该 
Android 应用程序允许用户在主屏幕上创建小部件，以便用户可以执行各种操作，例如执行操作、显示实体的状态或甚至呈现模板。您可以像通常在任何应用程序中一样根据设备的启动器添加小部件。当数据节省模式启用时，小部件将无法工作，您还需要确保应用程序的后台数据已启用。如果您发现小部件不再工作，请尝试重新创建它。也可以通过导航到 设置 > Companion App > 管理小部件来编辑小部件，如果您在 Android 12 上，也可以通过长按小部件并单击编辑图标来编辑小部件。
只要设备支持，也可以从管理小部件设置页面添加小部件。
可用小部件
动作按钮
此小部件在被点击时将执行一个动作。如果调用成功，用户将看到一个绿色的勾号，如果不成功，则显示红色。红色表示小部件未正确设置、Home Assistant 服务器不可用或其他在 Home Assistant 日志中指示的错误。
您可以设置复选框“需要身份验证”。如果选中，则在执行操作之前需要设备凭据（即 PIN、模式、生物识别……）。
- 在主屏幕的任何空白处长按
- 在小部件列表中向下滚动到 Home Assistant
- 将动作按钮小部件拖到主屏幕的空白处
- 选择您希望执行的操作
- 填写所选操作所需的操作数据
- 为小部件提供名称和图 标
- 保存小部件
实体状态
当实体状态更改或手动刷新时，此小部件将被更新。该小部件将允许用户选择他们希望获取状态和属性的任何实体，并设置文本大小，并在状态和属性之间添加自定义分隔符。
- 在主屏幕的任何空白处长按
- 在小部件列表中向下滚动到 Home Assistant
- 将实体状态小部件拖到主屏幕的空白处
- 输入您希望查看状态的实体 ID
- 如果需要，选择属性复选框并选择您希望添加到状态的属性
- 如果需要，调整小部件文本大小
- 如果需要，添加自定义分隔符以位于状态和属性之间
- 如果支持，选择小部件的点击操作：切换实体或手动刷新状态（如果不支持，单击将刷新）
- 为小部件提供名称
- 保存小部件
媒体播放器
此小部件将让用户控制主屏幕上的任何媒体播放器，并在媒体播放器状态更改或点击专辑封面时进行更新。可以隐藏或显示查找和跳过按钮的几个选项可供选择。
- 在主屏幕的任何空白处长按
- 在小部件列表中向下滚动到 Home Assistant
- 将媒体播放器小部件拖到主屏幕的空白处
- 输入您希望控制的实体 ID。您也可以输入多个实体 ID，按从左到右的优先级排序。
- 如果需要，隐藏查找/跳过按钮、媒体源标签，或显示音量按钮
- 为小部件提供标签
- 保存小部件
图片
此小部件显示相机或图像实体的最新快照，并每小时更新或在点击小部件时更新（基于配置的点击操作）。
- 在主屏幕的任何空白处长按
- 在小部件列表中向下滚动到 Home Assistant
- 将相机小部件拖到主屏幕的空白处
- 输入您希望使用的相机的实体 ID
- 选择点击时的期望操作（“刷新”以从相机更新图像，“打开”以打开相机实体）
- 保存小部件
模板
此小部件将显示您希望在小部件中显示的任何文本，使用 Home Assistant 的模板功能。这是一个高级功能，但允许用户显示各种数据。模板将在相关状态更改时瞬间更新。编辑小部件时，模板将显示在文本框下面，以便您可以预览它的外观。
您还可以使用 HTML 来格式化所显示的文本，例如添加新行（<br>）、加粗某些内容（<b>）或放大（<big>）、改变颜色（<font color='#03a9f4'>）或将其对齐至行的开始或结束（<p style="text-align: end">）。
如果小部件中的模板未即时更新，您很可能遇到了 速率限制。尝试优化您的模板以获取更快的更新，或点击小部件以手动更新。您还可以在 开发者工具 > 模板 中使用预览来测试您的模板更新。
- 在主屏幕的任何空白处长按
- 在小部件列表中向下滚动到 Home Assistant
- 将模板小部件拖到主屏幕的空白处
- 填写模板数据并观察下面的渲染效果
- 保存小部件
主题
大多数小部件允许选择要使用的主题。可用的主题取决于您的设备和特定小部件。可能的选项包括：
- 动态颜色：使用设备和墙纸的颜色，使小部件与您的主屏幕和设备协调。这一主题仅在支持的设备上运行 Android 12 或更新版本时可用。
- 浅色/深色主题：使用您的设备主题使小部件与您的应用程序协调。
- 透明：去除小部件背景，并允许您设置文本/图标颜色，使小部件更不显眼。