PhoneCam

PhoneCam 是一款专为 macOS 设计的开源工具，将闲置或备用的 Android/iPhone 手机转化为 Mac 的高质量视频输入源。它特别适合 Mac mini/Studio 等无内置摄像头的设备，或希望获得比自带摄像头更佳画质的用户。

该项目目前处于开发预览版阶段，完全本地运行，不经过云端，不涉及麦克风采集，专注于提供纯净、低延迟的视频流。

核心功能与接入路径

PhoneCam 支持三种主要的手机接入方式，覆盖主流设备：

注意：Android ADB 路径无需 Root，也无需在手机上安装常驻伴侣 APK。

典型应用场景

1. 补齐硬件短板：为 Mac mini、Mac Studio 或旧款 MacBook 提供高清视频输入。
2. 提升画质：利用手机强大的镜头模组和传感器，在光线充足时获得远超网络摄像头的画质。
3. 灵活演示：通过旋转、镜像、裁剪或留边，轻松实现文档拍摄、产品细节展示或手工过程直播。
4. OBS 直播/录制：通过 Syphon 协议将处理后的视频帧传入 OBS，实现专业级的推流或录制。

快速上手指南 (Android + OBS 路径)

1. 环境准备

• 系统：macOS 13+ (Apple Silicon 推荐)
• 依赖：Xcode 15+, Python 3, Android Platform Tools, OBS (支持 Syphon)
• 安装命令：

  brew install --cask android-platform-tools obs
  git clone https://github.com/wybaby168/phonecam.git
  cd phonecam
  ./scripts/build.sh --unsigned
  ./scripts/install.sh
  ./scripts/setup-android.sh  # 下载并校验 scrcpy-server
  

2. 连接与预览

• 手机开启 USB 调试 并连接 Mac，授权信任。
• 运行预览命令：

  phonecam preview --source android --require-hardware
  

• 若需输出给 OBS，添加 --syphon 参数：

  phonecam preview --source android --require-hardware --syphon
  

3. OBS 配置

• 在 OBS 中添加来源：Syphon Client。
• 选择 [PhoneCam] PhoneCam。
• 右键点击预览画面 -> 变换 -> 比例适配屏幕。
• 点击 OBS 右下角 “启动虚拟摄像机”。
• 在 Zoom/Teams/浏览器中选择 OBS Virtual Camera 作为摄像头。

常用 CLI 操作

PhoneCam 提供了丰富的命令行参数来控制视频流：

# 指定分辨率、帧率和码率
phonecam preview --source android --size 1920x1080 --fps 30 --bitrate 12M

# 图像变换：顺时针旋转90度、水平镜像、铺满画面
phonecam preview --source android --rotate 90 --mirror --fit fill

# 切换前置摄像头
phonecam preview --source android --facing front

# 诊断与统计：仅采集10秒数据，输出JSON格式统计信息
phonecam probe --source android --duration 10 --require-hardware --json

# 综合健康检查
phonecam doctor --json

隐私与安全

• 纯本地处理：所有视频数据仅在 Mac 内存和 GPU 中流转，不上传任何服务器。
• 无麦克风：PhoneCam 仅处理视频信号，不采集音频，避免隐私泄露风险。
• 无开机自启：默认不随系统启动，仅在用户主动运行时工作。
• 透明可控：CLI 工具提供结构化诊断，让用户清楚了解每一帧的来源与状态。