Skip to main content
SDK 2.0.0. 헤더는 facebetter/*.h에 있습니다. 메이크업 / 리셰이프 / 스타일 열거형: 파라미터 열거형. 인증: 인증 및 라이선스.
Windows에서 Facebetter는 C++ 라이브러리입니다(facebetter.lib + facebetter.dll). 이 가이드는 C++ 데스크톱 데모(demo/cpp)를 따릅니다.

헤더 포함

연동 흐름

타입 활성화 단계는 없습니다. 강도를 0보다 크게 설정하면 해당 효과가 켜집니다.

1. 로그 설정 (선택)

초기화 로그를 캡처하려면 Create 전에 호출하세요.
레벨(낮음 → 높음): Trace / Debug / Info / Warn / Error / Critical.

2. 엔진 만들기

데스크톱은 resource_pathresource.fbd 파일로 설정해야 합니다. 인증 우선순위: license_token이 비어 있지 않으면 SDK는 해당 토큰(라이선스 토큰 문자열, {token} JSON, 또는 오프라인 .lic)을 검증하며 app_id / app_key로 네트워크를 호출하지 않습니다. 그렇지 않으면 app_id + app_key/facebetter/v2/auth를 사용합니다.
resource_path는 폴더가 아니라 resource.fbd 파일이어야 합니다. 상대 경로는 프로세스 작업 디렉터리에서 해석됩니다. 프로덕션에서는 절대 경로를 권장합니다.

3. 뷰티 파라미터 설정

피부 / 메이크업 / 바디 리셰이프 강도는 [0.0, 1.0]입니다. 0은 꺼짐입니다. 페이스 리셰이프는 **[-1.0, 1.0]**입니다. 전체 열거형 목록: 파라미터 열거형.

피부

페이스 리셰이프

바디 리셰이프

범위 [0.0, 1.0]. 0은 꺼짐. resource_body.fbdresource.fbd와 같은 디렉터리에 두거나 AddResourcePack을 호출하세요. 파라미터 열거형선택 리소스 팩.

메이크업

강도, 형태, 색상은 별도 setter입니다. 립스틱은 색상만, 렌즈는 색상만, 컨투어는 스타일만입니다.
아이라이너, 눈썹, 속눈썹, 렌즈도 같은 패턴입니다(SetEyeLiner / SetEyebrow / SetEyelash / SetPupil과 해당하는 Style / Color).

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

파일 경로 또는 인코딩된 바이트를 전달하세요.
LUT / 스티커 텍스처는 다음 ProcessImage 호출(활성 GL 스레드)에서 생성됩니다. 3D 스티커는 선택 리소스 팩을 참고하세요.

5. 콜백과 통계


6. 프레임 처리

ImageFrame::typeFrameType::Video(실시간, 기본값) 또는 FrameType::Image(단일 사진)로 설정하세요.
파일 (사진 모드):
엔진은 가능하면 출력 형식을 입력과 맞춥니다(RGBA 입력 → RGBA 출력, I420 입력 → I420 출력). 다른 레이아웃이 필요하면 Convert(Format::BGRA)를 사용하세요.

OpenGL에 업로드 (미리보기)

facebetter.dll을 실행 파일 옆에 두세요(데모 CMake가 빌드 후 복사합니다).

7. 최소 루프

끝나면 shared_ptr를 버리세요(engine.reset()). BeautyEffectEngine은 싱글톤이 아닙니다. TRTC / Agora / LiveKit: 서드파티 연동.

관련 문서

서드파티 연동

TRTC / Agora / LiveKit

API 레퍼런스

모든 C++ 메서드와 유형

오류 처리

반환 코드와 Windows DLL 문제

권장 사항

성능과 스레딩