Emufii免Root自动配置PPSSPP:PSP Ad Hoc联机原理与实操指南
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 记忆棒根目录
- 打开 Emufii → 设置(Settings)→ PPSSPP automatic setup(PPSSPP 自动配置);
- 点「Choose PPSSPP folder」,在文件选择器里选中包含
PSP/SYSTEM/ppsspp.ini的那个文件夹(通常是Internal storage/ROMs/psp或类似目录,路径因 ROM 库位置而异,Emufii 会验证而不是盲猜/sdcard/PPSSPP); - 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,这条路是目前最省事的方案之一。