이 페이지는 SDK 2.0.0에 해당합니다. Windows와 Linux는
facebetter 네임스페이스의 동일한 C++ API를 공유합니다(facebetter/*.h).요구 사항
1단계: 저장소 클론
2단계: SDK 파일 배치
Windows SDK 패키지를 압축 해제한 뒤 파일을demo/cpp/sdk/ 아래에 둡니다.
3단계: 라이선스 설정
실행 전에 데모에서app_id / app_key(온라인 v2 인증) 또는 license_token을 설정하세요. license_token이 비어 있지 않으면 우선합니다(라이선스 토큰 문자열, {token} JSON, 또는 오프라인 .lic 내용). 자세한 내용: 인증 및 라이선스.
4단계: 빌드
Developer Command Prompt for VS(또는 MSVC 환경이 로드된 PowerShell)를 엽니다.facebetter.dll을build/의 실행 파일 옆으로 복사resource/resource.fbd를build/resource/resource.fbd로 복사demo.png가 있으면build/resource/demo.png로 복사
5단계: 미리보기 이미지 준비 (선택)
얼굴 사진을demo.png로 이름 지어 demo/cpp/에 둡니다.
6단계: 실행
- 왼쪽 패널 — 실시간 뷰티 처리 미리보기
- 오른쪽 패널 — Beauty Control Panel:
- 기본 뷰티: 스무딩 / 미백 / 혈색 / 샤프닝
- 페이스 리셰이프: 26개 리셰이프 파라미터(범위
[-1.0, 1.0]) - 바디 리셰이프: 7개 파라미터(범위
[0.0, 1.0],resource_body.fbd필요) - 메이크업: 립스틱 / 블러셔 / 아이섀도 / 아이라이너 / 눈썹 / 속눈썹 / 렌즈 / 컨투어
- 필터 / 스티커 / 가상 배경
문제 해결
Q: 시작 시 “facebetter.dll was not found”A:
demo/cpp/sdk/lib/facebetter.dll이 있는지 확인한 뒤 cmake --build build를 다시 실행해 CMake가 DLL을 실행 파일 옆으로 복사하게 하세요.
Q: 엔진 생성이 nullptr을 반환 / 라이선스 실패A:
resource_path를 resource.fbd로 지정하고, license_token 또는 유효한 app_id + app_key를 설정하세요. 인증 및 라이선스를 참고하세요.
Q: CMake가 Ninja를 찾지 못함A:
winget install Ninja-build.Ninja를 실행하거나, -G "Visual Studio 17 2022"와 --config Release를 사용하세요.
다음 단계
뷰티 효과 적용
엔진을 만들고 효과를 설정한 뒤 프레임을 처리합니다.
API 레퍼런스
Windows와 Linux용 전체 C++ API입니다.

