Mediocre Media Player Cards for Home Assistant - 开源项目教程

1. 项目介绍

Mediocre Media Player Cards 是一个为 Home Assistant 开发的开源项目，它提供了一系列媒体播放器卡片，可以让你在 Home Assistant 的界面中更好地控制和管理你的媒体播放设备。这些卡片不仅支持分组扬声器（包括音量管理），还支持自定义操作按钮和音乐搜索功能（当与 Music Assistant 配合使用时）。

2. 项目快速启动

环境准备

• Home Assistant 实例
• HACS (Home Assistant Community Store) 安装在 Home Assistant 中

通过 HACS 安装

1. 打开 Home Assistant 实例中的 HACS。
2. 点击右上角的三点菜单。
3. 选择“自定义仓库”。
4. 点击“添加”。
5. 添加 antontanderup/mediocre-hass-media-player-cards 作为仓库。
6. 设置分类为“Dashboard”。
7. 点击“添加”。
8. 搜索“Mediocre Hass Media Player Cards”并安装。
9. 重载浏览器。

手动安装

1. 从项目的 发布页面 获取最新版本。
2. 将 JavaScript 文件复制到你的 Home Assistant 设置中的 www/ 目录。
3. 在你的 Lovelace 配置中添加资源：

   resources:
     - url: /local/mediocre-media-player-card.js
       type: module
   

4. 刷新浏览器。

3. 应用案例和最佳实践

以下是一些如何使用 Mediocre Media Player Cards 的案例和最佳实践：

配置基本卡片

type: "custom:mediocre-media-player-card"
entity_id: media_player.living_room_speaker

配置分组扬声器和自定义按钮

type: "custom:mediocre-media-player-card"
entity_id: media_player.living_room_speaker
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

集成 Music Assistant

type: "custom:mediocre-media-player-card"
entity_id: media_player.living_room_musiccast
ma_entity_id: media_player.living_room_musicassistant

4. 典型生态项目

Mediocre Media Player Cards 是 Home Assistant 生态系统中的一部分，以下是一些与其配合使用的典型项目：

• Music Assistant: 一个 Home Assistant 的自定义组件，提供音乐搜索和播放功能。
• HACS: Home Assistant Community Store，用于轻松安装和管理自定义组件和集成。

通过结合这些项目，你可以创建一个强大的智能家居媒体控制中心。