Android-Cam-Bridge

项目概述

Android Cam Bridge（ACB）是面向 Android 采集端 + Windows 接收端的摄像头桥接项目。Android 端通过 CameraX 采集并编码 H.264/AAC 推流，Windows 端以 HTTP 控制面配合 WebSocket 媒体面接收，既能通过 OBS 插件把手机画面当作摄像头源，也提供 WinUI 图形控制台管理会话与查看统计，适合直播、录制与本地调试时把手机当摄像头使用。

把 Android 手机变成电脑上随取随用的摄像头。

主要功能

• 双端架构：Android 端负责 CameraX 采集与 H.264/AAC 编码推流，Windows 端负责会话控制、帧接收与解码统计
• OBS 接入：提供 android_cam_source 源插件，可在 OBS 中直接使用手机画面
• GUI 控制台：WinUI 应用可配置接收端地址、管理会话、查看统计与日志，并支持 ADB 设置
• 会话管理：通过 HTTP API 启动与停止会话，媒体帧走 WebSocket 主链路，并保留兼容路径
• 一键打包：内置构建、打包与安装器脚本，方便部署

适用人群

• 想把 Android 手机当作电脑摄像头的用户
• 需要在 OBS 中使用手机画面的直播与录制用户
• 做跨设备视频输入调试的开发者

快速上手

1. 构建 Windows 目标：执行 pwsh ./scripts/build.ps1 -Config Release
2. 启动接收端：运行 acb-receiver.exe
3. 可选启动 GUI 控制台：执行 pwsh ./scripts/run-gui.ps1
4. 构建 Android 端：进入 android 目录后执行 gradle :app:assembleDebug
5. 在 OBS 中添加 android_cam_source 源即可使用手机画面

核心优势

• 分工清晰：控制面与媒体面分离，WebSocket 主链路降低传输延迟
• 免装驱动：手机端无需特殊硬件即可作为视频输入源
• 可打包分发：附带安装器脚本，便于部署到多台机器
• 可扩展：协议文档齐全，便于按需二次开发

系统要求

项目	要求
接收端系统	Windows 10/11
开发环境	Visual Studio 2022、CMake 3.22+、PowerShell 7+
Android 端	Java 17、Gradle、Android Platform Tools（ADB）
可选	OBS Studio（插件联调）、.NET 10 SDK（GUI）

注意事项

• OBS 插件建议与本地 OBS 使用相同的 libobs 小版本，避免 ABI 不匹配导致加载失败
• 虚拟摄像头桥接目前仍是实验功能，请谨慎用于正式场景
• 接收端默认监听 http://127.0.0.1:39393，如需外部访问请注意网络暴露风险