mediocre-hass-media-player-cards 的安装和配置教程

项目基础介绍

mediocre-hass-media-player-cards 是一个开源项目，用于在 Home Assistant 中创建自定义的媒体播放器卡片。这些卡片提供了丰富的配置选项，允许用户对媒体播放器进行分组、添加自定义操作按钮、搜索音乐等。该项目使用的主要编程语言是 TypeScript，它被包裹在 Web 组件中，以便与 Home Assistant 的 Lovelace 用户界面集成。

项目使用的关键技术和框架

该项目使用了以下关键技术栈和框架：

• TypeScript：一种由微软开发的开源编程语言，它是 JavaScript 的一个超集，为代码提供了静态类型检查。
• Preact：一个轻量级的、与 React 兼容的 JavaScript 库，用于构建用户界面。
• Web Components：一套不同的技术，允许开发者创建可重用的自定义元素，它们遵循标准化的 APIs，可以在现代浏览器中使用。

项目安装和配置的准备工作

在开始安装和配置 mediocre-hass-media-player-cards 之前，请确保您已经满足以下条件：

• 您的系统中已经安装了 Node.js。
• 您有一个运行中的 Home Assistant 实例。
• 您熟悉 Home Assistant 的 Lovelace 用户界面和配置。

安装步骤

第一步：克隆项目仓库

打开命令行界面，使用以下命令克隆项目仓库到本地：

git clone https://github.com/antontanderup/mediocre-hass-media-player-cards.git

第二步：安装依赖

进入项目目录，安装项目所需的依赖：

cd mediocre-hass-media-player-cards
yarn install

第三步：构建项目

安装完依赖后，构建项目以便在开发环境中使用：

yarn dev

第四步：集成到 Home Assistant

在 Home Assistant 中集成自定义卡片，您需要执行以下步骤：

1. 打开 Home Assistant 实例。
2. 进入 HACS（Home Assistant Community Store）。
3. 点击右上角的三点菜单，选择“自定义仓库”。
4. 点击“添加”，输入仓库 URL https://github.com/antontanderup/mediocre-hass-media-player-cards，并设置分类为“Dashboard”。
5. 搜索“Mediocre Hass Media Player Cards”，找到后点击安装并重新加载浏览器。

第五步：配置卡片

在 Home Assistant 的 Lovelace 配置文件中添加自定义卡片。以下是一个配置示例：

- type: 'custom:mediocre-media-player-card'
  entity_id: media_player.living_room_speaker
  tap_opens_popup: true
  speaker_group:
    entities:
      - media_player.kitchen_speaker
      - media_player.bedroom_speaker

根据您的需求，您可能还需要配置其他选项，例如自定义按钮和音乐助手集成。

完成以上步骤后，您应该能够在 Home Assistant 的 Lovelace 界面中看到并使用自定义的媒体播放器卡片。