Skip to main content
SDK 2.0.0. 인증 세부 사항: 인증 및 라이선스.

반환 값

대부분의 setter는 int를 반환합니다. BeautyEffectEngine::Create()std::shared_ptr를 반환하며, 실패는 nullptr입니다. ProcessImage는 실패 시 nullptr을 반환할 수 있습니다.

엔진 이벤트

Createon_engine_event를 등록하세요. 코드: 실패 시 message 문자열에 추가 정보가 있습니다.

일반적인 실패

1. Createnullptr을 반환함

일반적인 원인:
  • resource_path가 디렉터리이거나, 없거나, resource.fbd 파일이 아님
  • 유효하지 않거나 비활성인 app_id + app_key, 또는 잘못된 license_token
  • facebetter.dll이 없거나 facebetter.lib와 불일치
  • 온라인 인증이 /facebetter/v2/auth에 도달할 수 없음
Create 전에 로그를 켜세요.

2. facebetter.dll을 찾을 수 없음

DLL이 로더 경로에 없으면 Windows가 대화 상자를 표시합니다.
또는 재빌드해 CMake가 실행 파일 옆으로 복사하게 하세요.

3. ProcessImagenullptr을 반환함

입력 프레임, 엔진 포인터, 로그를 확인하세요(setter의 -7 처리 / -8 메모리 부족).

4. 효과가 변하지 않아 보임

2.0은 SetBeautyTypeEnabled를 사용하지 않습니다. 강도 0이면 효과가 꺼집니다. 리셰이프 / 메이크업에도 감지된 얼굴이 필요합니다.

5. OpenGL / 디스플레이

드라이버가 오래되었거나, VM이거나, GPU 없는 Remote Desktop에서는 GLFW 또는 gladLoadGLLoader가 실패할 수 있습니다.
앱이 이미 GL 컨텍스트를 소유하면 EngineConfig::external_context = true를 설정하고 해당 스레드에서 ProcessImage를 호출하세요.

디버그 로그

절대 file_name을 전달하지 않으면 파일은 현재 작업 디렉터리 기준으로 작성됩니다.