Skip to main content
SDK 2.0.0. Windows와 동일한 C++ API(facebetter 네임스페이스). 열거형: 파라미터 열거형. 인증: 인증 및 라이선스.
Linux에서 Facebetter는 libfacebetter.sofacebetter/*.h입니다. 이 가이드는 C++ 데스크톱 데모(demo/cpp)를 따릅니다. SDK 자체를 컴파일하려면 ./scripts/build_linux.sh 또는 build/linux에서 CMake를 사용하세요.

헤더 포함

CMake 링크

런타임에 LD_LIBRARY_PATH를 설정하거나, libfacebetter.so를 바이너리 옆으로 복사하거나, ldconfig로 설치하세요.

연동 흐름

타입 활성화 단계는 없습니다. 강도 0이면 효과가 꺼집니다.

1. 로그 설정 (선택)

Create 전에 호출하세요.

2. 엔진 만들기

데스크톱은 resource_pathresource.fbd 파일로 설정해야 합니다. 인증 우선순위: 비어 있지 않은 license_token(토큰 / {token} JSON / .lic)이 우선합니다. 그렇지 않으면 app_id + app_key 온라인 v2입니다.
resource_path는 폴더가 아니라 resource.fbd 파일이어야 합니다. 프로덕션에서는 절대 경로를 권장합니다.

3. 뷰티 파라미터 설정

피부 / 메이크업 / 바디 리셰이프 [0.0, 1.0]. 페이스 리셰이프 [-1.0, 1.0]. 바디 리셰이프에는 resource_body.fbd가 필요합니다. 파라미터 열거형, 선택 리소스 팩.
아이섀도, 아이라이너, 눈썹, 속눈썹, 렌즈도 같은 패턴입니다.

4. 필터, 스티커, 가상 배경

경로 또는 바이트를 전달하세요.

5. 콜백과 통계


6. 프레임 처리

ImageFrame::type을 설정하세요.
사진:
출력 형식은 가능하면 입력을 따릅니다. output->Convert(Format::BGRA)로 변환하세요.

OpenGL 미리보기

앱에 이미 현재 GL 컨텍스트가 있으면 cfg.external_context = true를 설정하고 해당 스레드에서 ProcessImage를 호출하세요.

7. 최소 루프

engine.reset()으로 해제하세요. 엔진은 싱글톤이 아닙니다. TRTC / Agora / LiveKit: 서드파티 연동.

관련 문서

서드파티 연동

TRTC / Agora / LiveKit

API 레퍼런스

C++ 메서드와 Linux 참고 사항

오류 처리

반환 코드와 .so / DISPLAY 문제

권장 사항

성능과 rpath