프로젝트 소개

obs-studio-node는 OBS Studio의 내부 라이브러리인 libobs에 대한 Node.js 바인딩을 제공하여, Node 또는 Electron 런타임에서 캡처, 장면 구성, 스트리밍 기능을 구동할 수 있게 한다. README에 따르면 현재 Windows와 macOS만 지원된다. 빌드에는 Git, Node.js, Yarn, CMake가 필요하며, Windows에서는 Visual Studio 2019/2022와 Windows SDK도 필요하고, macOS 빌드에는 Xcode가 필요하다. 일반적인 빌드는 yarn install을 실행하고, git 서브모듈을 초기화하고, 선택한 CMAKE_INSTALL_PREFIX로 CMake를 구성하고, install 타깃을 빌드한다. 기본적으로 미리 빌드된 libobs가 다운로드되며, 사용자 정의 OBS 빌드를 제공할 수 있지만 ENABLE_SCRIPTING과 ENABLE_UI를 비활성화해야 하고 QTDIR은 설정하지 않아야 한다. OSN_LIBOBS_DEPENDENCY_PREFIX_PATH 옵션은 이전 로컬 libobs 개발 패키지를 지원한다. JavaScript 표면은 js/module.ts에서 tsc를 통해 js/module.js와 js/module.d.ts로 생성되며, 이들은 npm 패키지에 포함되어 배포되므로 커밋된다. yarn build:javascript가 이를 재생성하고 CI는 오래된 출력이 있는지 확인한다. 정적 분석 타깃에는 cppcheck와 Clang 분석기 워크플로가 포함된다. 테스트는 Mocha, electron-mocha, Chai를 사용하여 TypeScript로 작성되며, 빌드된 모듈과 ELECTRON_PATH 환경 변수가 필요하다. 일부 테스트는 Twitch와 상호작용하며 SLOBS_BE_STREAMKEY를 대체 스트림 키로 사용할 수 있다. 테스트는 전체 실행, describe 이름으로 필터링, 또는 제공된 VS Code 실행 구성을 통한 디버깅이 가능하다.