SDK 2.0.0. Auth details: Auth & License.
Return values
Most setters returnint:
BeautyEffectEngine::Create() returns std::shared_ptr; failure is nullptr. ProcessImage may return nullptr on failure.
Engine events
Registeron_engine_event after Create. Codes:
The
message string has extra detail on failures.
Common failures
1. Create returns nullptr
Typical causes:
resource_pathis a directory, missing, or not theresource.fbdfile- Invalid / inactive
app_id+app_key, or badlicense_token facebetter.dllmissing or mismatched withfacebetter.lib- Online auth cannot reach
/facebetter/v2/auth
Create:
2. facebetter.dll not found
Windows shows a dialog if the DLL is not on the loader path.
3. ProcessImage returns nullptr
Check the input frame, engine pointer, and logs (-7 process / -8 OOM on setters).
4. Effects look unchanged
2.0 does not useSetBeautyTypeEnabled. Effects are off at intensity 0. Reshape / makeup also need a detected face.
5. OpenGL / display
GLFW orgladLoadGLLoader can fail on outdated drivers, VMs, or Remote Desktop without GPU.
EngineConfig::external_context = true and call ProcessImage on that thread.
Debug logs
file_name.
