iOS


/// Create TEBeautyKit object
/// - Parameters:
/// - effectMode: EFFECT_MODE_NORMAL (high-performance mode) EFFECT_MODE_PRO (default mode)
/// When high-performance mode is enabled, the beauty effect uses less system CPU/GPU resources, which can reduce phone heating and lag, making it more suitable for long-term use on low-end devices.
/// Note: After enabling high-performance mode, the following beauty features will be unavailable:
/// 1. Eyes: Eye width, eye height, remove eye bags
/// 2. Eyebrows: Angle, distance, height, length, thickness, arch
/// 3. Mouth: Smile lips
/// 4. Face: Face slimming (natural, goddess, handsome), jawline reduction, wrinkle removal, nasolabial folds removal. It is recommended to use 'Face Shape' to achieve a comprehensive effect of larger eyes and face slimming
/// - onInitListener: Callback
+ (void)createXMagic:(EffectMode)effectMode onInitListener:(OnInitListener _Nullable)onInitListener;

/// Beauty Filter Authentication
+ (void)setTELicense:(NSString *)url key:(NSString *)key completion:(callback _Nullable )completion;

/// Set beauty mode target
- (void)setXMagicApi:(XMagic *_Nullable)xmagicApi;

/// Beauty mute
- (void)setMute:(BOOL)isMute;


/// Set a feature on or off
/// @param featureName Values can be found in XmagicConstant.FeatureName
/// @param enable true for on, false for off
- (void)setFeatureEnableDisable:(NSString *_Nullable)featureName enable:(BOOL)enable;


/// Set frame synchronization mode
/// @isSync Whether it is synchronous
/// @syncFrameCount Number of frames to synchronize. -1 means unlimited. This parameter is meaningless if isSync is false
- (void)setSyncMode:(BOOL)isSync syncFrameCount:(int)syncFrameCount;

/// Process image beautification
- (UIImage *_Nullable)processUIImage:(UIImage *_Nullable)inputImage
                 imageWidth:(int)imageWidth
                imageHeight:(int)imageHeight
                  needReset:(bool)needReset;


/// Handle texture
/// - Parameters:
///   - textureId: Texture ID
///   - textureWidth: Texture width
///   - textureHeight: Texture height
///   - origin: Enum value, when set to YtLightImageOriginBottomLeft, the image is flipped vertically
///   - orientation: Enum value: image rotation angle
- (YTProcessOutput *_Nullable)processTexture:(int)textureId
         textureWidth:(int)textureWidth
        textureHeight:(int)textureHeight
           withOrigin:(YtLightImageOrigin)origin
      withOrientation:(YtLightDeviceCameraOrientation)orientation;
      


/// Handling CVPixelBufferRef
/// - Parameters:
/// - pixelData: Image data
/// - pixelDataWidth: Image width
/// - pixelDataHeight: Image height
/// - origin: Enum value, when set to YtLightImageOriginBottomLeft, the image is flipped vertically
/// - orientation: Enum value: Image rotation angle
- (YTProcessOutput * _Nullable)processPixelData:(CVPixelBufferRef _Nullable )pixelData
                      pixelDataWidth:(int)pixelDataWidth
                     pixelDataHeight:(int)pixelDataHeight
                          withOrigin:(YtLightImageOrigin)origin
                     withOrientation:(YtLightDeviceCameraOrientation)orientation;

/// Set beauty
- (void)setEffect:(TESDKParam *_Nullable)sdkParam;

///  Set beauty
- (void)setEffectList:(NSArray<TESDKParam *>*_Nullable)sdkParamList;

/// Is the beauty enhancement mode turned on
- (BOOL)isEnableEnhancedMode;

/// Enable beauty enhancement mode
- (void)enableEnhancedMode:(BOOL)enable;

/// Recover
- (void)onResume;

/// Pause
- (void)onPause;

/// Destroy
- (void)onDestroy;

//Get the current texture image
- (void)exportCurrentTexture:(void (^_Nullable)(UIImage * _Nullable image))callback;

/// Set log
- (void)setLogLevel:(YtSDKLoggerLevel)level;

/// Set AIDataListener
- (void)setAIDataListener:(id<TEBeautyKitAIDataListener> _Nullable)listener;

/// Set TipsListener
- (void)setTipsListener:(id<TEBeautyKitTipsListener> _Nullable)listener;

/// Save the beauty settings data
- (void)saveEffectParam:(TESDKParam *_Nonnull)sdkParam;

/// Delete a saved beauty data
- (void)deleteEffectParam:(TESDKParam *_Nonnull)sdkParam;

/// Clear saved beauty data
- (void)clearEffectParam;

/// Retrieve saved beauty data
- (NSMutableArray<TESDKParam *> *_Nonnull)getInUseSDKParamList;


/// Export the beauty data currently in use
/// return json string
- (NSString *_Nullable)exportInUseSDKParam;


/// Set beauty data
/// - Parameter params: JSON string
/// If you also want to set the panel UI, you only need to call TEPanelView's setExportParamList
- (void)setExportedSDKParam:(NSString *_Nonnull)params;

/// Enable beauty mode?
- (void)enableBeauty:(BOOL)enable;


/// SDK event listener interface
/// @param listener Event listener callback, mainly divided into AI events, Tips reminder events, and Asset events
- (void)registerSDKEventListener:(id<YTSDKEventListener> _Nullable)listener;

/// Register callback cleanup interface
- (void)clearListeners;

///The colour of the following properties can be modified externally
/// Beauty panel background colour
@property (nonatomic, strong) UIColor *panelBackgroundColor;
/// Divider colour
@property (nonatomic, strong) UIColor *panelDividerColor;
/// Selected item colour
@property (nonatomic, strong) UIColor *panelItemCheckedColor;
/// Text colour
@property (nonatomic, strong) UIColor *textColor;
/// Text selection colour
@property (nonatomic, strong) UIColor *textCheckedColor;
/// Progress bar colour
@property (nonatomic, strong) UIColor *seekBarProgressColor;
/// Singleton
+ (instancetype)shareInstance;

/// Set panel resource path
/// - Parameter resources: List of resource paths
/// e.g. @[@{TEUI_BEAUTY : @"json file path"}]
- (void)setTEPanelViewResources:(NSArray<NSDictionary *> *)resources;
/// Get panel resource path
- (NSArray<NSDictionary *> *)getTEPanelViewResources;

/// Beauty SDK object
@property (nonatomic, weak) XMagic *beautyKitApi;
/// BeautyKit object
@property (nonatomic, strong) TEBeautyKit *teBeautyKit;
/// Delegate
@property (nonatomic, weak) id<TEPanelViewDelegate> delegate;
/// Set exported beauty data
- (void)setExportParamList:(NSString *)lastParamList;
/// Default beauty
- (void)setDefaultBeauty;
/// Reset all effects
- (void)performFullReset;
/// Enhanced mode
- (void)setEnhancedMode:(BOOL)enhancedMode;
/// Show compare button
- (void)isShowCompareBtn:(BOOL)isShow;