Mini Media Player 项目教程

Mini Media Player 项目教程

mini-media-playerMinimalistic media card for Home Assistant Lovelace UI项目地址:https://gitcode.com/gh_mirrors/mi/mini-media-player

1. 项目介绍

Mini Media Player 是一个为 Home Assistant Lovelace UI 设计的极简且高度可定制的媒体播放器卡片。该项目的目标是提供一个简洁的用户界面，使用户能够轻松控制和管理媒体播放器实体。Mini Media Player 的设计灵感来自于 Custom UI: Mini media player 和 custom-lovelace。

2. 项目快速启动

安装

通过 HACS 安装

1. 确保你已经安装了 HACS（Home Assistant Community Store）。
2. 打开 Home Assistant，进入 HACS 界面。
3. 进入 "Frontend" 部分。
4. 点击右上角的 "+" 按钮。
5. 搜索 "Mini Media Player" 并安装。

手动安装

1. 从 最新发布版本 下载 mini-media-player-bundle.js。
2. 将文件复制到你的 Home Assistant 配置目录下的 config/www 文件夹中。
3. 在 Home Assistant 的 Lovelace UI 中添加资源：
   • 进入 "Sidebar -> Settings -> Dashboards -> Menu (右上角) -> Resources"。
   • 点击 "+ ADD RESOURCE"。
   • 在 URL 中输入 /local/mini-media-player-bundle.js?v=1.16.9。
   • 选择 "JavaScript Module" 作为资源类型。

配置

在 ui-lovelace.yaml 中添加以下配置：

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

views:
  - title: Home
    cards:
      - type: custom:mini-media-player
        entity: media_player.kitchen_speakers

开发环境设置

如果你计划为该项目贡献代码，可以按照以下步骤设置开发环境：

1. 克隆项目到你的 config/www 目录：

   git clone https://github.com/kalkih/mini-media-player.git
   

2. 进入项目目录并切换到 dev 分支：

   cd mini-media-player
   git checkout dev
   

3. 安装依赖：

   npm install
   

4. 构建项目：

   npm run build
   

5. 在 ui-lovelace.yaml 中添加资源引用：

   resources:
     - url: /local/mini-media-player/dist/mini-media-player-bundle.js
       type: module
   

3. 应用案例和最佳实践

基本卡片配置

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

紧凑型卡片配置

type: custom:mini-media-player
entity: media_player.example
hide:
  volume: true
  controls: true

自定义样式

type: custom:mini-media-player
entity: media_player.example
artwork: cover
accent_color: white
media_cover_info_color: white
background_opacity: 0.8
artwork_opacity: 0.9
progress_height: 8px
scale: 1.2
name_font_weight: 500

4. 典型生态项目

Home Assistant

Mini Media Player 是 Home Assistant 生态系统中的一个重要组件，它与 Home Assistant 的其他媒体播放器实体无缝集成，提供了丰富的定制选项和简洁的用户界面。

HACS

HACS（Home Assistant Community Store）是 Home Assistant 的一个扩展商店，用户可以通过 HACS 方便地安装和管理 Mini Media Player 等自定义卡片。

Custom UI: Mini media player

该项目的设计灵感来自于 Custom UI: Mini media player，它为 Home Assistant 提供了更多的自定义 UI 选项。

custom-lovelace

custom-lovelace 是另一个为 Home Assistant Lovelace UI 提供自定义卡片的项目，它与 Mini Media Player 一起为用户提供了丰富的 UI 定制选项。

---

通过以上步骤，你可以快速启动并使用 Mini Media Player，同时了解其应用案例和最佳实践。希望这个教程对你有所帮助！

mini-media-playerMinimalistic media card for Home Assistant Lovelace UI项目地址:https://gitcode.com/gh_mirrors/mi/mini-media-player