Mediocre Hass Media Player Cards 项目启动与配置教程

1. 项目目录结构及介绍

Mediocre Hass Media Player Cards 是一个用于Home Assistant的媒体播放器卡片开源项目，其目录结构如下：

• .github/: 存放与GitHub操作相关的工作流文件。
• docs/: 项目文档。
• src/: 源代码目录，包含项目的核心逻辑。
• .env: 环境变量配置文件。
• .env.development.example: 开发环境下的环境变量示例文件。
• .gitignore: Git忽略文件列表。
• .prettierrc.json: Prettier代码格式化配置文件。
• .tslintignore: TSLint忽略文件列表。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• eslint.config.ts: ESLint配置文件。
• hacs.json: HACS（Home Assistant Community Store）配置文件。
• package.json: Node.js项目配置文件。
• tsconfig.json: TypeScript配置文件。
• vite.config.ts: Vite配置文件。
• yarn.lock: Yarn依赖锁定文件。

2. 项目的启动文件介绍

项目的主要启动文件为 src/ 目录下的各个TypeScript文件，这些文件包含了媒体播放器卡片的逻辑和功能。具体启动步骤如下：

1. 安装项目依赖：

   yarn install
   

2. 在开发环境下启动项目：

   yarn dev
   

3. 监听文件变化并实时编译：

   yarn dev:watch
   

启动后，项目会在本地开发服务器上运行，可通过浏览器访问相应的本地地址查看效果。

3. 项目的配置文件介绍

项目的配置主要通过以下文件进行：

• .env 和 .env.development.example: 这些文件用于定义环境变量，例如API密钥、数据库配置等。.env.development.example 作为开发环境的示例配置文件，实际使用时需要根据实际情况创建或覆盖 .env 文件。
• tsconfig.json: TypeScript配置文件，定义了项目的类型检查、模块解析等配置。
• vite.config.ts: Vite配置文件，用于配置项目的构建、开发服务器等。

对于Home Assistant的集成，配置主要通过在Home Assistant的配置文件中添加相应的卡片配置来实现。以下是一个示例配置：

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

以上配置定义了一个自定义的媒体播放器卡片，用于控制客厅的扬声器，并将其与厨房和卧室的扬声器进行分组。