在Web应用里，如果我们希望网页能够识别并使用电子乐器等MIDI硬件，首先要确认当前运行环境是否具备这样的能力。BOM（浏览器对象模型）中的navigator对象提供了Web MIDI API的入口，通过它可以检测用户设备与浏览器对MIDI的支持情况。
检测MIDI支持的基本思路
Web MIDI API并没有一个单独的布尔属性来表示支持与否，而是通过在navigator上是否存在requestMIDIAccess方法来判断。这个方法返回一个Promise，成功后得到MIDIAccess对象，从中能够获取输入与输出设备。
判断方法是否存在
最基础的做法是检查typeof navigator.requestMIDIAccess是否为function。如果不存在，说明浏览器未实现该API，此时应引导用户更换浏览器或给出友好提示。
// 检测浏览器是否支持Web MIDI API
if (typeof navigator.requestMIDIAccess === 'function') {
console.log('当前环境支持MIDI设备');
} else {
console.log('抱歉，当前浏览器不支持MIDI');
}
完整检测与设备枚举示例
在确认方法存在后，可以调用requestMIDIAccess获取访问权限。用户可能拒绝授权，因此要用catch处理异常。获得MIDIAccess后，通过inputs和outputs属性可以遍历已连接的设备。
// 完整检测并列出MIDI设备
if (typeof navigator.requestMIDIAccess !== 'function') {
alert('您的浏览器不支持Web MIDI，请使用Chrome等兼容浏览器');
} else {
navigator.requestMIDIAccess()
.then(function (access) {
// 遍历输入设备
const inputs = access.inputs.values();
for (let item = inputs.next(); !item.done; item = inputs.next()) {
console.log('输入设备: ' + item.value.name);
}
// 遍历输出设备
const outputs = access.outputs.values();
for (let item = outputs.next(); !item.done; item = outputs.next()) {
console.log('输出设备: ' + item.value.name);
}
})
.catch(function (err) {
console.error('获取MIDI权限失败: ' + err);
});
}
注意事项
- Web MIDI API在部分浏览器中需要HTTPS环境或localhost才能使用。
- 用户首次访问时浏览器会请求授权，被拒绝后将无法读取设备。
- 使用<code>标签时仅作文本展示，实际API名称为navigator.requestMIDIAccess。
总结
通过判断navigator上requestMIDIAccess方法的存在性，并在授权成功后枚举inputs与outputs，我们就能在BOM中可靠地检测用户的MIDI设备支持情况。这样可以在项目初期做好兼容处理，避免不支持的环境中出现脚本错误。
BOMWebMIDInavigator_requestMIDIAccess修改时间：2026-07-27 12:24:16