hass-unifi-access：无缝集成Unifi Access与Home Assistant

hass-unifi-access：无缝集成Unifi Access与Home Assistant

hass-unifi-access Unifi Access Integration for Home Assistant 项目地址: https://gitcode.com/gh_mirrors/ha/hass-unifi-access

项目介绍

hass-unifi-access 是一个专门为 Home Assistant 定制的开源集成项目，它允许用户将 Unifi Access 门禁系统与 Home Assistant 智能家居平台无缝对接。通过这一集成，用户可以在 Home Assistant 中实时监控和控制 Unifi Access 门禁系统的各项功能，包括门的状态、门铃事件以及锁定状态等。

项目技术分析

hass-unifi-access 项目基于 Python 开发，利用 Home Assistant 的自定义组件机制实现了与 Unifi Access API 的交互。它通过 API Token 认证来获取 Unifi Access 系统的数据，并在 Home Assistant 中创建了相应的实体，如门锁、门位置传感器和事件实体等，以支持进一步的控制和自动化。

技术实现要点：

• API Token 认证：通过 Unifi Access 的 Security 设置生成 API Token，确保数据的安全传输。
• WebSocket 与 Polling：根据 Unifi Access 版本，项目可以选择使用 WebSocket 或 Polling 方式来获取数据更新，WebSocket 支持即时更新和更多特性。
• 事件处理：项目支持门铃按下和门禁访问事件，这些事件可以在 Home Assistant 事件总线中被捕获和处理。

项目及技术应用场景

hass-unifi-access 的集成可以在多种场景中提供便利，以下是几个典型的应用场景：

1. 智能家居控制：用户可以通过 Home Assistant 控制和监控家中的门禁系统，实现远程开锁和门状态监控。
2. 办公环境管理：在办公室中，管理员可以使用 Home Assistant 来管理员工的门禁权限，确保安全性和便捷性。
3. 事件驱动的自动化：例如，当门铃被按下时，自动向用户发送通知，或者在特定时间段自动锁定所有门。

项目特点

hass-unifi-access 项目具有以下显著特点：

• 广泛的硬件支持：支持多种 Unifi Access 硬件设备，包括 Unifi Access Hub、Unifi Access Hub Enterprise 等。
• 灵活的配置选项：用户可以根据自己的需求选择验证 SSL 证书、使用 WebSocket 或 Polling 等配置。
• 事件驱动的交互：通过支持门铃按下和访问事件，项目可以与 Home Assistant 中的自动化系统无缝集成。
• 安全性：通过 API Token 进行认证，确保了数据的安全性和隐私保护。

安装与使用

安装 hass-unifi-access 非常简单，用户可以通过 HACS（Home Assistant Community Store）添加项目仓库并安装集成，或者手动克隆项目到 Home Assistant 的 custom_components 文件夹中。安装后，用户需要提供 Unifi Access 控制器的 IP 或主机名以及 API Token，即可完成配置。

示例自动化

以下是一个简单的自动化示例，当检测到入口处的运动时，自动解锁前门：

alias: Unlock Front Gate when motion is detected in Entryway
description: ""
trigger:
  - platform: state
    entity_id:
      - binary_sensor.entryway_motion_detected
condition: []
action:
  - service: lock.unlock
    data: {}
    target:
      device_id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
mode: single

通过上述分析，可以看出 hass-unifi-access 是一个功能强大且易于使用的项目，能够为 Home Assistant 用户带来极大的便利。如果你正在使用 Unifi Access 门禁系统，并且希望将其与 Home Assistant 集成，那么 hass-unifi-access 将是你的不二选择。

hass-unifi-access Unifi Access Integration for Home Assistant 项目地址: https://gitcode.com/gh_mirrors/ha/hass-unifi-access