🎹 Web MIDI 使用教程（基于 loopMIDI）

本教程将指导你如何通过 loopMIDI + Web MIDI API，让本网站实现自动钢琴播放功能。

📌 一、前置准备

在开始之前，请确保：

• 使用支持 Web MIDI API 的浏览器（推荐 Chrome / Edge）
• 系统为 Windows（loopMIDI 仅支持 Windows）

⬇️ 二、下载安装 loopMIDI

1. 前往 loopMIDI 官网下载安装程序
2. 安装完成后，打开 loopMIDI

🔌 三、创建虚拟 MIDI 端口

1. 打开 loopMIDI
2. 点击左下角 + 按钮
3. 创建一个新的端口（例如命名为：loopMIDI Port）

创建成功后，你会看到类似：

CopyloopMIDI Port [Running]

🌐 四、打开网站并授权 MIDI 权限

1. 打开本网站的 MIDI 页面：https://mahirooyama.cn/midi

2. 页面加载后，浏览器会弹出权限请求：

“Control and reprogram your MIDI devices”

3. 点击：

👉 Allow（允许）

⚠️ 如果点击了 Block，需要手动在浏览器设置中重新开启权限。

🎵 五、开始使用功能

授权成功后：

• 网站会自动识别你刚创建的 loopMIDI 端口

• MIDI 文件播放时会通过该端口输出

• 你可以：

  • ▶️ 点击 Play 播放
  • ⬇️ 下载 MIDI 文件
  • 🔍 搜索 MIDI 文件

🧠 工作原理（简单说明）

Copy网站 (Web MIDI API)
        ↓
虚拟端口 (loopMIDI)
        ↓
你的 MIDI 设备 / 软件（如自动钢琴）

❗ 常见问题

1. 没有弹出权限请求？

• 检查是否使用 Chrome / Edge
• 尝试刷新页面

2. 设备列表为空？

• 确认 loopMIDI 已启动
• 确认已创建端口
• 刷新网页

3. 点击了 Block 怎么办？

在浏览器地址栏：

1. 点击 🔒 图标
2. 找到 MIDI 权限
3. 改为 Allow
4. 刷新页面

✅ 完成！

现在你已经成功连接 Web MIDI 🎉 可以开始体验自动钢琴播放功能了！