Prerequisites
- Nosmai Effects installed for iOS
- iOS deployment target 15 or later
- A physical arm64 iPhone or iPad
- A Nosmai licence key bound to the signed bundle ID
NSCameraUsageDescriptionin the applicationInfo.plist
1. Confirm camera permission text
<key>NSCameraUsageDescription</key> <string>This app uses the camera for real-time filters and effects.</string>
The system terminates an app that requests camera access without this key.
2. Request camera access
Request permission before presenting the processed preview:
[AVCaptureDevice requestAccessForMediaType:AVMediaTypeVideo
completionHandler:^(BOOL granted) {
dispatch_async(dispatch_get_main_queue(), ^{
if (granted) {
[self initializeNosmai];
}
});
}];
Skip the prompt when authorization is already granted, and show an app-owned settings message when access was denied.
3. Initialize Nosmai once
Initialize from the application owner and continue from the successful completion:
[[NosmaiCore shared]
initializeWithAPIKey:@"NOSMAI-YOUR-IOS-LICENSE-KEY"
completion:^(BOOL success, NSError *error) {
if (!success) {
NSLog(@"Nosmai initialization failed: %@", error.localizedDescription);
return;
}
[self startNosmaiCamera];
}];
Replace the documentation key with application-owned configuration.
4. Attach and start the preview
Attach the SDK camera to an existing UIView owned by the camera controller:
NosmaiCore *core = [NosmaiCore shared]; NosmaiCameraConfig *config = [[NosmaiCameraConfig alloc] init]; config.position = NosmaiCameraPositionFront; config.sessionPreset = AVCaptureSessionPresetHigh; config.frameRate = 30; [core.camera updateConfiguration:config]; [core.camera attachToView:self.previewView]; [core.camera startCapture]; [core.effects applySkinSmoothing:0.4f];
Keep camera attachment and preview updates on the main thread.
5. Stop capture when leaving
Release the preview when its screen is no longer visible:
[[NosmaiCore shared].camera stopCapture]; [[NosmaiCore shared].camera detachFromView];
Call cleanup only when the application no longer needs the shared SDK state. Build and run on a physical device, not iOS Simulator.
Verify it worked
You should see the front-camera preview and a visible smoothing change at level 0.4. Any on-screen status label is part of your application's UI, not created by these snippets. Leave the screen and confirm the iOS camera indicator turns off. Return and confirm capture restarts without a second initialization.
Common errors
| Error | Cause | Fix |
|---|---|---|
SDK initialization failed | Native initialization or licence setup did not complete | Inspect the accompanying NSError, key, bundle ID, and network access |
SDK not initialized | Camera or effects API was accessed before completion | Move camera setup inside the successful initialization completion |
Camera preview not available | No preview view is attached | Call attachToView: before startCapture |
Camera not active | Capture-dependent operation ran before the camera started | Confirm permission and check the Boolean result from startCapture |
building for iOS Simulator, but linking in object file built for iOS | The framework has no simulator slice | Select a physical arm64 iOS device |
Next steps
- Apply a beauty filter on iOS
- Replace the background in iOS
- Download a Cloud Filter in iOS
- Render processed frames for streaming in iOS