如何在AudioKit 5中添加MIDIBeatObserver并监听事件？

以下是完整的Swift示例代码，实现自定义MIDIBeatObserver并通过MIDIClockListener接收Logic Pro的MTC、实时时钟及小节节拍同步数据：

1. 自定义MIDIBeatObserver类 #

实现MIDIBeatObserver协议，处理所有同步回调事件：

import AudioKit

class CustomMIDIBeatObserver: MIDIBeatObserver {
    // 实时MIDI时钟脉冲回调（每24个脉冲对应1个四分音符）
    func receivedClock(at time: MIDITimeStamp) {
        print("MIDI时钟脉冲，时间戳：\(time)")
        // 在此更新应用内的实时播放进度、动画等
    }

    // MTC 1/4帧数据回调（需累积8帧组成完整时间码）
    func receivedMTC1QuarterFrame(_ data: UInt8) {
        print("MTC 1/4帧：\(data)")
    }

    // 完整MTC时间码回调（AudioKit已完成帧数据累积）
    func receivedFullMTC(hours: UInt8, minutes: UInt8, seconds: UInt8, frames: UInt8, subFrames: UInt8) {
        let timeCode = String(format: "%02d:%02d:%02d:%02d", hours, minutes, seconds, frames)
        print("完整MTC时间码：\(timeCode)，子帧：\(subFrames)")
        // 同步应用的时间显示或播放位置
    }

    // 小节/节拍位置更新回调
    func beatPositionChanged(bar: UInt16, beat: UInt16, ticks: UInt16, at time: MIDITimeStamp) {
        print("当前位置：第\(bar)小节 | 第\(beat)拍 | Ticks：\(ticks)")
        // 同步应用的编曲进度、节拍UI等
    }

    // MIDI启动指令回调
    func receivedStart(at time: MIDITimeStamp) {
        print("MIDI启动，时间戳：\(time)")
        // 触发应用内播放开始逻辑
    }

    // MIDI停止指令回调
    func receivedStop(at time: MIDITimeStamp) {
        print("MIDI停止，时间戳：\(time)")
        // 触发应用内播放停止逻辑
    }

    // MIDI继续指令回调
    func receivedContinue(at time: MIDITimeStamp) {
        print("MIDI继续，时间戳：\(time)")
        // 触发应用内播放继续逻辑
    }
}

2. 初始化MIDIClockListener并绑定观察者 #

创建一个管理器类来封装同步逻辑，避免代码耦合：

import AudioKit
import AudioKitEX

class MIDISyncManager {
    private var clockListener: MIDIClockListener!
    private var customObserver: CustomMIDIBeatObserver!

    init() {
        customObserver = CustomMIDIBeatObserver()
        // 初始化监听器：nil表示监听所有可用MIDI输入，也可指定Logic Pro的端口名称
        clockListener = MIDIClockListener(midiInputName: nil)
        // 添加自定义观察者到监听器
        clockListener.addBeatObserver(customObserver)
        
        // 启动MIDI监听
        do {
            try clockListener.start()
            print("MIDI同步监听已启动")
        } catch {
            print("启动监听失败：\(error.localizedDescription)")
        }
    }

    // 停止监听并移除观察者
    func stopSync() {
        clockListener.stop()
        clockListener.removeBeatObserver(customObserver)
    }
}

3. 在应用中集成同步管理器 #

在ViewController或其他核心类中初始化并使用：

import UIKit

class MainViewController: UIViewController {
    private var syncManager: MIDISyncManager!

    override func viewDidLoad() {
        super.viewDidLoad()
        // 启动MIDI同步
        syncManager = MIDISyncManager()
    }

    deinit {
        // 销毁时停止监听
        syncManager.stopSync()
    }
}

关键注意事项 #

• 指定MIDI端口：如果需要仅监听Logic Pro的MIDI输出，可替换MIDIClockListener初始化时的midiInputName为Logic Pro对应的端口名，可通过MIDIClient枚举所有可用端口获取。
• 权限配置：在Info.plist中添加NSAppleMusicUsageDescription键，说明应用需要访问MIDI设备的原因，否则会被系统拒绝访问。
• 节拍精度：beatPositionChanged中的ticks基于当前MIDI时钟的PPQN（每四分音符Ticks数），可用于实现高精度的位置同步。

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