PSP与Switch游戏上安卓：Tyranor-Next外置模拟器跳转（PPSSPP/Eden）使用指南

2026/10/30 6:16:30

【免费下载链接】Tyranor-Next

多引擎视觉小说（Galgame）聚合启动器，面向 Android 平台。内置 Kirikiri / ONScripter / Tyrano / Artemis / Siglus / FVP 六套引擎运行环境，并支持 Ren'Py、RPG Maker RGSS 外置 APK 引擎模块与 PSP / Nintendo Switch 外置模拟器跳转（PPSSPP / Eden），可识别和启动多类游戏，提供游戏库管理、封面获取、存档镜像、引擎参数调节等一体化体验。

项目地址：https://gitcode.com/gh_mirrors/ty/Tyranor-Next

点击查看免费下载

Tyranor-Next 是一款面向 Android 的多引擎视觉小说聚合启动器，除了内置 Kirikiri、ONS 等游戏引擎外，还内置了外置模拟器跳转能力：扫描 PSP 与 Nintendo Switch 的 ROM 文件并入库，点击游戏即可一键跳转到你手机上已安装的PPSSPP（PSP）或Eden（Switch）模拟器运行，无需把模拟器内置进应用。本文带你快速上手这套功能。

功能概览：Tyranor-Next 支持跳转哪些模拟器？

Tyranor-Next 采用「跳转外置模拟器」的设计思路：主应用负责识别、入库和启动分发，模拟器本体由你自行安装，存档与游戏内设置完全交给模拟器管理。

主机	对应模拟器	识别的 ROM 扩展名	备注
PSP	PPSSPP（标准版）	`.pbp.cso.iso.chd`	默认版本
PSP	PPSSPP 黄金版	同上	付费版，需自行安装后可切换
Nintendo Switch	Eden	`.nsp.xci.nca.nro`	Eden 为 yuzu 分支，只读访问 ROM
Windows 游戏	Winlator	目录型（YU-RIS / PC 游戏）	复用同一套跳转框架

两个模拟器目标都注册在统一的注册表 ExternalEmulatorRegistry.kt 中，每条记录包含包名、目标 Activity、权限契约与下载地址，是跳转行为的唯一配置源。

工作原理：从扫描到跳转的完整链路

Tyranor-Next 的外置模拟器跳转分三步完成，整个过程无需手动干预：

扫描识别：目录扫描时，按扩展名把 ROM 文件识别为 PSP 或 Switch 游戏，「一个 ROM 文件就是一条游戏」，标题取文件名（去掉扩展名）。识别逻辑见 EngineScanner.kt 中的romEngineOf判定。
启动分流：点击游戏时，启动器在解析游戏目录之前就把 PSP/Switch 游戏分流到外置模拟器链路，直接把 ROM 文件 URI 交给对应模拟器。核心实现位于 ExternalEmulatorLauncher.kt。
安装探测：跳转前先用包名探测模拟器是否已安装；未安装会给出明确提示，不会静默失败。

快速上手：四步在手机上跑起 PSP / Switch 游戏

第一步：安装外置模拟器

前往「引擎」页面，列表末尾有一个固定的**「外置跳转支持」**入口（见 EngineScreen.kt），点击会弹出 PPSSPP、Eden（以及 Winlator）的安装状态：

未安装：点击条目会直接打开对应模拟器的下载页面；
已安装：点击可直接打开模拟器主界面。

第二步：把 ROM 放进扫描目录

将.iso、.cso、.nsp等 ROM 文件放入你在「设置」中指定的游戏扫描目录（支持任意层级子目录）。Tyranor-Next 扫描时会自动把每个 ROM 识别为独立游戏条目：

PSP ROM → 引擎标记为PSP，描述「PSP 游戏通过外置 PPSSPP 运行」；
Switch ROM → 引擎标记为Nintendo Switch，描述「Switch 游戏通过外置 Eden 运行」。

💡 若某个目录本身能识别为已内置引擎的游戏，引擎识别优先，不会重复发射 ROM 条目。

第三步：点击游戏，一键跳转

直接在游戏库中点击 PSP / Switch 卡片，Tyranor-Next 会通过系统标准 Intent 把 ROM 文件「投递」给模拟器：

PPSSPP 获得读写权限（可写回存档到 ROM 目录）；
Eden 只获得只读权限。

跳转成功即视为启动成功，并自动计入「最近游戏」。

第四步（可选）：选择 PPSSPP 标准版 / 黄金版

如果你同时装了两套 PPSSPP，可以在两处切换：

全局默认：设置 → 引擎设置 →「PPSSPP 引擎设置」→「PPSSPP 版本」（标准版 / 黄金版）；
单游戏覆盖：游戏详情页的单游戏设置 PSP 卡片中单独指定，也可切回「跟随全局」。

切换逻辑在 EngineLauncher.kt 的启动分流中生效，黄金版走独立的org.ppsspp.ppssppgold包名。

常见问题排查

现象	原因与处理
提示「未安装 PPSSPP / Eden」	尚未安装对应模拟器。去「引擎 → 外置跳转支持」弹窗点击对应条目跳转下载页
「XX 未提供可接收游戏的入口」	模拟器版本过旧或异常，建议升级到最新版后重试
找不到存档管理入口	属正常设计：PSP/Switch 游戏的存档由外置模拟器管理，主应用不接管，因此游戏抽屉中不显示存档管理（见 GameScreen.kt 的展示控制）
ROM 启动后闪退 / 黑屏	多为 ROM 文件本身问题，可尝试重新扫描（SAF 授权会刷新 URI）
单游戏设置页只有一张信息卡	PSP/Switch 游戏无可调引擎参数，设置页（PerGameSettingsScreen.kt）仅展示「由外置模拟器管理」说明

所有启动失败都会给出类型化错误文案（未安装 / 无入口 / 被系统拒绝 / 启动异常），映射关系维护在 LaunchErrorMessages.kt，方便按提示定位问题。