NipaPlay电脑版

NipaPlay电脑版是一款现代化的跨平台视频播放器，专为极致影音体验而生，致力于为用户提供流畅、美观且功能丰富的观影体验。其支持本地视频播放、弹幕显示、多格式字幕、多轨道音视频，并可无缝整合 Emby 和 Jellyfin 媒体服务器。无论你是想要播放本地收藏，还是连接家庭媒体中心，NipaPlay 都能满足你的需求。NipaPlay的目标是打造一个开源、社区驱动的播放器，让每个人都能享受到最好的观影乐趣。

软件特色

1、强大的媒体中心

自动削刮影片信息，生成精美的海报墙。无论是电影、剧集还是动漫，所有收藏都一目了然，为您打造私人影视库。

2、沉浸式播放体验

简洁而强大的播放界面，支持多种视频格式和高级功能。调整字幕、切换音轨、逐帧预览，一切尽在掌握。

3、在线流媒体支持

无缝整合在线流媒体资源，无论是热门新番还是经典剧集，都能快速访问和播放，享受即点即播的快感。

4、全平台响应式设计

NipaPlay 不仅在桌面端表现出色，同样完美适配移动设备。随时随地，享受一致的优质体验。

NipaPlay电脑版怎么连接远程媒体库

1、进入NipaPlay视频播放器，点击【设置】。

2、点击【远程媒体库】。

3、选择需要连接的媒体库。

4、输入服务器地址、用户名以及密码进行连接。

注：如使用 HTTPS，确保地址以 https:// 开头。

常见问题

启动后黑屏/无声/卡顿?

可先尝试切换内核、更新驱动、启用硬解。

用哪个播放器内核最好？

推荐使用 Libmpv。

在哪里可以找到动漫资源？

NipaPlay 是本地播放器，不提供任何资源。

如何部署自己的媒体服务器？

推荐使用 Jellyfin 或 Emby。

无法连接、403 Forbidden、或认证失败?

403 多由服务器端限制导致，需联系管理员放行客户端。

媒体库类型支持吗？

仅支持"电影/剧集"库类型。

初次选择媒体库很慢?

大库初次加载耗时较长，完成后会缓存。

选择了媒体库但没有生效?

选择媒体库后必须滑动到页面底部点击"保存"按钮，否则设置不会生效。

NipaPlay 局域网共享无法连接

确保两台设备在同一局域网内；检查防火墙设置；确认目标设备已开启远程访问功能。

弹幕匹配错误怎么办？

可在播放界面手动匹配弹幕。

如何登录弹弹play账号？

在设置→账号→弹弹play账户中输入用户名和密码登录；支持观看同步、评分和发送弹幕功能。

什么观看记录没有同步？

检查网络连接；确认账号登录状态；查看设置中是否开启了自动同步功能。

如何在Bangumi上写短评？

在动画详情页面点击评分按钮，在弹出的对话框中可以编写短评；短评会同步到Bangumi收藏中。

更新日志

v1.11.10版本

一、新功能

1、截图格式可选无损 PNG

手动截图现在可以在设置中选择 JPEG 或无损 PNG。JPEG 保留原有的 70/85/92/100 质量档，切到 PNG 后隐藏无意义的质量选项。原有配置继续默认 JPEG，格式选择会持久保存并同步到实际编码、文件扩展名和 Android 相册导出的 MIME 类型。截图开始时固定所选格式，避免异步过程中改设置导致文件内容与扩展名不一致。

2、弹幕轨道独立调轴

每条弹幕轨道现在可以单独设置小数秒偏移并随时重置，正数提前、负数延后，与原整体偏移叠加生效。合并显示、导出和新发送的弹幕统一使用调整后的时间，原始弹幕保持不变，反复编辑不会累积。两套主题都提供轨道调轴入口，弹窗跨切集时不会改写新轨道。偏移仅对当前播放中的轨道有效，界面已说明这一生命周期。

3、WebDAV / SMB 支持同时配置内网与公网地址

连接配置现在可以同时填写内网和公网地址。应用启动阶段在后台检测媒体库可用性，自动切换到合适线路（内网优先）。配置已接入备份和同步系统，升级后原地址会自动无感迁移到新字段。顺带把内嵌的预设正则屏蔽插件升级到与商店版本一致。

4、Linux 支持构建 Flatpak 安装包 (#1026)

新增符合 Flathub 规范的 Flatpak 构建清单、桌面文件、AppStream 元数据与多尺寸图标，支持 x86_64 与 aarch64 双架构，并把打包接入 Linux 构建发布流水线。清单已适配本版新增的 Erika 原生运行库、游戏手柄与 mimalloc 动态库依赖。

二、体验改进

1、综合性能优化 (#1004)

对 UI 动画、启动流程、后台服务和操作细节做了一轮系统性优化。界面侧收窄了状态订阅与通知范围，日志列表、弹层标题、GIF 预览等控件改为局部刷新；启动阶段延后非首帧必需的服务，去掉默认启动的媒体权限请求与固定等待，SMB 改为按需初始化。列表与图片侧加入在途请求共享、解码尺寸限制与及时释放，Jellyfin/Emby 大列表改为分批请求和逐页解析，弹幕缓存、字幕索引和番剧详情都改为按需加载并做有界缓存。隐藏标签页与后台页面会停止轮播、下载和媒体库轮询，播放缩略图的解码、缩放与编码移到后台 isolate。

2、播放器控制栏提示气泡不再与弹层重叠

画面比例、播放器菜单和播放列表按钮的悬浮提示气泡会浮在按钮上方 20px，弹层也从按钮上方展开，于是出现两个气泡叠在一起（Windows 桌面最明显），气泡还会挡住下面菜单项的点击。现在任一播放器弹层打开时提示气泡自动隐藏，并整体忽略鼠标事件，不再拦截输入。同时把画面比例按钮的提示精简为功能名，避免长文案在 12px 下折行。

3、Bangumi 访问令牌页面可直接打开 (#1007)

个人中心 → Bangumi 的按钮恢复为在外部浏览器打开官方访问令牌页面，按钮文案改为「前往 Bangumi 创建访问令牌」。打开失败时（例如 Web 端）回退到说明弹窗并展示纯文本链接。

4、Steam 状态同步与插件外挂程序优化

优化插件对外挂程序的启动方式与运行环境变量传递，关闭软件时自动清理相关进程；窗口改为最小化启动，避免放在后台时无法操作也看不到报错。

三、问题修复

1、Android TV 大屏遥控焦点、文件夹封面与返回键

修复 Android TV 大屏模式的三个问题：从 Jellyfin/Emby 媒体库进入详情页后焦点丢失、无法用遥控器选择剧集；网络媒体库文件夹即使有服务端封面也只显示文件夹图标；播放时按系统返回键可能直接退出应用，而返回与菜单共用逻辑还会出现未开菜单却打开菜单的情况。现在详情页在内容加载后把焦点落到第一集或播放按钮，封面在 URL 有效时统一显示服务端图片，返回键与菜单键各自独立：面板打开时返回只关闭面板，没有面板时返回结束播放回到媒体库。

2、大屏模式详情焦点、WebDAV 播放与封面加载卡顿

从 Jellyfin/Emby 剧集进入大屏详情页时没有初始焦点，第一次按方向键会跳到右上角关闭按钮；共享库中未匹配剧集 ID 的 WebDAV/SMB 文件在大屏详情页无法播放，点开只提示视频文件不存在；海报墙会在加载到一半时停住。前两项分别通过给详情页设置初始焦点目标、把剧集轨道改为按条目建模修复；第三项给通用图片下载加了 20 秒超时与 6 路并发上限，并按网格实际请求尺寸限制封面解码分辨率，避免低配电视盒子被大量并发连接和内存回收拖住。

3、WebDAV 旧连接 ID 导致媒体库条目无法播放 (#989)

旧版本连接没有持久化 ID，媒体库条目里写的是按 URL 和用户名派生的稳定 ID；连接删除重建后新连接拿到随机 ID，旧条目就找不到连接，播放报「无法解析远程媒体路径」，而 WebDAV 浏览页却正常。现在 ID 派生规则统一收敛到一处，查找未命中时按同一规则对现有连接重算并重绑，播放、字幕和下一话等所有入口同时受益，无需迁移存库数据，URL 和用户名都对不上时不会误绑。

3、Emby UHD 媒体库逐库接口兼容

部分 Emby 兼容服务能通过 Views 列出媒体库，但不支持全局 Items 或库详情接口，导致逐库的最新、排序和随机列表为空。现在复用已加载的 Views 库类型，改用用户范围的 Items 接口查询逐库内容。关联：#570

4、Windows 方向键误触窗口控制按钮

标题栏的最小化、最大化和关闭按钮此前参与键盘焦点遍历，播放中按方向键会把焦点移到关闭按钮，再按空格或回车就直接关窗。现在按钮区排除 Flutter 焦点，鼠标点击、悬停和按钮反馈不变。关联：#981

5、Linux 纹理插件随机崩溃

Linux 播放视频时进程会随机 SIGSEGV（约三次里两次），1.11.9 官方 deb 和源码构建都能复现，有时表现为持续刷 FL_IS_PLUGIN_REGISTRAR 断言失败。修复在插件注册阶段就捕获 FlView 引用，不再使用已失效的注册器。

6、macOS DFM+ 弹幕卡死整个应用

使用 DFM+ 弹幕引擎（新安装的默认设置）播放弹幕密集的视频时，主线程同步等待渲染线程生成 MSDF 字形，字形多时主线程长时间阻塞，表现为转圈、画面停在第一帧、声音继续但界面无响应。现在 next2_engine_set_frame 改到弹幕引擎既有的串行队列执行，保持与初始化、缩放和销毁的先后顺序，结果再回到主线程。实测 642 次连续操作全部及时返回，最慢 78ms，修复前一次暂停请求要 65 秒才超时。

7、macOS 窗口化启动在多视图下异常

开启「窗口化启动」且存在多个 Flutter 视图时，启动阶段获取屏幕信息会因为 Iterable.single 抛异常。现在明确选择要定位的窗口与屏幕，其余启动设置行为不变。

8、弹弹play 登录失效后无法续期

服务器作废保存的登录后，客户端只看响应头、收到 401 也不清状态，界面一直显示已登录并提示「请检查网络连接」。现在网关对当前凭据回 401 时立即续期一次，成功就带新凭据重发这一次请求；续期被明确拒绝（401/403）才判定失效并清除登录、提示「弹弹play登录已失效，请重新登录」并带「去登录」跳转，网络或服务器故障保持原状。同时到达的多次拒绝只续期一次，错误文案优先使用服务器给出的原因。

9、播放中切换内核闪退

从 MDK 切到 libmpv 等热切换时可能直接闪退：fvp 在另一个 isolate 里删除原生 MDK 播放器，主 isolate 的界面重建仍在读取旧播放器的媒体信息，函数表已随播放器释放，于是访问到地址 0。现在 MdkPlayerAdapter 在释放一开始就把读取类接口按「已停止、无媒体」回答、设置类调用直接忽略，未释放的播放器行为不变，并把越界调用者写入内核切换阶段记录方便后续定位。

10、弹幕轨道调轴编辑器被菜单挡住

打开轨道调轴编辑器时，Windows 上原生弹窗可能卡住应用；只用视图内弹窗时播放器菜单的输入屏障又压在编辑器上方，第一次点击或点重置只会关掉菜单。现在先在根导航器上关闭所属菜单再以普通对话路由打开编辑器，兼容原生弹窗与普通 Overlay 两条路径，关闭时调用所菜单的关闭回调而不是面板的返回动作。

11、Jellyfin / Emby 独立视频播放列表报错 (#992)

电影和缺少季元数据的独立视频打开播放列表时，会因为强制读取空的 SeriesId/SeasonId 报错。两个主题现在共用队列加载逻辑：独立视频只显示当前项目，正常剧集继续获取同季队列，服务端失败仍显示原错误。关联：#614

1外挂文本字幕与内置字幕轨同时显示 (direct commit)

加载 SRT/VTT 这类应用渲染的外挂字幕后，现在会同时关闭内核的内置字幕轨；在菜单或遥控器上重新选择内置轨或关闭字幕时，也会先卸载外挂字幕，避免两路字幕叠在一起。内核渲染的 ASS 行为不变。