从安装到进阶：mini-media-player全方位使用手册，Home Assistant用户不容错过

mini-media-player是一款为Home Assistant Lovelace UI设计的极简媒体播放卡片，它以简约设计为核心，同时提供丰富的自定义选项，帮助用户打造个性化的智能家居媒体控制中心。无论是基础播放控制还是多房间音频管理，这款工具都能满足Home Assistant用户的多样化需求。## 🌟 为什么选择mini-media-player？作为Home Assista

林菁琚

414人浏览 · 2026-02-07 05:18:03

林菁琚 · 2026-02-07 05:18:03 发布

从安装到进阶：mini-media-player全方位使用手册，Home Assistant用户不容错过

【免费下载链接】mini-media-player Minimalistic media card for Home Assistant Lovelace UI 项目地址: https://gitcode.com/gh_mirrors/mi/mini-media-player

mini-media-player是一款为Home Assistant Lovelace UI设计的极简媒体播放卡片，它以简约设计为核心，同时提供丰富的自定义选项，帮助用户打造个性化的智能家居媒体控制中心。无论是基础播放控制还是多房间音频管理，这款工具都能满足Home Assistant用户的多样化需求。

🌟 为什么选择mini-media-player？

作为Home Assistant生态中备受欢迎的媒体控制组件，mini-media-player凭借以下特性脱颖而出：

极简设计：紧凑界面不占用过多仪表盘空间，同时保留核心功能
高度自定义：可按需隐藏/显示特定控件，打造专属控制界面
多平台支持：兼容Sonos、Soundtouch、Squeezebox等主流音响系统
丰富功能集：包含播放控制、音量调节、进度条、源选择、音效模式等
智能快捷方式：支持脚本、服务调用和媒体播放的一键触发
TTS支持：内置文本转语音输入功能，轻松实现语音播报

🚀 快速安装指南

HACS安装（推荐）

确保已安装HACS（Home Assistant Community Store）
打开Home Assistant中的HACS
进入"前端"部分
点击右上角"+"图标
搜索"Mini Media Player"并安装

手动安装

从最新发布页面下载mini-media-player-bundle.js
将文件复制到Home Assistant的config/www目录
配置资源：
- 进入设置 → 仪表盘 → 右上角菜单 → 资源
- 点击"+ 添加资源"
- URL输入/local/mini-media-player-bundle.js?v=1.16.9（版本号需与下载文件匹配）
- 资源类型选择"JavaScript模块"

⚙️ 基础配置与使用

简单配置示例

创建一个基础的媒体播放器卡片只需几行配置：

type: custom:mini-media-player
entity: media_player.kitchen_speakers

这将生成一个包含播放控制、音量调节和媒体信息的基础卡片。

自定义卡片外观

通过简单配置实现个性化外观：

type: custom:mini-media-player
entity: media_player.example
icon: mdi:spotify
artwork: cover
hide:
  volume: true
  source: true
  power_state: false

上述配置将创建一个紧凑模式的卡片，仅显示核心播放控制和封面艺术。

🎨 高级自定义技巧

媒体快捷方式设置

添加一键访问常用媒体内容的快捷按钮：

type: custom:mini-media-player
entity: media_player.spotify
artwork: cover
source: icon
hide:
  volume: true
shortcuts:
  columns: 4
  buttons:
    - icon: mdi:music
      type: playlist
      id: spotify:user:XXXXXXX:playlist:37i9dQZF1DZ06evO2O09Hg
    - icon: mdi:radio
      type: source
      id: Radio Station
    - icon: mdi:script
      type: script
      id: script.morning_routine

多房间音频管理

轻松控制多个扬声器组成的音响系统：

type: custom:mini-media-player
entity: media_player.sonos_office
hide:
  power: true
  icon: true
  source: true
speaker_group:
  platform: sonos
  show_group_count: true
  entities:
    - entity_id: media_player.sonos_office
      name: 书房音响
    - entity_id: media_player.sonos_livingroom
      name: 客厅音响
    - entity_id: media_player.sonos_kitchen
      name: 厨房音响

卡片布局优化

通过组合使用水平和垂直堆栈，创建更复杂的布局：

- type: horizontal-stack
  cards:
    - entity: media_player.tv_livingroom
      type: custom:mini-media-player
      info: short
      artwork: cover
    - entity: media_player.tv_bedroom
      type: custom:mini-media-player
      info: short
      artwork: cover