开始使用

从安装到第一次跑起来

1. 环境要求

交互能力说明：Windows/Linux 桌面端为全屏无边框窗口；Android 端以全屏应用方式运行，系统关机/重启能力不可用（接口会返回 ignored）。

2. 获取安装包

• 会员区下载：FoxPlayer-Setup-8.0.0.exe（文件名以实际发布为准，版本号与「当前版本」字段一致）
• 或联系我方获取部署包
• 安装包校验：下载后先确认文件大小与发布记录一致，再拷到目标终端

3. 安装步骤

1. 右键安装包，选择「以管理员身份运行」。
2. 阅读并同意用户协议。
3. 选择安装路径，默认 C:\Program Files\FoxPlayer（或发布包约定的目录）。
4. 等待安装完成。安装过程会释放程序与内置 Web 资源，并创建开始菜单/桌面快捷方式。
5. 首次启动时若系统弹出防火墙提示，请勾选「专用网络」并允许，否则局域网内其它电脑无法访问 58000。

截图位：安装向导欢迎页 → 安装路径页 → 完成页（见 03-截图/）。

4. 首次启动

1. 双击桌面图标启动。程序会申请单实例锁：已经在运行时再次启动会直接退出，不会开出第二个窗口。
2. 窗口以全屏、无边框方式打开，鼠标自动隐藏。
3. 首次启动会在数据目录创建数据库、media/ 素材目录与日志文件： - Windows 通常为 %APPDATA%\com.foxplayer\foxplayer - 实际路径可在后台「系统设置 → 播放器设置 → 媒体目录」查看，该路径的上一级就是数据目录
4. 授权检查：未授权时屏幕只显示授权页，不进入播放。授权页会显示本机机器码，复制后交给供应方换取授权码，粘贴激活即可。授权状态每 60 秒自动复查。
5. 授权通过后，若节目单为空，屏幕显示「暂无节目，请打开管理后台添加」的提示。

首次登录后台的默认账号是 admin / admin123。登录后第一件事是改密码（后台右上角管理员名字 → 修改密码），改密会使所有旧登录立即失效。

5. 五分钟跑通

以下步骤都在同一台终端上完成，不需要第二台电脑。

第 1 分钟：打开后台 浏览器访问 http://127.0.0.1:58000，用 admin / admin123 登录。登录成功后进入「仪表盘」。

第 2 分钟：改密码 点击后台右上角的管理员名字 → 选择「修改密码」，输入原密码、新密码并确认。保存后当前登录会失效，用新密码重新登录。

第 3 分钟：上传素材 进入「节目单管理」→ 素材区，点击上传，选择 1 个视频和 1 张图片。上传成功后会自动出现缩略图、时长与大小。 - 支持格式：mp4 / mkv / avi / mov / mp3 / jpg / jpeg / png / webp / gif / bmp - 单文件默认上限 5120 MB；超限会被拒绝 - 文件以 MD5 命名落盘，重复上传同一文件不会产生两份

第 4 分钟：排节目单 把素材加入节目单，拖拽调整顺序；把第一个视频设为「默认起始项」；图片可单独设置停留秒数；播放模式选「列表循环」。保存后节目单立即生效，不需要重启。

第 5 分钟：确认播放 回到大屏画面，应自动开始播放节目单第一项。用以下任一方式验证控制通道：

# 查询状态（公开接口，无需登录）
Invoke-RestMethod http://127.0.0.1:58000/api/pub/status

# 切换到节目单第 1 项
Invoke-RestMethod -Method Post -Uri http://127.0.0.1:58000/api/pub/control `
  -ContentType 'application/json' `
  -Body '{"cmd":"setplay","params":{"file":"#1"}}'

# 暂停
Invoke-RestMethod -Method Post -Uri http://127.0.0.1:58000/api/pub/control `
  -ContentType 'application/json' -Body '{"cmd":"pause"}'

看到状态里的 state 在 playing / paused 之间变化，即说明播放与接口都已跑通。

6. 常见失败与处理

排障入口：数据目录 logs/foxplayer.log（超 5 MB 轮转为 foxplayer.log.1）；Web 后台「操作日志」页；GET /api/player/status。

分享