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

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

2025-05-26 23:02:05作者:冯梦姬Eddie

项目基础介绍

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 界面中看到并使用自定义的媒体播放器卡片。

登录后查看全文
热门项目推荐