Switchfin 项目常见问题解决方案
项目基础介绍
Switchfin 是一个为 Nintendo Switch 开发的第三方原生 Jellyfin 客户端。它提供了一个原生的用户界面,用于浏览和播放电影和剧集。该项目目前处于早期阶段,因此可能会遇到一些 bug。Switchfin 主要使用 C++ 编程语言进行开发,并依赖于一些第三方库如 MPV Player 来实现媒体播放功能。
新手使用注意事项及解决方案
1. 字幕无法显示
问题描述: 在使用 Switchfin 播放视频时,字幕无法正常显示。
解决方案:
- 确保字幕文件与视频文件在同一目录下,并且文件名相同。
- 将任意
.ttf
字体文件放置在/switch/Switchfin/subfont.ttf
路径下。 - 重新启动 Switchfin,检查字幕是否正常显示。
2. 无法播放 WebDAV 服务器上的媒体文件
问题描述: 尝试播放存储在 WebDAV 服务器上的媒体文件时,无法正常播放。
解决方案:
- 编辑配置文件
config.json
,添加 WebDAV 服务器的配置信息。 - 配置示例:
{ "remotes": [ { "name": "local", "url": "file:///switch" }, { "name": "xiaoya", "passwd": "guest_Api789", "url": "webdav://192.168.1.5:5678/dav", "user": "guest" } ] }
- 保存配置文件后,重新启动 Switchfin,尝试播放 WebDAV 服务器上的媒体文件。
3. 构建项目时遇到编译错误
问题描述: 在尝试为 Nintendo Switch 构建 Switchfin 项目时,遇到编译错误。
解决方案:
- 确保已正确设置 Nintendo Switch 的开发环境,参考 Getting Started guide。
- 安装必要的开发包:
sudo dkp-pacman -S switch-dev switch-glfw switch-libwebp switch-curl
- 使用以下命令进行构建:
cmake -B build_switch -DPLATFORM_SWITCH=ON -DBUILTIN_NSP=ON make -C build_switch Switchfin.nro -j$(nproc)
- 如果需要调试,可以使用
nxlink
工具:nxlink -a <YOUR IP> -p Switchfin/Switchfin.nro -s
通过以上步骤,新手用户可以更好地理解和使用 Switchfin 项目,解决常见的问题。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考