Skip to main content
이 페이지는 SDK 2.0.0에 해당합니다. Linux와 Windows는 facebetter 네임스페이스의 동일한 C++ API를 공유합니다(facebetter/*.h).
이 가이드는 Linux에서 Facebetter C++ 데스크톱 데모를 빌드합니다. 데모는 GLFW + Dear ImGui + OpenGL 3을 사용합니다. 왼쪽은 실시간 미리보기, 오른쪽은 뷰티 컨트롤입니다.

요구 사항

Ubuntu / Debian

Fedora / RHEL

1단계: 저장소 클론

2단계: SDK 파일 배치

Linux SDK를 demo/cpp/sdk/ 아래에 둡니다.
데스크톱에서 EngineConfig::resource_path는 디렉터리가 아니라 resource.fbd 파일을 가리켜야 합니다. 예: demo/cpp/sdk/resource/resource.fbd.
SDK 패키지는 다운로드 페이지와 대시보드에 있습니다.
미리 빌드된 패키지 대신 소스에서 SDK를 빌드하려면:
출력은 build/linux/release에 설치됩니다. 위와 같이 include/, lib/libfacebetter.so, resource.fbddemo/cpp/sdk/로 복사할 수 있습니다.

3단계: 라이선스 설정

실행 전에 app_id / app_key(온라인 v2 인증) 또는 license_token을 설정하세요. license_token이 비어 있지 않으면 우선합니다(라이선스 토큰 문자열, {token} JSON, 또는 오프라인 .lic 내용). 자세한 내용: 인증 및 라이선스.

4단계: 데모 빌드

CMake는 보통 resource/resource.fbd(및 있는 경우 demo.png)를 build/resource/로 복사합니다.

5단계: 미리보기 이미지 준비 (선택)

6단계: 실행

창에는 실시간 미리보기와 컨트롤 패널(피부, 26개 페이스 리셰이프, 7개 바디 리셰이프, 메이크업, 필터, 스티커, 가상 배경)이 표시됩니다. Reset All을 클릭하면 강도가 0이 됩니다.

문제 해결

Q: libfacebetter.so: cannot open shared object file
A: LD_LIBRARY_PATH=../sdk/lib ./facebetter_demo를 사용하거나, .so를 바이너리 옆으로 복사하거나, ldconfig로 경로를 추가하세요.
Q: 엔진 생성이 nullptr을 반환 / 라이선스 실패
A: resource_pathresource.fbd로 지정하고, license_token 또는 유효한 app_id + app_key를 설정하세요. 인증 및 라이선스를 참고하세요.
Q: CMake가 OpenGL을 찾지 못함
A: libgl1-mesa-dev(Ubuntu) 또는 mesa-libGL-devel(Fedora)을 설치한 뒤 CMake를 다시 실행하세요.
Q: GLFW: X11: Display variable not set
A: 그래픽 세션에서 실행하거나 DISPLAY(X11) / WAYLAND_DISPLAY(Wayland)를 설정하세요.

다음 단계

뷰티 효과 적용

엔진을 만들고 효과를 설정한 뒤 프레임을 처리합니다.

API 레퍼런스

전체 C++ API(Windows와 동일)와 Linux 참고 사항입니다.