企业官网建设流程全解析

ZyFun 影视直播播放器：5 个核心功能与配置指南

【免费下载链接】zyfun跨平台桌面端视频资源播放器,免费高颜值.项目地址: https://gitcode.com/gh_mirrors/zy/zyfun

ZyFun 是一款免费开源的跨平台桌面端视频资源播放器，统一管理影视站点、IPTV 直播源与观影历史。它通过多源适配器机制，解决了传统播放器无法同时处理多种站点格式、直播源与云端同步的问题，并支持多核播放引擎切换。

影视资源卡片墙，支持分站点筛选与聚合搜索

它和传统方案差在哪

传统播放器只负责把文件播出来，资源管理全靠外部工具凑合。ZyFun 把站点解析、源切换、历史记录收进同一个窗口，看片时不用在多个页面间复制链接；换设备后把配置同步过去即可，无需重新整理资源。

核心功能逐项拆解

多站点影视聚合

把各类影视站 API 解析成统一的卡片列表，每个站点填一个接口地址即可浏览和搜索。

1. 在设置页影视模块点击新增站点
2. 填写名称、api接口地址，选择适配器类型
3. 启用站点，进入影视页浏览内容

站点数据采用统一的数据结构，可在数据导入页批量导入，最小结构如下：

{ "site": [ { "id": "b2c9f1a4-xxxx", "name": "演示站点", "api": "https://example.com/api.php/provide/vod/", "type": 1, "group": "切片", "isActive": true } ] }

保存后站点出现在左侧站点列表中，顶部搜索框会检索所有启用站点。其中type决定适配器，1 为最常用的 T1_JSON；id是id唯一标识，两条数据不能重复，否则导入会报错。

直播源管理与延迟检测

解析 M3U/M3U8 直播源，并可在频道卡片上实时标出每个频道的网络延迟，方便挑最流畅的线路。

1. 在直播设置页添加直播源地址，选择远程、本地或文本类型
2. 配置epg电子节目单与logo台标的模板地址
3. 打开延迟测速开关，进入直播页查看毫秒数

直播源配置支持模板变量，导入后频道列表会按分组排列：

{ "iptv": [ { "id": "fddfb425-xxxx", "name": "央视直播", "api": "https://example.com/m3u/iptv.m3u", "type": 1, "epg": "https://epg.example.org/?ch={name}&date={date}", "logo": "https://epg.example.org/logo/{name}.png" } ] }

{name}和{date}会被自动替换为频道名与日期，测速开启后每张频道卡片都会标出实测值。

直播频道卡片右上角实时显示各线路延迟毫秒数

多核播放器切换

内置 xgplayer、artplayer 两种引擎，也可把播放任务交给外部播放器，应对特殊格式。

1. 进入设置页基础设置
2. 在播放器字段选择引擎，选 custom 时填写外部播放器路径
3. 返回播放页验证效果

改这一个字段即可切换播放引擎：

{ "player": { "type": "xgplayer", "external": "" } }

type可取xgplayer、artplayer、custom，改完保存后新打开的播放窗口即使用新引擎，无需重启应用。

老板键一键隐藏

注册一个全局快捷键，按下立即隐藏播放窗口，窗口没有焦点时同样生效，隐藏后通过系统托盘恢复。

1. 在设置页用快捷键录制器录入按键组合
2. 保存后随时按下组合键，窗口立即隐藏
3. 需要时从托盘图标恢复窗口

配置示例如下，Mac 默认推荐Shift+Command+Z，Windows 建议改为Shift+Alt+Z：

{ "bossKey": "Shift+Alt+Z" }

它是全局热键，即使正在输入其他内容，按下也能瞬间隐藏播放画面。

WebDAV 跨设备数据同步

把站点配置与观影数据定期上传到 WebDAV 服务器，新设备登录同一网盘即可还原整套环境。

1. 在设置页数据栏填写 WebDAV 地址、用户名、密码
2. 打开自动同步开关
3. 新设备上拉取一次数据完成迁移

💡 同步地址必须使用 HTTPS，否则上传会直接失败。配置结构如下：

{ "cloud": { "sync": true, "type": "webdav", "data": { "url": "https://dav.jianguoyun.com/dav/", "user": "your_username", "password": "your_password" } } }

开启后每次数据变更都会触发同步，观影历史与收藏跟着设备走。

历史按天分组，每条记录保留已看进度百分比

从零搭建：最短上手路径

1. 获取源码，克隆仓库并进入目录：

git clone https://gitcode.com/gh_mirrors/zy/zyfun cd zyfun

2. 安装依赖，需要 Node.js 24 以上与 pnpm 10.27：

pnpm install

装完所有依赖后即可进入下一步，postinstall会自动处理 Electron 原生模块。

3. 修改关键配置：首次启动前可跳过，启动后在设置页添加站点；或提前准备含site、iptv字段的 JSON 文件，启动后从数据导入页导入，结构参考上文示例。

4. 启动开发环境，ZyFun 主窗口会自动弹出：

pnpm dev

主窗口出现后，按上文配置一个影视站点和一个直播源，即可完整体验影视、直播、历史三大模块。

进阶调优与参数配置

• hardwareAcceleration默认开启，播放出现花屏或卡顿时可关掉改软解再试。
• live.delay默认关闭，频道较多时建议开启，首次加载会因逐频道测速而稍慢。
• proxy.type只影响 ZyFun 的资源请求，不改动系统全局代理，排查网络问题时先切direct直连对比。

常见问题与排错

Q：macOS 安装后打开提示「文件已损坏」 原因：应用未做公证，被 Gatekeeper 拦截。 解决：终端执行sudo spctl --master-disable，再执行sudo xattr -cr /Applications/zyfun.app后重新打开。

Q：Linux AppImage 报 Running as root without --no-sandbox 原因：Chromium 内核禁止以 root 身份启用沙箱。 解决：用./zyfun.AppImage --no-sandbox启动；若同时报 libfuse 缺失，先执行sudo apt-get install libfuse2。

Q：影视站点添加后列表一直空白 原因：适配器类型type与站点 API 不匹配，或接口本身已失效。 解决：先用浏览器打开api地址确认能返回数据，再把type改回 1（T1_JSON）重试。

Q：直播频道不显示延迟数值 原因：live.delay开关未打开。 解决：在直播设置页开启延迟测速，频道列表会重新测速并标出毫秒值。

Q：新设备拉不到云端数据 原因：cloud.sync未开启，或 WebDAV 地址不是 HTTPS。 解决：检查cloud段各字段，把地址换成 HTTPS 后保存，再触发一次同步。

写在最后

ZyFun 把影视站点解析、直播源管理与观影历史收进同一个本地播放器，多核引擎与云同步作为加分项。适合需要同时管理多种视频源、并希望数据在设备间迁移的观看者。clone 下来跑一遍，比看十篇教程都管用。

【免费下载链接】zyfun跨平台桌面端视频资源播放器,免费高颜值.项目地址: https://gitcode.com/gh_mirrors/zy/zyfun