iMac上网易云音乐无法输出到BlackHole虚拟音频设备？

Question

iMac上网易云音乐无法输出到BlackHole虚拟音频设备，是macOS音频路由中的典型兼容性问题。根本原因在于：网易云音乐（尤其是较新版本）默认使用Core Audio的“独占模式”或硬编码输出设备（如内置扬声器/耳机），不响应系统级音频路由设置；而BlackHole作为无内核扩展（kext-free）的虚拟设备，依赖应用主动选择其为输出目标——但网易云音乐的音频模块未开放设备枚举接口，导致在系统声音偏好设置中即使将BlackHole设为默认输出设备，网易云仍绕过该设置直接输出至硬件设备。此外，SIP保护、TCC权限限制及网易云沙盒化策略也会阻止其访问第三方音频驱动。临时规避方案包括使用Soundflower（旧版兼容性更好）、Audio Hijack中间劫持，或通过Rogue Amoeba系列工具桥接；长期需依赖网易云官方适配ASIO/Core Audio多设备API。

Answer 1

```html

一、现象层：典型症状与复现路径

• iMac（macOS Ventura/Sonoma）安装 BlackHole 2ch/16ch 后，在「系统设置 → 声音 → 输出」中成功设为默认设备；
• 网易云音乐 v3.4.0+（含 Apple Silicon 原生版本）播放时，音频仍从内置扬声器或已连接耳机输出；
• 打开 Audio MIDI Setup，可识别 BlackHole 设备且状态正常（绿色指示灯），但网易云音乐内无设备选择菜单；
• 使用 coreaudiod 日志（log stream --predicate 'subsystem == "com.apple.audio"' | grep -i "netease"）可见其绕过 HAL device enumeration 直接绑定到 AppleHDAEngineOutput:1B,0,1,0:0 等硬件端点。

二、机制层：Core Audio 架构下的三重隔离壁垒

下图展示网易云音乐与 BlackHole 的通信阻断路径：

graph LR
A[网易云音乐进程] -->|1. 沙盒容器限制| B[App Sandbox Entitlements]
A -->|2. 独占式 Audio Unit 初始化| C[Hardcoded HAL Device ID]
A -->|3. TCC 权限缺失| D[No com.apple.security.device.audio-input]
B --> E[无法加载第三方 Audio Driver Bundle]
C --> F[跳过 AudioObjectGetPropertyData(kAudioHardwarePropertyDefaultOutputDeviceID)]
D --> G[Core Audio HAL 不向沙盒应用暴露虚拟设备枚举结果]

三、约束层：macOS 安全模型对音频路由的深度干预

约束类型	技术表现	影响范围
SIP (System Integrity Protection)	阻止 /Library/Audio/Plug-Ins/HAL/ 下非签名驱动动态注入	BlackHole 的 .atc/.bundle 文件虽免 kext，但仍受 SIP 对插件签名链校验
TCC (Transparency, Consent, Control)	需显式授予 com.apple.security.device.audio 权限，但网易云未在 Info.plist 中声明	即使用户手动授权，沙盒策略拒绝运行时设备发现 API 调用
App Sandbox	禁用 AudioObjectGetPropertyData 对非白名单设备的枚举	BlackHole 设备 UUID 不在 Apple 内置白名单中，被 Core Audio HAL 静默过滤

四、验证层：诊断命令与日志证据链

1. 检查设备可见性：system_profiler SPAudioDataType | grep -A5 "BlackHole" → 显示设备存在但状态为 “Not Available”；
2. 抓取音频会话信息：afplay -v 1 /dev/null 2>&1 | grep "device"（对比网易云进程的 ps aux | grep NetEase + lsof -p [PID] | grep audio）；
3. 启用 Core Audio debug：sudo killall coreaudiod && sudo launchctl kickstart -k system/com.apple.audio.coreaudiod，随后执行 defaults write com.apple.audio.CoreAudioDebug -bool YES；
4. 观察 Console.app 中 audio.hal 子系统日志，搜索关键词 "NetEaseCloudMusic" AND "deviceID"，确认其硬编码值为 0x20000（即 Built-in Output）。

五、应对层：分阶段兼容性解决方案矩阵

• 短期规避（无需代码修改）：部署 Audio Hijack 4.5+ 创建「网易云音乐 → BlackHole」路由链，利用其私有 Hook 机制劫持 Audio Unit render callback；
• 中期桥接（降低侵入性）：使用 Loopback（Rogue Amoeba）创建虚拟聚合设备，将 BlackHole 设为子设备，并强制网易云音乐输出至该聚合设备（依赖其对 Aggregate Device 的有限兼容）；
• 遗留方案回退：降级至 Soundflower 2.0b2（仅支持 Intel Mac），因其采用传统 kext + HAL 插件双模架构，对沙盒应用设备枚举兼容性更高；
• 开发者协作路径：向 NetEase 提交 GitHub Issue（https://github.com/netease-cloud-music/electron/issues），要求开放 audioDeviceList API 并支持 setAudioOutputDevice(deviceId) 方法。

六、演进层：行业趋势与架构升级建议

随着 macOS Sequoia 推出 AVAudioEngine 的 AVAudioSessionCategoryPlayAndRecord 新增 .defaultToSpeaker 选项控制权上收，以及 Apple 正在推动的 Core Audio 2.0（基于 Swift Concurrency 的异步设备枚举），未来解决路径将聚焦于：

• 推动网易云音乐接入 AVAudioSession.setPreferredInput(_:) 和 setPreferredOutput(_:)（需解除沙盒音频设备限制 Entitlement）；
• BlackHole 社区版正在开发 BlackHole-SandboxBridge 辅助进程，通过 XPC 服务代理设备发现请求；
• 企业级部署可结合 MDM（如 Jamf Pro）预配置 com.apple.TCC.configuration-profile-policy 强制授予音频设备权限（需用户交互确认）。

```