OBS Mac 虚拟摄像头插件使用教程
项目地址: https://gitcode.com/gh_mirrors/ob/obs-mac-virtualcam 项目概述
OBS Mac 虚拟摄像头插件是一个为 macOS 系统设计的虚拟摄像头工具，它能够将 OBS Studio 的视频输出转换为虚拟摄像头设备，让用户可以在 Zoom、Hangouts、Jitsi 等视频会议应用中使用 OBS 制作的精美视频流。
项目目录结构
项目的目录结构清晰地分为几个主要部分：
obs-mac-virtualcam/
├── assets/ # 资源文件目录
│ └── test-card.pcvd # 测试卡资源文件
├── cmake/ # CMake构建配置
│ └── Modules/
│ ├── FindLibobs.cmake
│ └── ObsPluginHelpers.cmake
├── src/ # 源代码目录
│ ├── common/ # 公共代码
│ │ └── MachProtocol.h
│ ├── dal-plugin/ # DAL插件核心代码
│ └── obs-plugin/ # OBS插件代码
├── installer/ # 安装包配置
├── ci/ # 持续集成配置
├── CMakeLists.txt # 主构建配置文件
├── README.md # 项目说明文档
└── CONTRIBUTING.md # 贡献指南
核心组件说明
DAL插件 (CoreMediaIO Device Abstraction Layer)
位于 src/dal-plugin/ 目录，这是虚拟摄像头的核心实现：
- OBSDALPlugIn.mm - 插件主入口点
- OBSDALDevice.mm - 虚拟设备实现
- OBSDALStream.mm - 视频流处理
- OBSDALMachClient.mm - 进程间通信客户端
OBS插件
位于 src/obs-plugin/ 目录，负责与 OBS Studio 集成：
- plugin-main.mm - OBS插件主入口
- MachServer.mm - 进程间通信服务端
安装和使用
安装步骤
- 下载安装包：从发布页面下载最新的
.pkg安装文件 - 运行安装程序：双击安装包并按照提示完成安装
- 重启应用：安装后需要重启 OBS Studio 和相关视频应用
启动虚拟摄像头
在 OBS Studio 中：
- 进入
工具菜单 - 选择
启动虚拟摄像头 - 在视频会议应用中选择 "OBS Virtual Camera" 作为摄像头源
配置文件说明
项目安装后会创建以下配置文件：
- OBS插件配置：
/Library/Application Support/obs-studio/plugins/obs-mac-virtualcam/ - DAL插件配置：
/Library/CoreMediaIO/Plug-Ins/DAL/obs-mac-virtualcam.plugin
常见问题解决
应用兼容性问题
某些应用（如 Slack、Webex、Skype）默认禁用虚拟摄像头。可以通过以下方式解决：
- 更新应用到最新版本
- 在应用启动前先启动虚拟摄像头
- 对于某些应用可能需要重新签名
FaceTime 和 Photo Booth
- Photo Booth：复制应用并重命名后可正常工作
- FaceTime：目前没有已知的解决方案
开发与构建
构建要求
- CMake 3.17 或更高版本
- Xcode 开发工具
- OBS Studio 开发库
构建步骤
# 克隆项目
git clone https://gitcode.com/gh_mirrors/ob/obs-mac-virtualcam
# 创建构建目录
mkdir build && cd build
# 配置项目
cmake ..
# 编译
make
注意事项
- OBS 26.1+ 用户：从 OBS Studio 26.1 开始，虚拟摄像头功能已内置，无需安装此插件
- 安装前卸载：升级到 OBS 26.1 前务必先卸载此插件
- 重启要求：安装新版本后可能需要重启电脑
技术支持
- 官方讨论：OBS Studio Discord 的
#plugins-and-tools频道 - 问题报告：在项目 issue 页面搜索现有问题后再提交新问题
- 日志收集：遇到问题时请提供终端日志和 Console.app 日志
项目状态
此项目现已归档，虚拟摄像头功能已被正式集成到 OBS Studio 26.1+ 版本中。当前代码库主要用于历史参考和学习目的。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
