FAQ

​

Integration Issues

​

Q: What to do if engine creation fails?

• Confirm that appId and appKey are correct
• Check if network connection is normal
• View log output for detailed error information
• Confirm if SDK version is latest
• Check if Framework is properly linked

​

Q: Can’t find header files or classes during compilation?

• Confirm that Facebetter.framework has been properly added to the project
• Check if Framework’s “Embed & Sign” setting is correct
• Confirm import statement: #import <Facebetter/FBBeautyEffectEngine.h>
• Try Clean Build Folder and rebuild

​

Q: Link errors at runtime?

• Confirm if device architecture is supported (arm64, armv7)
• Check if Framework file is complete
• Confirm Framework’s deployment target setting is correct
• Check for other Framework conflicts

​

Functionality Issues

​

Q: Beauty effects are not obvious?

• Increase beauty parameter values (range 0.0-1.0)
• Ensure corresponding beauty types are enabled
• Check if image quality is clear enough
• Confirm if face detection is working normally

​

Q: Beauty effects are excessive or distorted?

• Reduce beauty parameter values
• Check if parameter combinations are reasonable
• Avoid enabling too many beauty types simultaneously
• Adjust parameters based on image quality

​

Q: Virtual background not working?

• Confirm FBBeautyType_VirtualBackground is enabled
• Check if background image path is correct
• Confirm if image format is supported (PNG, JPG)
• Check if image file exists and is readable

​

Performance Issues

​

Q: What to do if processing is slow?

• Use FBFrameTypeVideo for real-time processing
• Reduce image resolution
• Reduce number of simultaneously enabled beauty types
• Avoid image processing on main thread
• Use multi-threading for image processing

​

Q: High memory usage?

• Release FBImageFrame and FBImageBuffer objects timely
• Avoid frequent creation and destruction of engine instances
• Reuse FBImageFrame objects
• Use object pool pattern to manage image buffers

​

Q: App crashes or freezes?

• Check if image processing is done on main thread
• Confirm resource release is complete
• View exception information in logs
• Check if parameter values are within valid range
• Use Instruments tool to analyze memory and performance

​

Image Processing Issues

​

Q: How to handle different image formats?

• toRGBA - Convert to RGBA format
• toI420 - Convert to I420 format
• toNV12 - Convert to NV12 format
• toBGRA - Convert to BGRA format

​

Q: Camera preview image processing?

1. Get CVPixelBuffer from AVCaptureSession
2. Use createWithData to create FBImageFrame
3. Call processImage to process
4. Convert to target format for display

​

Q: Image rotation issues?

• Use FBImageFrame’s rotate method to rotate images
• Supports 0°, 90°, 180°, 270° rotation
• Rotation operation modifies original image data

​

Permission Issues

​

Q: Camera permission issues?

<key>NSCameraUsageDescription</key>
<string>Camera permission required for beauty photography</string>

​

Q: Photo library permission issues?

<key>NSPhotoLibraryUsageDescription</key>
<string>Photo library permission required to select photos for beauty</string>

​

Debugging Issues

​

Q: How to enable debug logging?

FBLogConfig *logConfig = [[FBLogConfig alloc] init];
logConfig.consoleEnabled = YES;
logConfig.fileEnabled = YES;
logConfig.level = FBLogLevel_Debug;
[FBBeautyEffectEngine setLogConfig:logConfig];

​

Q: How to get detailed error information?

• Enable DEBUG level logging
• Check API return values (0 indicates success)
• View file log output
• Use Xcode’s Console to view logs

​

Version Compatibility

​

Q: Which iOS versions are supported?

​

Q: Which device architectures are supported?

• arm64 (64-bit devices)
• armv7 (32-bit devices, iOS 10.0+)

​

Q: How to upgrade SDK version?

1. Download new version SDK
2. Replace old Framework file
3. Clean project cache
4. Rebuild project
5. Test if functionality works normally

​

ARC Related Issues

​

Q: How to handle memory management?

• Set objects to nil timely
• Avoid circular references
• Use weak references to avoid strong reference cycles

​

Q: How to handle CVPixelBuffer?

• Use CVPixelBufferRetain and CVPixelBufferRelease for management
• Or use __bridge_transfer and __bridge_retained for conversion

​

Multi-threading Issues

​

Q: How to process images in background thread?

• Use dispatch_async to process in background queue
• Avoid image processing on main thread
• Use dispatch_async(dispatch_get_main_queue()) to update UI

​

Q: How to handle concurrent access?

• Use @synchronized to protect shared resources
• Use serial queue for image processing
• Avoid multi-threaded access to engine instance

​

Deployment Issues

​

Q: App Store review rejected?

• Missing necessary permission descriptions
• Using private APIs
• Memory leak issues
• Crash issues

​

Q: How to optimize app size?

• Remove unused architectures (like armv7)
• Compress resource files
• Use App Thinning
• Remove unused Framework parts