HmNES - HarmonyOS NES模拟器

这是一个基于HarmonyOS平台开发的NES（任天堂娱乐系统）游戏模拟器，让用户可以在HarmonyOS设备上体验经典的NES游戏。

功能特点

• 🎮 NES游戏模拟：支持加载和运行NES游戏ROM文件
• 🎯 虚拟手柄：提供完整的NES控制器按钮，包括方向键、A/B键、SELECT和START
• 🎨 自定义主题：支持多种主题颜色切换，满足不同用户的视觉偏好
• 💾 游戏记忆：自动记住用户上次打开的游戏和目录
• 🔄 音频支持：完整还原NES游戏的音效和音乐
• 📱 响应式界面：适配不同屏幕尺寸的HarmonyOS设备

效果展示

技术栈

• 开发语言：TypeScript + ArkTS (HarmonyOS原生开发)
• 核心模拟器：jsnes (JavaScript NES模拟器)
• UI框架：ArkUI (HarmonyOS UI框架)
• 渲染方式：WebView + Canvas
• 存储：使用PersistentStorage和AppStorage进行数据持久化

项目结构

├── AppScope/           # 应用配置和资源
├── entry/              # 应用主模块
│   ├── src/main/ets/   # 主要源码
│   │   ├── common/     # 公共组件和常量
│   │   ├── entryability/ # 应用入口能力
│   │   ├── pages/      # 页面组件
│   │   └── utils/      # 工具类
│   └── resources/      # 资源文件
│       └── resfile/    # NES模拟器相关资源
├── doc/                # 文档和参考资料
└── hvigor/             # 构建配置

核心功能实现

1. NES模拟器核心

应用使用jsnes作为核心模拟器引擎，通过WebView加载和运行。主要文件包括：

• jsnes.js - 核心模拟器引擎
• nes-embed.js - 模拟器控制和渲染逻辑
• nes-embed.html - WebView加载的页面

2. 游戏ROM加载

支持从设备存储中选择NES ROM文件(.nes)，并通过JavaScript桥接传递给WebView中的模拟器。

3. 虚拟手柄控制

实现了完整的NES控制器界面，包括方向键和功能键，并通过JavaScript接口将按键事件传递给模拟器。

4. 主题颜色自定义

提供多种预设颜色方案，用户可以根据喜好选择模拟器背景颜色。

安装说明

1. 确保已安装HarmonyOS SDK和开发环境
2. 克隆本项目
3. 使用DevEco Studio打开项目
4. 构建并运行到HarmonyOS设备或模拟器

使用说明

1. 加载游戏：点击"加载ROM"按钮，选择设备上的NES ROM文件(.nes)
2. 控制游戏：使用屏幕上的虚拟按键控制游戏
3. 切换主题：在设置页面选择喜欢的主题颜色
4. 游戏记忆：应用会自动记住您上次玩的游戏，下次启动时可快速继续

支持的游戏格式

• 支持标准的NES ROM文件(.nes格式)
• 支持大多数常见的NES游戏ROM

已知限制

• 部分特殊Mapper的ROM可能不兼容
• 某些复杂游戏可能存在性能问题
• 目前仅支持单个游戏手柄输入

开发说明

添加新功能

如果您想为项目贡献代码，可以关注以下几个方面：

• 改进游戏兼容性
• 添加游戏存档/读档功能
• 实现多手柄支持
• 增加游戏金手指功能
• 开发横屏展示模式

构建项目

使用HarmonyOS标准构建流程：

# 构建Debug版本
hvigor build --mode debug

# 构建Release版本
hvigor build --mode release

许可证

MIT许可证

致谢

• 感谢jsnes项目提供的核心模拟器引擎
• 感谢HarmonyOS开发者社区的支持和帮助

联系我们

[534117529@qq.com]

博客

blog.csdn.net/yyz_1987

参考链接

• jsnes项目
• HarmonyOS开发者社区
• HarmonyOS NES模拟器项目实战