# CameraPhone **Repository Path**: ZTS11/CameraPhone ## Basic Information - **Project Name**: CameraPhone - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-27 - **Last Updated**: 2026-10-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
把 Android 手机摄像头变成 Windows 系统虚拟摄像头
连接指南 · 协议说明 · MIT License
--- ## 功能 | | | |--|--| | **USB / Wi-Fi** | 数据线一键 `adb forward`,或同一局域网填 IP 直连 | | **H.264 硬编(推荐)** | 手机 MediaCodec → 电脑 ffmpeg 解码,流畅低延迟 | | **MJPEG 兼容** | 无硬编设备可回退软件 JPEG | | **系统虚拟摄像头** | 不依赖 OBS,腾讯会议 / OBS / 直播姬可直接选 **CameraPhone Virtual Camera** | | **双端设置同步** | 分辨率、帧率、画质、编码器、码率、前后摄像头等 | | **省电** | 可关手机本地预览;推流仍继续 | > 仅传输视频,不含麦克风。 ## 快速开始 ### 1. 手机(Android 8.0+) 安装 [CameraPhone-v1.3.4-release.apk](android/app/build/outputs/apk/release/CameraPhone-v1.3.4-release.apk)(或自行构建),允许相机权限,点 **启动服务**。 ### 2. 电脑(Windows 10/11) 将以下文件放在**同一目录**: - `CameraPhoneDesktop.exe` - `CameraPhoneVCam.dll` **首次请右键「以管理员身份运行」**,以便注册虚拟摄像头(OBS 才能枚举到)。 然后选择 USB 或无线,点 **一键连接**。 ### 3. 在软件中选用 在腾讯会议 / OBS / 直播姬中选择摄像头:**CameraPhone Virtual Camera**。 OBS:来源 → 添加 → **视频采集设备** → 选择上述设备。 ## 构建 ### Android APK ```bat scripts\build_android.bat :: 或 Android Studio 打开 android/ ``` 产物:`android/app/build/outputs/apk/release/CameraPhone-v*-release.apk` ### 桌面 EXE ```bat cd desktop pip install -r requirements.txt build_exe.bat ``` 产物:`desktop/dist/CameraPhoneDesktop.exe` + `CameraPhoneVCam.dll` ### 虚拟摄像头 DLL ```bat native\vcam\build_vcam.bat ``` 需要 MinGW-w64 `g++`(见脚本内路径,可按本机修改)。 ## 架构 ``` Android CameraX ──H.264/MJPEG──► StreamServer (TCP :8888) │ USB adb forward / Wi-Fi │ Desktop StreamReceiver ──► 预览 UI + NativeVirtualCamera (共享内存) │ CameraPhoneVCam.dll (DirectShow) │ 会议 / OBS / 直播软件 ``` 协议:[docs/PROTOCOL.md](docs/PROTOCOL.md)(CPHS 二进制帧,大端)。 ## 目录结构 | 路径 | 说明 | |------|------| | `android/` | Kotlin + Compose 手机 App | | `desktop/` | 电脑端 Python / CustomTkinter | | `native/vcam/` | DirectShow 虚拟摄像头 C++ | | `docs/` | 连接指南、协议 | | `scripts/` | 构建脚本与自检 | ## 安全说明 - TCP 推流**无鉴权、无加密**,请只在**可信局域网**使用无线;能用 USB 优先 USB(仅本机 `127.0.0.1`)。 - 共享内存为本机会话内进程可访问(虚拟摄像头所需)。 - 请勿在公网或不受信任网络上开放手机服务端口。 ## 常见问题 **OBS 里没有摄像头?** 退出 OBS → 管理员运行一次 `CameraPhoneDesktop.exe` → 再打开 OBS。 **USB 连不上?** 确认已开 USB 调试并授权;电脑需有 adb。软件会自动处理端口占用。 **无线很卡?** 改用 H.264 + USB;无线建议 720p、画质 60–70;手机插电、关闭省电模式。 **画面与会议预览相反?** 会议软件本地预览常做水平镜像。电脑端默认已勾选「水平镜像(对齐会议本地预览)」。 ## License [MIT](LICENSE)