HTML5 和 Flash 游戏怎么导入 JoiPlay

HTML5 游戏——最简单的入口

HTML5 游戏本质是一个文件夹：index.html + 一堆 JS/CSS/图片资源。因为 JoiPlay 核心 APK 内置了浏览器引擎（WebView），所以不需要装任何额外插件就能跑。

操作步骤

1. 从 itch.io 或其他平台下载 HTML5 导出的游戏压缩包
2. 解压到手机存储某个目录
3. JoiPlay 内点 "+" → "Add Game"
4. 导航到解压目录，选中 index.html
5. 填名称、选图标，完成

常见问题

• 只有一个 index.html 打开一片空白：很多 HTML5 小游戏依赖外部 CDN 资源（CDN 上的 JS 库）。如果手机没有联网，JoiPlay 找不到这些资源就会白屏。解决方法是找游戏的"完整离线包"版本，或者先在 PC 上用浏览器打开一次让它把资源缓存下来（然后用 JoiPlay 导入浏览器的离线快照）。
• 画面太小或被裁切：HTML5 游戏的画布尺寸由 index.html 里的某个 zoom 或 scale 参数控制。JoiPlay 默认按 1.0 比例渲染，手机屏幕大时会显得小。可以在 JoiPlay 对该游戏的设置里调缩放，详见 HTML5 画面适配。

Flash 游戏——通过 Ruffle 运行

Flash 游戏的文件格式是 .swf。要在 JoiPlay 里运行 Flash 游戏，必须先装 Ruffle Plugin——这是一个用 Rust 重写的 Flash Player 兼容层。

操作步骤

1. 安装好 Ruffle 插件
2. 找到你想玩的 Flash 游戏的 SWF 文件（可以在 archive.org 的 Flash 归档网站上找到，或从旧游戏网站下载）
3. JoiPlay 内点 "+" → "Add Game"
4. 选中那个 .swf 文件
5. 完成添加

关于 Flash 游戏的来源

Flash 游戏在原网站上大多已经无法直接在桌面浏览器里运行，但 archive.org 等归档网站保存了大量经典 Flash 作品。下载 SWF 文件时注意：有些网站提供的是"包装"过的 HTML 页面（里面内嵌了一个 embed src="game.swf"），这种情况下你需要直接下载那个被嵌入的 .swf 文件，而不是 HTML 页面。

兼容性说明

Ruffle 项目的 ActionScript 2 兼容度很高（经典 2005~2012 年的 Flash 小游戏基本都能跑），ActionScript 3 的兼容度正在逐步完善中，但仍有不少游戏会报错。这是 Ruffle 本身的进度限制，JoiPlay 层面没有太多可调的。

TyranoBuilder 游戏

TyranoBuilder 是拖拽式视觉小说引擎，导出格式也是 HTML5（index.html + data 目录）。添加方式和纯 HTML5 游戏完全相同——JoiPlay 核心 APK 内置了 TyranoBuilder 的识别逻辑，会自动匹配运行时参数。