Skip to content

Apple Watch

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

Apple Watch

README.md

Apple Watch 麦克风

将 Apple Watch 作为 Mac 的实时麦克风输入。Watch App 采集语音，Mac App 负责本地桥接、设备发现、音频处理和运行状态展示。

音频链路

Apple Watch 麦克风
  -> watchOS App（16 kHz 单声道 Float32 PCM）
  -> 局域网 HTTP 桥接（端口 17842）
  -> Mac 音频播放器
  -> BlackHole 2ch
  -> 输入法或其他语音应用

当前归档不包含 Watch Mic 实验驱动源码，默认并完整支持的输出路径是 BlackHole 2ch。

环境

  • macOS 13 或更高版本
  • Xcode 与 watchOS 10 或更高版本开发组件
  • Node.js 20 或更高版本
  • 已配对的 Apple Watch
  • BlackHole 2ch

真机安装前需要在 Xcode 中为 CodexWatchCompanion 和 WatchMicWidgetExtension 选择开发团队。

构建与运行

npm run check
./scripts/build-mac-app.sh
open build/WatchMicProxyMac.app

xcrun devicectl list devices
./scripts/install.sh --device <APPLE_WATCH_DEVICE_ID> --launch

Mac 和 Apple Watch 需要位于可互相访问的本地网络，并授予麦克风与本地网络权限。

目录

  • CodexWatchCompanion/：watchOS App、录音和网络连接
  • WatchMicWidgetExtension/：表盘与智能堆栈入口
  • mac/：Mac 控制应用
  • bridge/：本地 HTTP 与音频桥接服务
  • tools/：音频播放、输入电平和图标生成工具
  • tests/、CodexWatchCompanionTests/：Node 与 Swift 测试

BlackHole 仅作为外部运行依赖，本仓库未包含其源码或安装包。