硬件开发|Harmony Card 使用教程

Harmony Card 使用教程

harmony-card A Home Assistant Lovelace Care for Harmony Integration 项目地址: https://gitcode.com/gh_mirrors/ha/harmony-card

1. 项目介绍

Harmony Card 是一个自定义的 Home Assistant Lovelace 卡片，用于与 Harmony Hub 集成。通过 Harmony Card，用户可以在 Home Assistant 的 Lovelace UI 中轻松控制 Harmony Hub 设备。该项目基于 MIT 许可证开源，支持多种自定义配置选项，如活动管理、按钮配置、音量控制等。

2. 项目快速启动

2.1 安装

首先，确保你已经安装了 Home Assistant 和 HACS（Home Assistant Community Store）。然后，按照以下步骤安装 Harmony Card：

打开 HACS 并导航到“前端”部分。
点击“浏览并添加存储库”。
搜索“Harmony Card”并点击安装。
安装完成后，重启 Home Assistant。

2.2 配置

在 Home Assistant 的 configuration.yaml 文件中添加以下配置：


resources:
  - type: module
    url: /hacsfiles/harmony-card/harmony-card.js

然后在 Lovelace UI 中添加一个新的卡片，配置如下：


type: 'custom:harmony-card'
entity: remote.living_room_hub
volume_entity: media_player.living_room
scale: 1.25
activities:
  - name: Play Xbox One
    device: Microsoft Xbox One
  - name: Listen to Music
    device: Onkyo AV Receiver

2.3 启动

保存配置并重新加载 Lovelace UI。你现在应该能够在 Home Assistant 中看到 Harmony Card，并使用它来控制你的 Harmony Hub 设备。

3. 应用案例和最佳实践

3.1 家庭影院控制

通过 Harmony Card，用户可以轻松管理家庭影院系统。例如，你可以设置不同的活动（如“观看电影”、“听音乐”），并在 Lovelace UI 中一键切换。

3.2 多设备管理

Harmony Card 支持多个设备的集成，用户可以根据需要配置不同的设备和活动。例如，你可以为 Xbox One 和 Onkyo AV Receiver 分别设置不同的控制选项。

3.3 自定义按钮

通过配置 buttons 选项，用户可以自定义按钮的功能和外观。例如，你可以将音量控制按钮替换为自定义图标，并设置不同的颜色。

4. 典型生态项目

4.1 Home Assistant

Home Assistant 是一个开源的家庭自动化平台，支持多种设备和服务的集成。Harmony Card 是 Home Assistant 生态系统中的一个重要组件，为用户提供了更丰富的控制选项。

4.2 Harmony Hub

Harmony Hub 是 Logitech 推出的一款多功能遥控器，支持多种设备的集成。通过 Harmony Card，用户可以在 Home Assistant 中更方便地管理和控制 Harmony Hub 设备。

4.3 HACS

HACS（Home Assistant Community Store）是一个社区驱动的插件商店，用户可以在这里找到各种 Home Assistant 的扩展和自定义组件。Harmony Card 就是通过 HACS 进行安装和管理的。

通过以上步骤，你可以快速上手并充分利用 Harmony Card 的功能，提升 Home Assistant 的使用体验。