Quickstart

Before you start

Get a license key from the Nosmai portal. The key is verified online the first time your app runs, so make sure the device has connectivity that first time.

Effects need camera access, so add the camera permission to your app (and microphone if you record video).

1. Install

Pick your platform.

Flutter

dependencies:
  nosmai_camera_sdk: ^2.0.1

iOS

pod 'NosmaiCameraSDK', :git => 'https://github.com/nosmai/camera-sdk-ios.git'

Android (download nosmai-camera-sdk-android.aar into app/libs/, then reference it):

dependencies {
    implementation files('libs/nosmai-camera-sdk-android.aar')
}

2. Initialize

Initialize once at startup with your license key.

Flutter

await NosmaiFlutter.initialize('YOUR_LICENSE_KEY');

iOS

[[NosmaiSDK shared] initWithLicenseKey:@"YOUR_LICENSE_KEY"];

Android

NosmaiSDK.initialize(this, "YOUR_LICENSE_KEY");

3. Show the preview and apply an effect

Flutter

// in your widget tree
const NosmaiCameraPreview();

final nosmai = NosmaiFlutter.instance;
await nosmai.startProcessing();
await nosmai.applySkinSmoothing(5.0);   // 0.0 - 10.0

iOS

NosmaiCamera *camera = [[NosmaiCamera alloc] init];
[camera setupPreviewInView:self.previewView];
[camera startCamera];
[camera applySkinSmoothing:0.7f];       // 0.0 - 1.0

Android

NosmaiPreviewView previewView = new NosmaiPreviewView(this);
container.addView(previewView);
NosmaiSDK.startProcessing(previewView);
NosmaiBeauty.applySkinSmoothing(0.7f);  // 0.0 - 1.0

Next steps

• Filters and effects: how filters, effects and the .nosmai format work.
• Platform guides: iOS, Android, Flutter.
• Live streaming: send processed frames to a streaming or recording pipeline.