서드파티 연동 - Facebetter Docs

SDK 2.0.0. Windows · 서드파티 연동과 동일한 C++ API 및 연동 모델입니다. 데스크톱 벤더는 보통 모바일 스타일 OpenGL 텍스처 콜백이 아니라 I420 / YUV 버퍼를 제공합니다. 이 페이지는 Linux 전용 차이를 다룹니다. 공유 헬퍼와 TRTC / Agora / LiveKit 배선은 Windows 페이지에 있습니다. Linux 패키지에 맞게 헤더와 라이브러리 경로를 바꾸세요.

Third-party SDK (preprocess callback)
  I420 planes
       ↓
BeautyEffectEngine
  CreateWithI420 → ProcessImage → write back

Linux 차이

항목	참고
라이브러리	`libfacebetter.so` + `facebetter/*.h`
링크	뷰티 효과 적용을 참고하세요. 런타임에 `LD_LIBRARY_PATH` / rpath를 확인하세요
GL	GL 컨텍스트가 현재인 스레드에서 엔진을 만들고 처리하세요. 입력과 출력 텍스처는 그 컨텍스트에 속해야 합니다. CPU 프레임에는 호출 측 GL 컨텍스트가 필요 없습니다. 설정에 컨텍스트 플래그는 없습니다.
`resource_path`	`resource.fbd` 파일을 가리켜야 합니다
대시보드 바인딩	패키지 / 실행 파일 / 프로세스 이름 — 구독

엔진 생성:

EngineConfig cfg;
cfg.app_id = "your_app_id";
cfg.app_key = "your_app_key";
cfg.resource_path = "/opt/yourapp/resource/resource.fbd";
auto engine = BeautyEffectEngine::Create(cfg);

공유 I420 헬퍼와 벤더 훅: 전체 복사는 Windows · 서드파티 연동 (ProcessI420InPlace, TRTC Buffer, Agora IVideoFrameObserver, LiveKit 커스텀 비디오 소스).

벤더 스냅샷

벤더	Linux 참고
TRTC	PC는 Buffer / I420만 — Android Texture 경로를 사용하지 마세요
Agora	C++ `registerVideoFrameObserver`, ReadWrite + in-place I420
LiveKit	커스텀 비디오 소스; 헤드리스 호스트의 캡처 + GL/소프트웨어 경로를 확인하세요

문제 해결

증상	확인
`.so` 없음	`LD_LIBRARY_PATH`, rpath, 아키텍처 일치
`Create` 실패	`.fbd` 경로, 인증, 헤드리스 GL / OSMesa
그 외	Windows 문제 해결과 동일

관련 문서