Skip to content

GETTING_STARTED.md

Latest commit

 

History

History
350 lines (239 loc) · 7.82 KB

GETTING_STARTED.md

File metadata and controls

350 lines (239 loc) · 7.82 KB

快速开始指南

欢迎使用伊机控！即使您没有编程经验，也能轻松上手。本指南将带您从零开始，逐步掌握伊机控的使用。

🎯 您将学到

  • ✅ 如何安装和运行伊机控
  • ✅ 如何编写您的第一个自动化脚本
  • ✅ 如何控制Switch游戏主机
  • ✅ 如何使用图像识别功能

📋 准备工作

您需要什么？

必需设备：

  • 🖥️ 一台电脑（Windows、Mac或Linux都可以）
  • 🧶 兼容的单片机设备（如ESP32、Arduino等）
  • 🎮 任天堂Switch主机
  • 🔌 多根USB数据线，用于将它们连起来

可选设备：

  • 📹 视频采集卡（用于图像识别功能）

软件要求：

  • 您的电脑系统要能运行现代软件
  • 需要管理员权限来安装软件

🚀 第一步：安装伊机控

Windows用户

  1. 下载程序

    • 访问项目发布页面
    • 下载最新的Windows版本压缩包
    • 解压到您喜欢的文件夹（比如桌面或D盘）

  2. 直接运行

    • 双击 EasyCon.exe 就可以使用了
    • 不需要安装任何其他软件

Mac用户

  1. 下载程序

    • 下载Mac版本的压缩包
    • 解压到应用程序文件夹

  2. 允许运行

    • 右键点击程序，选择"打开"
    • 如果提示安全问题，在"系统设置"中允许运行

Linux用户

  1. 下载程序

    • 下载Linux版本
    • 解压到任意文件夹

  2. 添加执行权限

    chmod +x EasyCon
./EasyCon

🎮 第二步：连接您的Switch

方式一：直接连接（推荐新手）

适合：想要快速体验自动化功能的用户

  1. Switch端准备

    • 在Switch主菜单中选择"Controllers and Sensors"
    • 选择"Change Grip/Order"
    • 这会让Switch进入配对模式
    • 将单片机接入Switch主机

  2. 电脑端操作

    • 用USB线连接单片机与Switch和电脑
    • 启动伊机控程序
    • 程序会自动识别设备

方式二：单片机控制（推荐进阶用户）

适合：想要自动化程度更高的用户

  1. 硬件准备

    • 准备一个兼容的单片机（CH32/ESP32S3推荐）
    • 烧录伊机控固件到单片机
    • 用USB线连接单片机到电脑

  2. 软件设置

    • 在伊机控中选择对应的串口
    • Windows通常是COM1、COM2等
    • Mac通常是/dev/cu.usbserial-xxx
    • Linux通常是/dev/ttyUSB0

✍️ 第三个脚本：Hello World

创建您的第一个脚本

打开文本编辑器：

  • Windows：记事本即可
  • Mac：TextEdit即可
  • 或使用任何代码编辑器（如VS Code）

输入以下内容：

# 我的第一个伊机控脚本
# 这个脚本会让Switch按A键10次

for $i = 1 to 10
    A              # 按下A键
    WAIT 100       # 等待100毫秒
next

PRINT "完成！"    # 显示完成消息

保存文件：

  • 将文件保存为 test.ecs
  • 保存到容易找到的位置，比如桌面

运行您的脚本

  1. 启动伊机控程序
  2. 点击"打开脚本"按钮
  3. 选择您刚保存的 test.ecs 文件
  4. 点击"运行"按钮

如果您使用命令行版本：

# 在命令行中运行
./ezcon run test.ecs

🎯 实用示例：自动对话

制作一个简单的自动对话脚本

场景：游戏中需要反复对话，每次需要按A键多次

脚本代码：

# 自动对话脚本
# 功能：自动按A键10次，每次间隔200毫秒

for $i = 1 to 10
    A              # 按A键对话
    WAIT 200       # 等待对话完成
next

PRINT "对话完成"

使用方法：

  1. 在游戏中面对要对话的角色
  2. 运行脚本
  3. 脚本会自动完成对话过程

📸 第四步：使用图像识别（可选）

什么是图像识别？

简单来说：伊机控可以"看"到游戏画面，根据看到的画面做出不同的反应。

举个例子：

  • 当看到"闪光宝可梦"出现时，自动停止脚本
  • 当看到"对话框"时，自动按A键继续

基础图像识别脚本

# 图像识别示例
# 功能：循环检测是否找到目标图像

for 100           # 最多检查100次
    # 检查画面中是否有"闪光"特征
    $result = @闪光图像
    
    # 如果匹配度超过90%，认为找到了
    if $result > 90
        PRINT "发现目标！"
        ALERT "找到闪光了！"    # 发送通知
        BREAK                    # 停止循环
    endif
    
    WAIT 1000       # 等待1秒再检查
next

PRINT "搜索结束"

🔧 常见问题解决

Q: 程序启动后显示"找不到设备"

A: 别担心，这是正常的！

  1. 检查USB连接

    • 确保USB线连接牢固
    • 尝试更换USB接口
    • 如果使用USB集线器，直接连到电脑

  2. 使用虚拟模式测试

    • 程序通常有"虚拟模式"选项
    • 即使没有设备也能测试脚本
    • 先用虚拟模式熟悉操作

Q: 脚本运行没有反应

A: 按这个顺序检查

  1. 检查设备连接

    • 确认Switch已正确连接
    • 观察Switch是否有按键反应

  2. 检查脚本语法

    • 确保按键名称正确（A、B、X、Y等）
    • 确保格式正确（空格、换行等）

  3. 使用简单脚本测试

    A 200    # 按A键200毫秒，很容易看到效果

Q: 想要更长的延时怎么办？

A: 使用WAIT命令

# WAIT后面的数字是毫秒数
WAIT 1000    # 等待1秒
WAIT 2000    # 等待2秒
WAIT 5000    # 等待5秒

Q: 如何停止正在运行的脚本？

A: 有几种方法

  1. 点击"停止"按钮（如果有）
  2. 按Ctrl+C（命令行版本）
  3. 快速拔掉USB线（紧急情况）

💡 新手小贴士

从简单开始

✅ 推荐做法：

  • 先用简单脚本测试功能
  • 逐步增加复杂度
  • 每次只改变一个参数

❌ 避免：

  • 一开始就写复杂的脚本
  • 同时尝试多个新功能
  • 在重要的游戏存档上直接测试

保存好存档

⚠️ 重要提醒：

  • 自动化可能会产生不可预期结果
  • 建议在测试前备份游戏存档
  • 在不重要的存档上先测试脚本

渐进式调试

调试小技巧：

  1. 每写几行就测试一次
  2. 多用PRINT显示运行状态
  3. 观察Switch的反应，调整参数

📖 下一步学习

现在您已经掌握了基础，可以继续学习：

进阶功能

实际应用

  • 宝可梦孵蛋脚本 - 自动化宝可梦培育
  • 刷闪光脚本 - 提高稀有宝可梦获取效率
  • 自动化日常任务 - 解放双手，享受游戏

🆘 需要帮助？

自助解决问题

  1. 查看常见问题 - 本文档的"常见问题解决"章节
  2. 检查脚本语法 - 使用程序的语法检查功能
  3. 查看示例脚本 - 参考examples目录中的示例

社区支持

🎉 恭喜！

您已经完成了伊机控的入门学习！

您现在可以：

  • ✅ 编写基础自动化脚本
  • ✅ 控制Switch游戏主机
  • ✅ 使用图像识别功能
  • ✅ 解决常见问题

继续探索：

  • 📚 学习更高级的脚本技巧
  • 🎮 为您喜欢的游戏制作自动化脚本
  • 🔧 探索图像识别的强大功能

记住：熟能生巧！多尝试，多练习，您很快就能成为伊机控专家。

最后更新: 2026年4月16日
版本: 2.0

下一步: 去示例脚本库看看其他有趣的应用吧！