如何让OscillatorNode在iOS设备上正常发声？

问题核心原因 #

iOS Safari 的 AudioContext 默认处于 suspended（暂停） 状态，即使在用户交互回调中调用音频播放逻辑，也需要显式触发上下文的激活操作——仅创建 AudioContext 或调用振荡器的 start() 不足以解锁音频权限。

具体修复方案 #

调整代码逻辑，确保在第一次用户交互时完成 AudioContext 的初始化/恢复操作，再执行音频播放：

let audioCtx; // 先声明，延迟初始化
const notes = { /* 你的音符-频率映射表 */ };
const wavetypeEl = $('#wavetype'); // 对应你的波形选择元素

function playNote(note) {
    const freq = notes[note];
    console.debug(`${note} (${freq} Hz)`);
    const oscillator = audioCtx.createOscillator();
    oscillator.type = wavetypeEl.val();
    oscillator.frequency.setValueAtTime(freq, audioCtx.currentTime);
    oscillator.connect(audioCtx.destination);
    oscillator.start();
    oscillator.stop(audioCtx.currentTime + 0.5);
}

$('#keyboard button').on('click', async (e) => {
    // 第一次交互时初始化 AudioContext
    if (!audioCtx) {
        audioCtx = new (window.AudioContext || window.webkitAudioContext)();
    }
    // 若上下文处于暂停状态，恢复后再播放
    if (audioCtx.state === 'suspended') {
        await audioCtx.resume();
    }
    playNote(e.target.dataset.note);
});

关键细节说明 #

1. 延迟初始化/显式恢复：将 AudioContext 的初始化移到用户首次点击事件中，同时检查上下文状态，确保调用 resume() 并等待其完成（resume() 返回 Promise，用 async/await 保证时序）。
2. 废弃 API 无需理会：苹果文档提到的 noteOn() 是旧版 Web Audio API，现代 iOS Safari 完全支持标准的 start() 方法，无需替换。
3. 状态检查必要性：部分 iOS 版本中，即使在交互中创建 AudioContext，仍可能处于暂停状态，显式检查并恢复是可靠的解决方式。

内容的提问来源于stack exchange，提问作者lshillman