人员

person 集成允许将 设备跟踪器 实体连接到一个或多个人员实体。连接的设备跟踪器的状态更新将设置人员的状态。当使用多个设备跟踪器时，人员的状态将按以下顺序确定：

1. 如果有静态跟踪器（非 GPS 跟踪器，例如路由器或蓝牙设备跟踪器）显示状态 home，则将使用最近更新的跟踪器。
2. 如果有 gps 类型的跟踪器，则将使用最近更新的跟踪器。
3. 否则，将使用状态为 not_home 的最新跟踪器。

假设，例如，您有三个跟踪器：tracker_gps，tracker_router 和 tracker_ble。

1. 您在家中，所有三个设备显示状态为 home - 您的人员实体的状态将是 home，来源为 tracker_router 或 tracker_ble，以最近更新的为准。
2. 您刚刚离开家。tracker_gps 显示状态为 not_home，但其他两个跟踪器显示状态为 home（它们可能尚未由于其 consider_home 设置更新，详见 device_tracker）。由于静态跟踪器具有优先权，您被视为 home。
3. 过了一段时间，两个静态跟踪器显示状态为 not_home。现在您的人员实体状态为 not_home，来源为 tracker_gps。
4. 当您离开家时，您的 Home Assistant 实例重新启动。在 tracker_gps 接收到更新之前，您的状态将由静态跟踪器决定，因为在重启后它们将拥有最新的更新。显然，状态将是 not_home。
5. 然后您进入一个已定义为 zone1 的区域，tracker_gps 发送更新，现在您的状态为 zone1，来源为 tracker_gps。
6. 您已返回家中，您的移动设备已连接到路由器，但 tracker_gps 尚未更新。您的状态将是 home，来源为 tracker_router。
7. 在 tracker_gps 更新发生后，您的状态仍将是 home，来源为 tracker_router 或 tracker_ble，以最近更新的为准。

简而言之，当您在家时，您的位置首先由静态跟踪器（如果有的话）确定，然后由 GPS 确定。当您在家外时，您的位置首先由 GPS 确定，然后再由静态跟踪器确定。

提示：当您同时使用多个设备跟踪器时，特别是静态和 GPS 跟踪器，建议将静态跟踪器的 consider_home 设置为尽可能低，详见 device_tracker。

您可以通过 通过配置面板中的人员页面 UI 或通过您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中的 YAML 来管理人员。

向 Home Assistant 添加人员

如果您拥有管理员权限，您可以向 Home Assistant 添加其他人员并为他们创建用户帐户。根据您赋予他们的权限，他们可以在自己的设备上使用 Home Assistant，拥有自己的仪表板，以及在自动化中使用。

1. 转到 设置 > 人员 并选择 添加人员。
2. 输入他们的 姓名。
3. 如果愿意，可以添加一张图片。
4. 在 允许登录 下，选择他们是否可以登录。
   • 如果他们无法登录，则不会获得用户帐户，无法使用很多 Home Assistant 的功能。
   • 例如，他们无法拥有自己的仪表板。
   • 但他们仍然可以用于设备跟踪，出现在地图上并用于自动化。
5. 如果他们可以登录，请填写用户信息。
   • 检查用户名是否正确。根据人员姓名进行建议，但它们不必完全相同。
     • 用户名必须为小写且不包含空格。
     • 登录时需要用户名。
     • 人员姓名是在 UI 中显示的名称。
   • 输入密码并安全存储。
   • 定义他们是否应该仅限于 本地访问。
     • 如果启用，他们将无法在外部网络访问 Home Assistant，例如在手机上。
   • 定义他们是否应具有 管理员 权限。
   • 选择 创建。
6. 如果您已经设置了 存在检测 的设备，请 选择属于此人员的设备。

自定义人员的图片

您可以轻松地在前端上传图片。只需单击人员，选择或将图像拖放到输入字段中，然后裁剪。

有关 www 文件夹的更多信息，请参阅有关 托管文件 的文档。

通过 Home Assistant 配置面板配置 person 集成

此集成默认启用，除非您在配置中禁用了 default_config: 行。如果是这种情况，以下示例显示了如何手动启用此集成：

person:

通过 YAML 配置 person 集成

如果更喜欢 YAML，您也可以通过您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件配置您的人员：

# 示例 configuration.yaml 条目
person:
  - name: Ada
    id: ada6789
    device_trackers:
      - device_tracker.ada

扩展示例如下：

# 示例 configuration.yaml 条目
person:
  - name: Ada
    id: ada6789
    device_trackers:
      - device_tracker.ada
  - name: Stacey
    id: stacey12345
    user_id: 12345678912345678912345678912345
    device_trackers:
      - device_tracker.stacey
      - device_tracker.beacon

如果您更改 YAML，您可以通过调用 person.reload 操作重新加载它。