NintendoSpy 技术文档

本文档将详细介绍如何安装、使用以及项目API的使用，帮助用户更好地理解和运用NintendoSpy项目。

1. 安装指南

首先，您可以从以下链接下载最新的NintendoSpy版本（适用于x64和实验性x86 Windows二进制文件）：

下载最新版本的NintendoSpy。

硬件连接

项目的通用设计涉及剪断控制器线缆，并将适当的信号线连接到Arduino。然后，您需要安装包含在NintendoSpy发行版中的Arduino固件，并运行查看器软件。

固件安装

1. 将Arduino连接到计算机。
2. 打开Arduino IDE。
3. 选择正确的Arduino板型和端口。
4. 上传NintendoSpy发行版中包含的固件。

软件安装

解压缩下载的NintendoSpy发行版，并运行NintendoSpy.exe以打开控制器查看器。

2. 项目使用说明

输入源配置

启动程序后，您会看到输入源配置屏幕。首先选择您的NintendoSpy硬件设置为查看的控制系统，例如“PC 360”或“通用PC游戏手柄”。如果是后两者，由于设备通过标准USB接口连接，所以COM端口不相关。但如果选择Nintendo控制台，则需要选择Arduino通信的COM端口。

皮肤选择

选择输入源后，您需要选择一个皮肤。每个皮肤都包含多个背景，通常用于为控制器提供不同的颜色。选择皮肤后，点击“Go!”，您应该可以看到查看器屏幕。

创建自定义皮肤

每个皮肤都在“skins”目录下的一个子文件夹中，该文件夹包含一个名为skin.xml的文件以及所有必要的PNG图像资源。您可以复制默认皮肤并根据自己的需求进行修改。

3. 项目API使用文档

NintendoSpy支持通过XML文件绑定控制器输入到键盘按键。这通过在keybindings.xml文件中放置<binding>定义来实现。output-key属性指定当按下游戏手柄按钮时应该按下的键盘键。每个绑定至少包含一个子<input>元素，用于指定必须按下的控制器按钮。

以下是一个示例keybindings.xml文件，它将L和R按钮同时按下时触发键盘上的“home”键：

<?xml version="1.0" encoding="UTF-8"?>
<keybindings>
    <binding output-key="home">
        <input button="r" />
        <input button="l" />
    </binding>
</keybindings>

4. 项目安装方式

硬件安装

1. 剪断控制器线缆。
2. 连接适当的信号线到Arduino。
3. 上传固件到Arduino。

软件安装

1. 解压缩NintendoSpy发行版。
2. 运行NintendoSpy.exe。

通过以上步骤，您应该能够成功安装并使用NintendoSpy项目。