AiyaEffectsAndroid is an open-source Android SDK for adding real-time face tracking and special effects to mobile applications. It provides a range of features including face detection, face tracking, and various beauty and AR effects that can be applied to live video streams or images.

Pros

• Easy integration with existing Android projects
• Wide range of pre-built effects and filters
• Real-time performance optimized for mobile devices
• Regular updates and active maintenance

Cons

• Limited documentation in English
• Requires camera permissions, which may concern privacy-conscious users
• Some advanced features may require a paid license
• Potential performance impact on lower-end devices

Code Examples

1. Initializing the SDK:

AiyaEffects.getInstance().init(context, "YOUR_LICENSE_KEY");

2. Adding a face tracking effect to a camera preview:

mEffectHandler = new AiyaHandler(this);
mEffectHandler.setEffect(AiyaEffects.EFFECT_TYPE_FACE_TRACK);
mEffectHandler.setOnProcessListener(new ProcessListener() {
    @Override
    public void onProcessFinished() {
        // Handle processed frame
    }
});

3. Applying a beauty filter:

mEffectHandler.setBeautyLevel(5); // Set beauty level (0-10)
mEffectHandler.setEffect(AiyaEffects.EFFECT_TYPE_BEAUTY);

Getting Started

1. Add the AiyaEffectsSDK dependency to your app's build.gradle:

dependencies {
    implementation 'com.aiyaapp.aiya:AiyaEffectSDK:4.3.0'
}

2. Initialize the SDK in your Application class:

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        AiyaEffects.getInstance().init(this, "YOUR_LICENSE_KEY");
    }
}

3. Implement the AiyaController.FrameCallback in your camera activity/fragment and use the AiyaController to process frames:

AiyaController mAiyaController = new AiyaController(this);
mAiyaController.setFrameCallback(this);
mAiyaController.setEffect(AiyaEffects.EFFECT_TYPE_FACE_TRACK);

@Override
public void onFrame(byte[] data, int width, int height) {
    // Process frame and update UI
}