nes-emu-ios 技术文档

nes-emu-ios 技术文档

安装指南

系统要求

• iOS 14.7+
• iPadOS 14.7+
• macOS 12.0 Monterey+ (Mac Catalyst)
• tvOS 14.7+

安装步骤

1. 克隆项目：

   git clone https://github.com/yourusername/nes-emu-ios.git
   

2. 打开项目： 使用 Xcode 打开项目文件 nes-emu-ios.xcodeproj。
3. 选择目标设备： 在 Xcode 中选择目标设备（iOS、iPadOS、macOS 或 tvOS）。
4. 构建项目： 点击 Build 按钮进行构建。
5. 安装应用： 构建成功后，将应用安装到目标设备上。

项目的使用说明

启动应用

1. 打开 nes-emu-ios 应用。
2. 使用 UIDocumentBrowserViewController 浏览并选择 .nes ROM 文件。
3. 选择 ROM 文件后，应用将自动加载并开始模拟 NES 游戏。

控制方式

• 触摸屏控制： 应用支持触摸屏控制，当连接游戏手柄时，触摸屏控制会自动隐藏。
• 游戏手柄控制： 支持 MFi 控制器、Sony DualSense / DualShock 4、Xbox Wireless 控制器等。连接第二个控制器时，会自动映射为玩家 2。

保存状态

• 应用支持保存状态功能，退出时会自动保存当前游戏状态。
• 下次启动游戏时，会自动加载最近保存的状态。
• 保存状态功能可以在设置中启用或禁用。

项目API使用文档

核心API

• CPU 模拟： 模拟 NES 的 6502 CPU。
• PPU 模拟： 模拟 NES 的 Picture Processing Unit (PPU)。
• APU 模拟： 模拟 NES 的 Audio Processing Unit (APU)。

映射器API

• 支持的映射器： 支持多种常见的 NES 映射器，如 NROM、MMC1、UNROM 等。
• 扩展映射器： 未来计划支持更多映射器。

音频API

• AVAudioEngine： 使用 AVAudioEngine 进行音频处理，通过 APU 输出定期调度音频缓冲区。

图形API

• MetalKit： 使用 MTKView 和 MTLTexture 渲染 PPU 输出的帧。

项目安装方式

通过 Xcode 安装

1. 打开 Xcode 并加载项目。
2. 选择目标设备（iOS、iPadOS、macOS 或 tvOS）。
3. 点击 Build and Run 按钮进行安装。

通过 tvOS 安装

1. 将 ROM 文件复制到 nes-emu-tvos/Resources/ 目录。
2. 在 Xcode 中添加 ROM 文件到 nes-emu-tvos 构建目标。
3. 构建并安装到 tvOS 设备。

性能优化

• 发布模式： 建议在发布模式下构建应用以获得最佳性能。
• 调试模式优化： 在调试模式下，可以通过调整以下设置提升性能：
  • 禁用安全检查
  • 独占内存访问
  • 优化级别设置为 Optimize for Speed [-O]

未来计划

• 支持更多映射器
• 性能改进
• 屏幕控制改进
• tvOS 应用目标改进