Skip to content

安卓 App

安装 App 后启动服务,把 App 显示的地址填进播放器。它适合局域网临时使用,不适合长期公网服务。

适合谁

  • 适合:只想装好就用、家里电视/盒子/平板和手机在同一个 Wi-Fi、没有服务器。
  • 不适合:希望公网长期稳定访问、手机经常清后台、希望服务 24 小时无人值守。
  • 访问范围:手机自己可以用本机地址;其它设备要用 App 显示的局域网地址。

准备

开始前准备好:

  1. 一台 Android 6.0 及以上手机。
  2. 能打开 GitHub Releases 下载页的浏览器。
  3. 播放器设备和手机连接同一个 Wi-Fi。

如果你的手机会严格限制后台应用,后面需要把这个 App 加入电池优化白名单。

1. 打开下载页

打开安卓 App 最新版下载页:

进入最新版本后,往下找到 Assets / 资源 区域,下载 APK 文件。

2. 选择 APK 架构

通常按这个规则选:

  • arm64-v8a:绝大多数新手机,优先选这个。
  • armeabi-v7a:老一点的 32 位 ARM 设备。
  • x86_64:少数安卓模拟器或特殊设备。

不知道自己是什么架构时,先下载 arm64-v8a。如果安装时提示不兼容,再换另一个架构。

校验文件

Release 页面通常会附带 SHA256。担心下载文件损坏或被替换时,可以对比 APK 的 SHA256 校验值。

3. 安装 APK

下载完成后,打开 APK 安装。

如果系统提示 未知来源应用

  1. 按提示进入设置。
  2. 允许当前浏览器或文件管理器安装未知来源应用。
  3. 返回重新安装 APK。

安装完成后,直接打开 App。

4. 启动服务

打开 App 后,在首页按顺序操作:

  1. 如果首页显示 启动服务,点击它。
  2. 等状态变成 服务运行中
  3. 如果首页本来就显示 服务运行中,说明已经启动,不要点 停止服务

服务运行后,App 会显示本机地址和局域网地址。

5. 复制局域网访问地址

如果播放器在同一台手机上,可以用本机地址。

如果播放器在电视、盒子、平板或另一台设备上,复制 App 首页显示的 局域网地址。它一般长这样:

text
http://手机局域网IP:9321/你的TOKEN

不要把 127.0.0.1 地址填到电视或盒子里。127.0.0.1 只代表当前这台手机,别的设备访问不到。

6. 填进播放器

打开播放器的自定义弹幕 API 设置,把刚复制的局域网地址填进去。

如果播放器需要你手动填写完整地址,格式是:

text
http://手机局域网IP:9321/你的TOKEN

填完后播放一部有弹幕的影片,能加载弹幕就说明 App 部署成功。

后续不同播放器的具体入口看:播放器接入

7. 打开系统配置

如果需要调整弹幕源、缓存、请求记录等配置,优先在 App 里找对应的配置入口。

也可以用浏览器打开系统配置地址,格式是:

text
http://手机局域网IP:9321/你的ADMIN_TOKEN

ADMIN_TOKEN 不要发给别人。它用于进入系统配置。

8. 关闭电池优化

如果服务运行一段时间后自动停掉,通常是 Android 省电策略在清后台。

建议按手机系统设置把 App 加入后台白名单:

  1. 打开手机 设置
  2. 找到 应用管理
  3. 找到这个 App。
  4. 进入 电池 / 耗电管理 / 后台管理
  5. 选择 不限制允许后台运行 或类似选项。

不同品牌手机入口名字不一样,重点是不要让系统自动杀掉这个 App。

9. 以后怎么更新 API 核心

安卓 App 的日常更新重点通常不是重新安装 APK,而是在 App 里更新 API 核心

按这个顺序做:

  1. 打开 App。
  2. 底部点 核心
  3. 进入 API 核心管理 页面。
  4. 找到你正在使用的核心版本,例如 稳定版
  5. 点对应卡片里的 检查更新
  6. 按 App 提示完成更新后,回首页确认服务仍然是运行中。

安卓 App API 核心管理页

图里底部已经选中 核心,稳定版、开发版、自定义版卡片里都有 检查更新。你用哪个核心,就检查哪个核心。

只有 App 外壳本身需要新版功能、修复安装问题,或者项目说明明确要求更新 APK 时,才需要重新下载 APK。

常见问题

安装时提示未知来源怎么办

这是正常现象。APK 不是从应用商店安装,系统会要求你手动允许一次。按提示允许当前浏览器或文件管理器安装未知来源应用,然后重新打开 APK 安装。

电视或平板访问不到手机地址

先确认:

  • 手机和播放器设备在同一个 Wi-Fi。
  • 播放器里填的是 App 显示的局域网地址,不是 127.0.0.1
  • 手机没有切到移动数据。
  • App 首页仍然显示 服务运行中
  • 路由器没有开启 AP 隔离、访客网络隔离之类的功能。

服务启动一段时间后停了

给 App 关闭电池优化,允许后台运行。部分手机还需要在最近任务界面把 App 锁定,避免一键清理时被关掉。

提示需要 Root 权限,不 Root 能用吗

可以。Root 模式是可选增强功能,普通模式下也能启动服务和提供局域网访问。

核心安装或更新失败

先检查手机网络。国内网络访问 GitHub 不稳定时,可以在 App 的网络相关设置里切换 GitHub 下载节点,或稍后重试。

想让外网访问手机上的服务

不建议把安卓 App 当作长期公网服务。外网访问涉及公网 IP、端口转发、隧道、HTTPS 和后台保活,稳定性通常不如 Docker / NAS / 云平台。

如果只是家里设备用,保持局域网访问即可。

下一步

本项目仅供个人学习与交流,请勿在国内媒体平台宣传。