You need to enable JavaScript to run this app. 将应用与AudioUnit、AUv3协议集成:基于AudioKit的iOS MIDI控制器适配MIDI输出配置
优惠活动
大模型
产品
解决方案
定价
更多

将应用与AudioUnit、AUv3协议集成:基于AudioKit的iOS MIDI控制器适配MIDI输出配置

AudioKit v5 MIDI控制器适配AUv3 端口连接实现方案

原独立实现的适用边界

你之前写的这套零配置MIDI连接逻辑,仅适用于独立运行的iOS App场景:

  • 独立App进程拥有注册系统级虚拟MIDI端口的权限,AudioKit.MIDI初始化后调用createVirtualOutputPorts(),会在iOS全局CoreMIDI服务里注册一个带应用标识的输出端口
  • 只要其他App的MIDI输入端口处于可监听状态,系统MIDI路由层会自动建立连接,不需要额外手动配置
  • 这套逻辑在AUv3扩展场景下会完全失效,因为扩展进程没有独立注册系统可见虚拟端口的权限,就算照搬相同代码,宿主和其他App也识别不到对应端口

AUv3场景下的核心改造思路

你不需要在AUv3模式下复刻之前的虚拟端口创建逻辑——AUv3的设计本身就是把MIDI路由、端口选择的控制权交给宿主应用:

  • 你只要把MIDI事件的发送通道,从自建系统虚拟端口替换为对接AUv3音频单元自带的MIDI输出接口
  • 后续的端口连接、用户选择输出目标的操作,全部由宿主(比如AUM)内置的MIDI路由模块完成,不需要你自己实现端口选择界面

具体代码迁移步骤

  • 拆分MIDI初始化逻辑,按运行场景分流
    不要在AUv3扩展target的代码里初始化独立的AudioKit.MIDI实例,把原来的engine.createVirtualOutputPorts()、engine.openOutput()这些方法,全部保留在独立主App的target下即可
  • 替换MIDI事件的发送接口
    原来独立App里是调用engine.sendEvent把事件发到自建的虚拟端口,现在在AUv3环境里,直接调用音频单元自带的MIDI输出方法发事件即可,不需要额外维护MIDI引擎实例:
    独立App运行场景的原有代码保留:
    // 独立主App target 的原有逻辑,不需要修改
    let standaloneMIDIEngine = AudioKit.MIDI()
    standaloneMIDIEngine.createVirtualOutputPorts()
    standaloneMIDIEngine.openOutput()
    
    // 发音符事件的原有逻辑不变
    standaloneMIDIEngine.sendEvent(note: 60, velocity: 100, channel: 0)
    
    AUv3扩展运行场景的替换逻辑:
    // AUv3 音频单元类内部,不需要初始化独立MIDI引擎
    // 直接调用系统AU接口发送MIDI报文
    self.auAudioUnit.outputMIDIEvent(
      with: MusicEventUserData(),
      event: [0x90, 60, 100], // 对应通道0、音符开启、音高60、力度100的标准MIDI报文
      sampleTime: 0,
      offsetDuration: 0
    )
    
  • 配置AUv3组件的MIDI能力声明
    在AUv3 target的Info.plist组件描述里,添加对应MIDI输出能力的标识,明确告诉宿主这个音频单元可以向外发送MIDI事件。配置完成后,AUM这类支持AUv3的宿主加载组件时,会自动在界面上生成对应的MIDI输出选择面板,用户的端口选择操作会由宿主的路由层接管。
  • 做兼容层适配
    你可以在代码里加一层运行环境判断:如果当前处于独立主App进程,就走原有虚拟端口的发送逻辑;如果处于AUv3扩展进程,就走系统AU接口的发送逻辑,这样一套代码可以同时兼容独立运行、宿主内加载两种场景。

常见踩坑提醒

  • 不要在AUv3扩展进程里重复初始化全局的AudioKit.MIDI实例:扩展的MIDI服务连接由宿主统一管理,自行初始化会导致事件发送被沙盒拦截,完全无法送达
  • 不要尝试在扩展内创建自定义虚拟MIDI端口:iOS会把扩展创建的虚拟端口标记为系统隐藏端口,普通App和宿主都无法识别,完全起不到对外通信的作用
  • 发送MIDI事件时要对齐音频渲染的时间戳,通过接口提供的sampleTime参数传入当前渲染对应的音频时间点,避免出现音符节奏错位、延迟的问题

内容的提问来源于stack exchange,提问作者pistacchio

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 18:36:05