Switchfin 项目常见问题解决方案

项目基础介绍

Switchfin 是一个为 Nintendo Switch 开发的第三方原生 Jellyfin 客户端。它提供了一个原生的用户界面，用于浏览和播放电影和剧集。该项目目前处于早期阶段，因此可能会遇到一些 bug。Switchfin 主要使用 C++ 编程语言进行开发，并依赖于一些第三方库如 MPV Player 来实现媒体播放功能。

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

1. 字幕无法显示

问题描述: 在使用 Switchfin 播放视频时，字幕无法正常显示。

解决方案:

1. 确保字幕文件与视频文件在同一目录下，并且文件名相同。
2. 将任意 .ttf 字体文件放置在 /switch/Switchfin/subfont.ttf 路径下。
3. 重新启动 Switchfin，检查字幕是否正常显示。

2. 无法播放 WebDAV 服务器上的媒体文件

问题描述: 尝试播放存储在 WebDAV 服务器上的媒体文件时，无法正常播放。

解决方案:

1. 编辑配置文件 config.json，添加 WebDAV 服务器的配置信息。
2. 配置示例：

   {
     "remotes": [
       {
         "name": "local",
         "url": "file:///switch"
       },
       {
         "name": "xiaoya",
         "passwd": "guest_Api789",
         "url": "webdav://192.168.1.5:5678/dav",
         "user": "guest"
       }
     ]
   }
   

3. 保存配置文件后，重新启动 Switchfin，尝试播放 WebDAV 服务器上的媒体文件。

3. 构建项目时遇到编译错误

问题描述: 在尝试为 Nintendo Switch 构建 Switchfin 项目时，遇到编译错误。

解决方案:

1. 确保已正确设置 Nintendo Switch 的开发环境，参考 Getting Started guide。
2. 安装必要的开发包：

   sudo dkp-pacman -S switch-dev switch-glfw switch-libwebp switch-curl
   

3. 使用以下命令进行构建：

   cmake -B build_switch -DPLATFORM_SWITCH=ON -DBUILTIN_NSP=ON
   make -C build_switch Switchfin.nro -j$(nproc)
   

4. 如果需要调试，可以使用 nxlink 工具：

   nxlink -a <YOUR IP> -p Switchfin/Switchfin.nro -s
   

通过以上步骤，新手用户可以更好地理解和使用 Switchfin 项目，解决常见的问题。