Emufii免Root自动配置PPSSPP:PSP Ad Hoc联机原理与实操指南

原创2026-10-26 22:03:301,858 阅读

Emufii免Root自动配置PPSSPP:PSP Ad Hoc联机原理与实操指南

Emufii 是一款 Android 端模拟器联机工具:输入一个 6 位代码,你和朋友就进入同一个虚拟房间。针对 PSP,它能免 Root 自动配置 PPSSPP 的 Ad Hoc 联机参数——不装 fork、不用无障碍权限、不碰 PPSSPP 私有数据,一次授权即可让 PPSSPP 原版模拟器加入你的联机会话。本文讲清它背后的原理,并给出完整实操步骤。

为什么 PSP Ad Hoc 联机过去这么麻烦

PPSSPP 原版的 Ad Hoc 联机需要开启内置 Ad-hoc 服务器、填写服务器地址、关掉公网包中继等,这些设置藏得很深:

  • 在 Android 11+ 的沙盒机制下,第三方应用无法直接读写 PPSSPP 的配置目录;
  • 常见的解决办法是 Root 后改全局 ppsspp.ini,或使用修改过的 PPSSPP 版本;
  • 手动逐条改配置,还容易把昵称、MAC、图形设置弄乱。

Emufii 的思路是:不硬闯 PPSSPP 的数据目录,而是利用 PPSSPP 自带的每游戏独立配置文件机制。

Emufii 应用启动界面,用于 PSP PPSSPP 联机前自动配置

上图:Emufii 在 Android 平板上的启动画面(截图来自 pr-screenshots 目录)。

免Root自动配置的核心原理:每游戏 INI 文件

PPSSPP 支持在记忆棒根目录下为每个游戏放置一个独立配置:

PSP/SYSTEM/<DISC_ID>_ppsspp.ini

例如《恶魔城:苍月的十字架》(ULUS10277)对应 ULUS10277_ppsspp.ini。PPSSPP 在游戏启动时会自动读取这个文件——即使它正停留在主菜单上也能热加载。

Emufii 只需拿到记忆棒根目录的一次性 Storage Access Framework(SAF)授权,就会把以下 4 个联机关键项合并进该文件:

[Network]
EnableWlan = True
EnableAdhocServer = True
proAdhocServer = 10.66.1.1
AdhocServerRelayMode = 2
参数 含义
EnableWlan 启用 WLAN(PPSSPP 联机的前提开关)
EnableAdhocServer 启用内置 Ad-hoc 服务器
proAdhocServer = 10.66.1.1 一个占位地址,Emufii 的 VPN 中继会把流量 DNAT 到本会话主机
AdhocServerRelayMode = 2 PPSSPP 的 AlwaysOff 模式,关闭其公网包中继——点对点通道由 Emufii 的 VPN 自己承担

Emufii 不会碰昵称、MAC、端口偏移、UPnP、DNS、图形、按键等任何其他设置;写文件时采用逐行合并(line-preserving merge),文件里原有的注释、顺序、行尾符都会保留。

完整原理见官方文档 PPSSPP-AUTOCONFIG.md,核心实现分布在 PpssppIni.kt(INI 逐行合并/快照/恢复)与 PpssppConfigStore.kt(授权管理与备份)。

一键操作步骤:从设置到开局

第一步:在设置里指定 PPSSPP 记忆棒根目录

  1. 打开 Emufii → 设置(Settings)→ PPSSPP automatic setup(PPSSPP 自动配置);
  2. 点「Choose PPSSPP folder」,在文件选择器里选中包含 PSP/SYSTEM/ppsspp.ini 的那个文件夹(通常是 Internal storage/ROMs/psp 或类似目录,路径因 ROM 库位置而异,Emufii 会验证而不是盲猜 /sdcard/PPSSPP);
  3. Android 弹出授权时,勾选「允许访问此文件夹」。

这一步只授权一个文件夹、且仅用于读写 PPSSPP 配置。你的多主机 ROM 库授权仍然保持只读——这是有意的设计:给整个 ROM 库写权限,权限范围远大于改一个配置目录所需。

第二步:发起或加入会话

  • 房主:在库里选择 PSP 游戏并发起会话,Emufii 先把该游戏的 4 项联机配置写入对应的 <DISC_ID>_ppsspp.ini,再以它惯用的 ACTION_VIEW content:// 方式启动 PPSSPP 并载入游戏;
  • 加入者:输入房主的 6 位代码,Emufii 会自动完成同样的配置并打开游戏;
  • 进入游戏后,PPSSPP 的 Networking 设置页会显示 WLAN 已开启、服务器 10.66.1.1、包中继 No——这正是 Emufii 写入的效果(实机验证记录见 PPSSPP-AUTOCONFIG.md 的 Device proof 一节)。

启动链路实现见 PpssppLauncher.kt,其中 launchPrivateGame() 就是「先写配置、再启动游戏」的入口。

第三步:结束私密联机

用公开方式(或 PPSSPP 常规联机服务器)再启动这款游戏时,Emufii 会自动恢复你原来的 4 项设置——如果这个 per-game 文件是它新建的,还会把文件整个删掉,不留痕迹。

DISC_ID 从哪来:ISO/PBP/CHD/CSO 各需怎么做

PPSSPP 用游戏的 DISC_ID(如 ULUS10277)来命名配置文件,所以 Emufii 必须能从你的镜像里拿到它:

镜像格式 DISC_ID 来源
ISO / PBP Emufii 读取镜像内 PARAM.SFO,自动获得 PSP-<DISC_ID>
CHD / CSO 文件名里保留 4 字母 + 5 数字的 ID,例如 [ULUS10277] xxx.chd
无法识别 不猜、不阻塞启动,回退到手动配置

解析逻辑在 PpssppIni.kt 的 resolveDiscId() 中:优先取 productCode,其次从文件名和显示名里正则提取 XXXX##### 格式的 ID。

安全性设计:备份、恢复与权限边界

  • 快照备份:首次为某游戏写入私密配置前,Emufii 只记录这 4 个键的「是否存在 + 原值」,存到应用私有存储(filesDir/ppsspp-network-backups/),不动其他任何配置;
  • 恢复合并:恢复时按文件当时的状态合并,你在私密对局中改过的图形、按键设置会原样保留;
  • 换目录保护:存在未恢复的配置时,禁止更换记忆棒根目录授权——备份绝不能被应用到另一棵 PPSSPP 目录树上;
  • 写后校验:每次写入都会回读比对,不一致即报错(PPSSPP game config verification failed)。

常见问题速答

需要 Root 吗? 不需要。全程只用 Android 标准的 SAF 文件夹授权,且权限只覆盖一个配置目录。

会覆盖我的 PPSSPP 全局设置吗? 不会。Emufii 只写 per-game 的 <DISC_ID>_ppsspp.ini,全局 ppsspp.ini 原样不动(设备实测其 SHA-256 前后一致)。

切换私密/公开模式有什么要注意的? 不要在游戏还在运行时切换——PPSSPP 把 per-game 设置缓存在内存里、退出游戏时写盘,可能覆盖掉底下的文件。请先回到 PPSSPP 主菜单再切换模式,Emufii 的界面里也会明确提示这一点。

PPSSPP 需要装哪个版本? 任何近期版本(含免费版 v1.20.4 已实测通过),PpssppLauncher.kt 同时识别 org.ppsspp.ppsspp 与 org.ppsspp.ppssppgold 两个包名。

PSP 支持哪些联机模式? Ad Hoc 本地联机;具体可联机游戏清单见 COMPATIBLE-GAMES.md。PPSSPP 联机服务器(socom 等)的选择逻辑在 PspServers.kt。

小结

Emufii 对 PPSSPP 的免 Root 自动配置,本质上是一场「借力打力」:借 PPSSPP 自己的 per-game INI 热加载机制、Android 标准的 SAF 授权、以及逐行合并的温和写入,把原本需要 Root 或魔改模拟器才能做到的 Ad Hoc 联机参数配置,变成了「选一次文件夹,之后全自动」。配合会话结束时的自动恢复与写后校验,它对用户配置的侵入几乎为零。如果你想在 Android 掌机上和朋友联机打 PSP,这条路是目前最省事的方案之一。

登录后查看全文
emufii