Jellyfin Media Player 常见问题解决方案

项目基础介绍

Jellyfin Media Player 是一个基于 Jellyfin 的桌面客户端，使用 jellyfin-web 界面和嵌入式 MPV 播放器。它支持 Windows、Mac OS 和 Linux 系统，媒体播放在同一个窗口中进行，不同于 Jellyfin Desktop。该项目的主要编程语言包括 C++ 和 JavaScript，其中 C++ 用于底层播放器实现，JavaScript 用于 Web 界面。

新手使用注意事项及解决方案

1. 依赖安装问题

问题描述: 新手在构建项目时，可能会遇到依赖库未安装或版本不匹配的问题。

解决步骤:

1. 检查依赖列表: 确保所有必要的依赖库已安装。参考项目文档中的依赖列表。
2. 使用包管理器: 使用系统的包管理器（如 apt 或 brew）安装缺失的依赖。例如，在 Ubuntu 系统上，可以使用以下命令安装依赖：

   sudo apt install build-essential autoconf automake libtool libharfbuzz-dev libfreetype6-dev libfontconfig1-dev libx11-dev libxrandr-dev libvdpau-dev libva-dev mesa-common-dev libegl1-mesa-dev yasm libasound2-dev libpulse-dev libuchardet-dev zlib1g-dev libfribidi-dev git libgnutls28-dev libgl1-mesa-dev libsdl2-dev cmake wget meson nasm ninja-build python3 g++ qtwebengine5-dev qtquickcontrols2-5-dev libqt5x11extras5-dev libcec-dev qml-module-qtquick-controls qml-module-qtwebengine qml-module-qtwebchannel qtbase5-private-dev curl unzip
   

3. 手动安装缺失依赖: 如果某些依赖无法通过包管理器安装，可以手动下载并编译安装。

2. 构建过程中的错误

问题描述: 在执行构建命令时，可能会遇到编译错误或链接错误。

解决步骤:

1. 检查构建命令: 确保构建命令正确无误。参考项目文档中的构建命令示例。
2. 清理构建环境: 如果之前构建失败，尝试清理构建环境并重新开始。可以使用以下命令清理：

   rm -rf build
   

3. 查看错误日志: 仔细查看编译器输出的错误日志，根据错误信息进行修正。常见的错误包括头文件缺失、库文件路径错误等。

3. 运行时崩溃或功能异常

问题描述: 项目构建成功后，在运行时可能会遇到崩溃或某些功能无法正常使用的问题。

解决步骤:

1. 检查配置文件: 确保配置文件正确无误，特别是与媒体服务器连接的配置。
2. 更新到最新版本: 如果使用的是旧版本，尝试更新到最新版本，可能已经修复了某些已知问题。
3. 查看日志文件: 查看应用程序的日志文件，通常位于用户目录下的特定文件夹中（如 %LOCALAPPDATA%\JellyfinMediaPlayer\ 或 ~/local/share/jellyfinmediaplayer/），根据日志信息定位问题。

通过以上步骤，新手用户可以更好地解决在使用 Jellyfin Media Player 项目时遇到的问题。