家庭自动化助手——Mediocre Media Player Cards 开源项目教程-优快云博客

家庭自动化助手——Mediocre Media Player Cards 开源项目教程

mediocre-hass-media-player-cards Media Player Cards for Homeassistant. 项目地址: https://gitcode.com/gh_mirrors/me/mediocre-hass-media-player-cards

1. 项目介绍

Mediocre Media Player Cards 是一个为 Home Assistant 定制的开源项目，提供了一系列媒体播放器卡片，用户可以自定义卡片以实现分组播放器（包括音量管理）、添加自定义操作按钮以及音乐搜索等功能。该项目基于 Preact 并且使用 Web 组件进行构建，旨在为 Home Assistant 用户带来更加丰富和直观的媒体控制体验。

2. 项目快速启动

以下是快速启动 Mediocre Media Player Cards 的步骤：

环境准备

确保您的系统已经安装了 Node.js 和 Yarn。

克隆项目

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

安装依赖

yarn install

开发环境构建

yarn dev

构建完成后，项目将在本地开发服务器上运行。

生产环境构建

当开发完成后，构建生产环境的代码：

yarn build

构建的生产文件将位于 dist 目录中。

3. 应用案例和最佳实践

Home Assistant 集成

打开 Home Assistant 实例中的 HACS。
点击右上角的三点菜单。
选择 "Custom repositories"。
添加 antontanderup/mediocre-hass-media-player-cards 作为仓库。
设置分类为 "Dashboard"。
点击 "Add"。
搜索 "Mediocre Hass Media Player Cards" 并安装，然后重新加载浏览器。

配置卡片

以下是一个自定义卡片的基本配置示例：

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"

自定义按钮

在卡片中添加自定义按钮可以提供额外的操作，例如：

custom_buttons:
  - icon: "mdi:playlist-music"
    name: "Playlists"
    tap_action:
      action: "navigate"
      navigation_path: "/media-player/playlists"
  - icon: "mdi:equalizer"
    name: "Equalizer"
    tap_action:
      action: "perform-action"
      perform_action: "media_player.open_equalizer"
      target:
        entity_id: "media_player.living_room_speaker"