ZY Player APP - 跨平台视频资源播放器

ZY Player APP 是一款基于 Uni-app 开发的跨平台移动端视频资源播放器，主打简洁免费，支持自定义视频源导入、播放历史自动跳转、搜索、收藏夹等实用功能，覆盖 Android 和 iOS 双平台，在 GitHub 上已获得超过 1200 颗 Star。

项目简介

ZY Player APP 是桌面端 ZY Player 的移动端衍生版本，由开发者 Hunlongyu 和 cuiocean 共同维护。项目采用 Uni-app 框架开发，实现了一套代码同时编译到 Android 和 iOS 平台的目标。作为一款跨平台移动端视频资源播放器，ZY Player APP 的核心理念是"简洁免费"，让用户在手机端也能便捷地观看各类视频资源。

与传统的视频播放器不同，ZY Player APP 采用"视频源"驱动模式，用户可以自行添加和管理视频解析源，极大地扩展了可观看内容的范围。这种设计让播放器本身保持轻量，同时通过社区维护的视频源获取丰富的内容资源。

项目采用 MIT 许可证开源，代码结构清晰，技术栈以 Vue 和 JavaScript 为主，适合前端开发者学习和二次开发。

核心特性

视频源管理

1. 自定义视频源：支持用户自行添加视频资源源，灵活配置
2. 链接导入：支持通过链接方式快速导入视频源配置，无需手动逐项填写
3. 视频源管理界面：提供专门的视频源管理页面，方便查看、编辑和删除已添加的源

播放体验

1. 播放历史记录：自动记录用户的播放历史，方便回顾
2. 历史进度跳转：打开历史视频时自动跳转到上次观看的进度位置，无需手动拖拽进度条
3. 视频详情页：提供清晰的视频详情展示页面，展示视频封面、简介等信息

内容发现

1. 搜索功能：内置搜索功能，支持在已添加的视频源中搜索感兴趣的影视内容
2. 搜索结果图片显示：搜索结果以图片卡片形式展示，直观呈现视频封面和标题信息
3. 首页推荐：首页展示各视频源的内容分类，方便快速浏览和选择

个人收藏

1. 收藏夹功能：支持将喜欢的视频添加到收藏夹，方便随时查看
2. 收藏管理：收藏页面统一管理已收藏的视频内容

安全与隐私

1. 青少年模式：支持开启青少年模式，为未成年用户提供更安全的观看环境

跨平台支持

1. Android 支持：提供 Android 安装包直接安装使用
2. iOS 支持：提供 iOS 安装包，越狱设备可直接安装，非越狱设备可通过自签方式安装
3. Uni-app 跨平台：基于 Uni-app 框架，一套代码编译多端

技术栈

ZY Player APP 的技术选型以 Uni-app 生态为核心，保持轻量和高效的开发模式：

• 开发框架：Uni-app（基于 Vue.js 的跨平台开发框架）
• 前端语言：Vue 79.3%、JavaScript 20.6%、SCSS 0.1%
• 包管理：yarn
• 许可证：MIT License

项目整体代码结构简洁，主要目录包括：

安装指南

Android 安装

1. 前往 GitHub Releases 页面下载最新版本的 Android 安装包（APK 文件）
2. 在手机上打开下载的 APK 文件
3. 根据系统提示允许安装来自未知来源的应用
4. 完成安装后即可打开使用

iOS 安装

iOS 设备有两种安装方式：

越狱设备：

1. 前往 GitHub Releases 页面下载 iOS 安装包
2. 直接安装即可使用

非越狱设备（自签方式）：

1. 前往项目提供的 iOS 自签教程页面
2. 按照教程使用 AltStore 或其他自签工具进行签名安装
3. 需要定期重新签名（通常 7 天一次）

从源码构建

如果需要从源码自行构建，需要以下准备工作：

1. 安装 Node.js 环境
2. 安装 HBuilderX IDE（推荐）或 Vue CLI
3. 克隆项目仓库
4. 安装依赖
5. 通过 HBuilderX 或 CLI 进行编译和打包

快速开始

首次使用

1. 安装并打开 ZY Player APP
2. 首次进入应用后，需要添加视频源
3. 可以通过以下方式添加视频源：
   • 手动输入视频源地址
   • 通过链接导入视频源配置
4. 添加视频源后，即可在首页浏览各分类的视频内容

观看视频

1. 在首页选择感兴趣的视频分类或内容
2. 点击视频封面进入详情页
3. 在详情页选择播放线路和集数
4. 点击播放即可开始观看
5. 退出播放后，观看进度会自动保存

搜索功能

1. 在应用内使用搜索功能
2. 输入影视名称或关键词
3. 搜索结果会以图片卡片形式展示
4. 点击感兴趣的结果即可进入详情页

收藏管理

1. 在视频详情页点击收藏按钮
2. 在收藏页面查看和管理已收藏的视频
3. 点击收藏的视频可直接进入播放

青少年模式

1. 在设置中开启青少年模式
2. 开启后，应用将过滤不适合未成年人的内容
3. 可随时在设置中关闭该模式

使用示例

视频源管理

视频源是 ZY Player APP 的核心功能，用户可以通过视频源管理页面进行以下操作：

1. 添加新视频源：输入视频源名称和地址，或通过链接一键导入
2. 编辑视频源：修改已有视频源的配置信息
3. 删除视频源：移除不再使用的视频源
4. 启用/禁用视频源：临时禁用某个视频源而不删除

播放历史

播放历史功能自动记录用户观看过的视频内容：

1. 打开"播放记录"页面
2. 查看历史观看列表
3. 点击任意历史记录，视频将自动跳转到上次观看的进度
4. 可手动清除播放历史

截图展示

ZY Player APP 提供以下主要界面：

项目链接

• GitHub 仓库：https://github.com/cuiocean/ZY-Player-APP
• 桌面端项目：https://github.com/Hunlongyu/ZY-Player
• 官方下载：https://github.com/cuiocean/ZY-Player-APP/releases
• 反馈渠道：通过 GitHub Issues 提交反馈
• 许可证：MIT License