如何在5分钟内上手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设计的简约且高度可定制的媒体播放器卡片。它能帮助用户在智能家居控制界面中轻松管理和控制各种媒体设备，提升家庭娱乐体验。

快速了解mini-media-player的核心优势

mini-media-player作为Home Assistant Lovelace UI的轻量级媒体卡片，具有以下特点：

• 极简设计：界面简洁直观，不占用过多屏幕空间
• 高度定制：支持多种布局和功能选项，满足个性化需求
• 易于集成：与Home Assistant生态系统无缝对接
• 功能丰富：支持媒体控制、音量调节、源切换等核心功能

两种简单的安装方法

通过HACS安装（推荐）

HACS（Home Assistant Community Store）是安装Home Assistant自定义组件的推荐方式：

1. 确保已安装HACS
2. 打开Home Assistant中的HACS
3. 进入"前端"部分
4. 点击右上角的"+"图标
5. 搜索"Mini Media Player"并安装

手动安装

如果您偏好手动安装：

1. 从最新发布版本下载mini-media-player-bundle.js文件
2. 将文件复制到Home Assistant的config/www目录
3. 编辑configuration.yaml文件，添加以下配置：

lovelace:
  resources:
    - url: /local/mini-media-player-bundle.js?v=1.16.10
      type: module

基础配置：5分钟快速上手

最简单的卡片配置

只需几行代码，即可创建一个基础的媒体播放器卡片：

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

实用配置技巧与示例

创建紧凑式媒体卡片

通过设置hide选项，可以创建更紧凑的单行使媒体卡片：

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

多房间音频控制

通过speaker_group选项，您可以轻松管理多房间音频系统：

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: Sonos Office
    - entity_id: media_player.sonos_livingroom
      name: Sonos Livingroom
    - entity_id: media_player.sonos_kitchen
      name: Sonos Kitchen

常见问题解决

卡片无法加载怎么办？

如果遇到"Custom element doesn't exist: mini-media-player"错误：

1. 确保在configuration.yaml中设置了javascript_version: latest
2. 尝试清除浏览器缓存
3. 检查资源引用是否正确，可尝试将type: module改为type: js

如何更新卡片到最新版本？

• HACS安装：在HACS中找到mini-media-player，点击更新
• 手动安装：下载最新的mini-media-player-bundle.js文件并替换旧文件，同时更新资源引用中的版本号

结语

mini-media-player为Home Assistant用户提供了一个简单而强大的媒体控制解决方案。通过本指南，您已经了解了如何快速安装、配置和自定义这款实用的媒体卡片。无论是初学者还是有经验的用户，都能在几分钟内完成设置，开始享受更智能的媒体控制体验。

现在就尝试在您的Home Assistant Lovelace界面中添加mini-media-player，提升您的智能家居控制体验吧！

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