PlexMeetsHomeAssistant 项目启动与配置教程

1. 项目目录结构及介绍

PlexMeetsHomeAssistant 项目是一个集成 Plex 到 Home Assistant 的自定义卡片项目。项目目录结构如下：

.
├── .github/              # GitHub 相关的模板和配置文件
├── .vscode/              # VSCode 编辑器配置
├── dist/                 # 打包后的文件
├── images/               # 项目图片资源
├── src/                  # 源代码目录
│   └── ...
├── DETAILED_CONFIGURATION.md # 详细配置说明
├── LICENSE               # 项目许可证文件
├── README.md             # 项目说明文件
├── hacs.json             # HACS（Home Assistant Community Store）配置文件
├── package-lock.json     # npm 依赖包锁定文件
├── package.json          # npm 依赖包配置文件
├── rollup.config.js      # Rollup 打包配置文件
├── tsconfig.json         # TypeScript 配置文件

• .github/ 目录包含了 Issue 模板等 GitHub 相关配置。
• .vscode/ 目录包含了 VSCode 编辑器配置。
• dist/ 目录是项目打包后的文件存放处。
• images/ 目录包含了项目相关的图片资源。
• src/ 目录包含了项目的所有源代码。
• DETAILED_CONFIGURATION.md 文件详细介绍了项目的所有配置选项。
• LICENSE 文件是项目的许可协议。
• README.md 文件是项目的介绍和说明。
• hacs.json 文件是用于 HACS 的配置文件。
• package-lock.json 和 package.json 文件是用于管理项目依赖包的。
• rollup.config.js 文件是 Rollup 打包工具的配置文件。
• tsconfig.json 文件是 TypeScript 编译器的配置文件。

2. 项目的启动文件介绍

项目的启动主要是通过 Home Assistant 的 HACS 插件进行。用户需要通过 HACS 安装 PlexMeetsHomeAssistant，然后在 Home Assistant 的 Lovelace UI 编辑模式下添加自定义卡片。

具体的启动步骤如下：

1. 在 Home Assistant 中启用 HACS。
2. 通过 HACS 搜索并安装 Plex Meets Home Assistant。
3. 重载浏览器并清除缓存。
4. 在 Lovelace 编辑模式中添加一个新的卡片，并选择 "Custom: Plex Meets Home Assistant"。

项目启动后，用户可以通过 Home Assistant 的前端界面配置和使用 PlexMeetsHomeAssistant。

3. 项目的配置文件介绍

项目的配置主要通过两个文件进行：hacs.json 和 config.json（虽然 config.json 并未在提供的目录结构中出现，但它是一个常见的配置文件名称）。

• hacs.json 文件用于定义 HACS 中显示的项目信息，包括项目名称、描述、版本等。
• config.json 文件（如果存在）将包含项目的具体配置信息，如 Plex 服务器地址、令牌、媒体播放器实体等。

用户可以通过 Home Assistant 的 UI 界面进行配置，也可以手动编辑 config.json 文件以实现更复杂的配置。

请注意，具体的配置选项和详细信息可以在项目的 DETAILED_CONFIGURATION.md 文件中找到。