facebetter.lib + facebetter.dll). 이 가이드는 C++ 데스크톱 데모(demo/cpp)를 따릅니다.
헤더 포함
연동 흐름
0보다 크게 설정하면 해당 효과가 켜집니다.
1. 로그 설정 (선택)
초기화 로그를 캡처하려면Create 전에 호출하세요.
Trace / Debug / Info / Warn / Error / Critical.
2. 엔진 만들기
데스크톱은resource_path를 resource.fbd 파일로 설정해야 합니다.
인증 우선순위: license_token이 비어 있지 않으면 SDK는 해당 토큰(라이선스 토큰 문자열, {token} JSON, 또는 오프라인 .lic)을 검증하며 app_id / app_key로 네트워크를 호출하지 않습니다. 그렇지 않으면 app_id + app_key로 /facebetter/v2/auth를 사용합니다.
3. 뷰티 파라미터 설정
피부 / 메이크업 / 바디 리셰이프 강도는[0.0, 1.0]입니다. 0은 꺼짐입니다. 페이스 리셰이프는 **[-1.0, 1.0]**입니다. 전체 열거형 목록: 파라미터 열거형.
피부
페이스 리셰이프
바디 리셰이프
범위[0.0, 1.0]. 0은 꺼짐. resource_body.fbd를 resource.fbd와 같은 디렉터리에 두거나 AddResourcePack을 호출하세요. 파라미터 열거형과 선택 리소스 팩.
메이크업
강도, 형태, 색상은 별도 setter입니다. 립스틱은 색상만, 렌즈는 색상만, 컨투어는 스타일만입니다.SetEyeLiner / SetEyebrow / SetEyelash / SetPupil과 해당하는 Style / Color).
4. 필터, 스티커, 가상 배경
파일 경로 또는 인코딩된 바이트를 전달하세요.ProcessImage 호출(활성 GL 스레드)에서 생성됩니다. 3D 스티커는 선택 리소스 팩을 참고하세요.
5. 콜백과 통계
6. 프레임 처리
ImageFrame::type을 FrameType::Video(실시간, 기본값) 또는 FrameType::Image(단일 사진)로 설정하세요.
OpenGL에 업로드 (미리보기)
facebetter.dll을 실행 파일 옆에 두세요(데모 CMake가 빌드 후 복사합니다).
7. 최소 루프
shared_ptr를 버리세요(engine.reset()). BeautyEffectEngine은 싱글톤이 아닙니다.
TRTC / Agora / LiveKit: 서드파티 연동.
관련 문서
서드파티 연동
TRTC / Agora / LiveKit
API 레퍼런스
모든 C++ 메서드와 유형
오류 처리
반환 코드와 Windows DLL 문제
권장 사항
성능과 스레딩

