Nosmai Effects SDK for Flutter #

Add real-time AR effects, beauty filters, digital makeup, background replacement, interactive camera games, camera capture, and cloud filters to Flutter applications through one SDK for Android and iOS.

Built for #

Nosmai Effects can be used in:

• social media and short-video apps
• live streaming and video chat
• creator cameras and recording tools
• beauty and makeup experiences
• photo and video editing workflows
• virtual background experiences
• entertainment and interactive camera apps

Key features #

• Real-time camera preview with GPU-accelerated rendering
• Face detection and face-tracked AR effects
• 3D masks, stickers, particles, and animated overlays
• Skin smoothing, whitening, sharpening, and teeth whitening
• Lipstick, eyeshadow, blusher, eyelashes, and eyebrows
• Face slimming, eye size, nose, chin, jaw, lips, forehead, and brow controls
• LUT filters, brightness, contrast, hue, saturation, RGB, and white balance
• Background blur, color, image, video, and packaged background effects
• Interactive .nosmai games with touch/face input and typed event streams
• Local and cloud-based .nosmai filters
• Cloud filter browsing, pagination, download, caching, and removal
• Front and back camera switching
• Photo capture and processed video recording
• Processed camera output for live streaming integrations

On-device processing #

Camera frames, face tracking, beauty, AR effects, and background processing run on the user's device. Camera frames do not need to be uploaded to apply visual effects.

Network access is used for license verification, cloud filter discovery, and filter downloads.

Platform support #

Camera preview, face tracking, recording, and performance should be tested on physical devices. The iOS simulator is not supported by the native Effects SDK. Android production builds must include both Flutter target platforms android-arm and android-arm64 when both supported Nosmai ABIs are required.

Face reshape controls #

Use setReshape for the complete Android/iOS reshape set. Its value is signed from -1.0 to 1.0, with 0.0 as neutral:

await nosmai.setReshape(type: NosmaiReshapeType.jaw, value: 0.25);
await nosmai.setReshape(type: NosmaiReshapeType.mouthWidth, value: -0.15);

Convenience methods are also available for lip size, chin size, eyebrow position/thickness, jawline, mouth width, and forehead size. Existing one-direction face-slim, eye-enlargement, and nose-slim methods remain 0.0...1.0 for backward compatibility.

Getting started #

Add nosmai_effects_sdk to your Flutter application and follow the official Flutter integration guide for licensing, native setup, permissions, camera lifecycle, filters, capture, and production requirements.

• Introduction
• Flutter platform guide
• Flutter installation
• License key
• Apply a beauty filter
• Filters and effects
• Cloud filters
• Flutter live streaming with Agora
• Troubleshooting

A valid Nosmai license key is required. Create and manage projects through the Nosmai Console.

Recommended camera lifecycle #

Initialize Nosmai once before opening the camera route, then mount exactly one NosmaiCameraPreview. The preview starts native camera processing automatically; applications should not call startProcessing() during normal screen setup.

Await endCameraSession() before leaving the route. The included NosmaiCameraLifecycleMixin provides this safe navigation flow:

class CameraScreenState extends State<CameraScreen>
    with NosmaiCameraLifecycleMixin {
  Future<void> closeCamera() async {
    await cleanupBeforeNavigation();
    if (mounted) Navigator.of(context).pop();
  }

  @override
  Widget build(BuildContext context) {
    return const NosmaiCameraPreview();
  }
}

Do not call asynchronous global cleanup from a camera widget's dispose(). The native PlatformView owns final view disposal, and an old cleanup request could otherwise stop a newly-created preview.

Built-in adjustment ranges #

• Skin smoothing, whitening, sharpening, teeth whitening, and makeup intensity: 0.0...1.0
• Brightness: -1.0...1.0 (0.0 is neutral)
• Contrast, RGB channels, HSB saturation, and HSB brightness: 0.0...2.0 (1.0 is neutral)
• Hue: 0...360 degrees
• White-balance temperature: 2000...8000; tint: -100...100

Native SDK distribution #

• Version 1.0.3 uses Android Effects SDK 3.0.5 from the official GitHub release and resolves NosmaiCameraSDK 3.0.5 through CocoaPods on iOS.
• The Flutter plugin resolves the Android AAR from Nosmai Effects SDK for Android releases; applications do not need to keep a local AAR in android/app/libs.
• Native SDK binaries and licensed .nosmai assets are not bundled in the pub.flutter-io.cn package.

See the Flutter integration guide for the current compatible native SDK versions and installation steps.

Support #

• Documentation
• GitHub issues
• Nosmai Effects
• Email: admin@nosmai.com

License #

This Flutter plugin and its associated native SDKs are proprietary commercial software. A valid agreement and license key are required. See LICENSE for the applicable terms.