如何使用Apple HealthKit监控headphoneAudioExposureEvent？

• 你当前查询的HKCategoryTypeIdentifier.headphoneAudioExposureEvent是系统判定的超过安全阈值的音频曝光事件，不是实时音量采样数据，只有当用户耳机音量长时间过高触发系统提醒时才会生成这类样本，普通播放音频不会产生该类型数据，所以你拿到的samples为空是正常的。
• HKObserverQuery的回调仅负责通知你对应数据类型有新增/变更，回调自带的samples参数默认不会返回完整样本列表，你需要在收到更新通知后主动调用HKSampleQuery拉取实际数据。
• 你没有调用观察者查询的completion()回调，系统会认为你还没处理完本次更新，不会触发后续的更新通知，这是你后续无响应的核心原因。
• 如果你需要监控耳机的音量水平，应该使用HKQuantityTypeIdentifier.headphoneAudioExposure类型，这是系统按分钟采样的耳机音频暴露量数据，单位是dBASPL。

import HealthKit

private let healthStore = HKHealthStore()
// 全局持有查询实例，避免被ARC自动释放
private var audioObserverQuery: HKObserverQuery?

func requestAudioExposureAuthorization() {
    guard let exposureType = HKObjectType.quantityType(forIdentifier: .headphoneAudioExposure),
          let eventType = HKObjectType.categoryType(forIdentifier: .headphoneAudioExposureEvent) else {
        print("当前设备不支持HealthKit耳机音频曝光查询")
        return
    }
    let readTypes: Set<HKObjectType> = [exposureType, eventType]
    
    healthStore.requestAuthorization(toShare: nil, read: readTypes) { [weak self] success, error in
        if let error = error {
            print("授权失败: \(error.localizedDescription)")
            return
        }
        guard success else {
            print("用户拒绝了HealthKit读取权限")
            return
        }
        self?.startObservingAudioExposure()
    }
}

func startObservingAudioExposure() {
    guard let exposureType = HKObjectType.quantityType(forIdentifier: .headphoneAudioExposure) else {
        return
    }
    let descriptor = HKQueryDescriptor(sampleType: exposureType, predicate: nil)
    
    // 初始化观察者查询
    audioObserverQuery = HKObserverQuery(queryDescriptors: [descriptor]) { [weak self] _, _, completion, error in
        if let error = error {
            print("监听错误: \(error.localizedDescription)")
            // 必须调用completion告知系统处理完成
            completion()
            return
        }
        // 收到更新通知后，主动拉取最新样本
        self?.fetchLatestAudioExposureSamples()
        // 必须调用completion，否则后续不会收到更新通知
        completion()
    }
    
    guard let query = audioObserverQuery else { return }
    healthStore.execute(query)
    
    // 可选：开启后台更新，应用在后台时也能收到更新通知
    healthStore.enableBackgroundDelivery(for: exposureType, frequency: .immediate) { success, error in
        if let error = error {
            print("开启后台更新失败: \(error.localizedDescription)")
        }
    }
}

// 拉取实际的音频曝光样本
func fetchLatestAudioExposureSamples() {
    guard let exposureType = HKObjectType.quantityType(forIdentifier: .headphoneAudioExposure) else {
        return
    }
    // 只查询过去1小时内的样本，可根据需求调整时间范围
    let predicate = HKQuery.predicateForSamples(withStart: Date().addingTimeInterval(-3600), end: Date(), options: .strictStartDate)
    // 按时间倒序排列
    let sortDescriptor = NSSortDescriptor(key: HKSampleSortIdentifierStartDate, ascending: false)
    
    let sampleQuery = HKSampleQuery(sampleType: exposureType, predicate: predicate, limit: 20, sortDescriptors: [sortDescriptor]) { _, samples, error in
        if let error = error {
            print("拉取样本失败: \(error.localizedDescription)")
            return
        }
        guard let quantitySamples = samples as? [HKQuantitySample] else {
            print("暂无音频曝光样本")
            return
        }
        // 处理样本数据
        for sample in quantitySamples {
            let volumeLevel = sample.quantity.doubleValue(for: HKUnit.decibelAWeightedSoundPressureLevel())
            print("采样时间: \(sample.startDate), 音量: \(volumeLevel) dBASPL")
        }
    }
    healthStore.execute(sampleQuery)
}

• 耳机音频曝光数据是系统采样生成的，最小采样间隔为1分钟，不会返回秒级的实时音量数据，如果需要更细粒度的音量数据，HealthKit无法满足，你需要使用AVAudioSession相关接口获取当前应用播放的音量。
• 要在Info.plist中添加NSHealthShareUsageDescription和NSHealthUpdateUsageDescription权限描述，否则会触发崩溃。
• 只有当音频是通过有线/蓝牙耳机播放时才会生成该类数据，手机扬声器播放的音频不会被计入。

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