Effects Platform support
Effects / Get started / Platform support

Nosmai Effects platform and feature support

Updated August 28, 2026

Compare supported features, minimum requirements, release status, and delivery options across every Nosmai Effects SDK.

Choose your SDK

Nosmai Effects is available for iOS, Android, Flutter, React Native, and Web. Choose the SDK that matches your application's framework. Flutter and React Native apps should use their framework's package and guide for both mobile targets. Native iOS and Android guides are for apps integrating those SDKs directly.

Here, native means the SDK built directly for iOS or Android. Flutter and React Native connect to those native mobile SDKs. Web 1.0.0 is distributed publicly through npm and runs in the browser. Its APIs, browser requirements, and package-specific limits are described below.

PlatformCurrent releaseRelease statusStart here
iOSNosmaiCameraSDK 3.0.7SupportedInstall for iOS
Androidnosmai-sdk-3.0.7.aarSupportedInstall for Android
Flutternosmai_effects_sdk 2.0.2SupportedInstall for Flutter
React Native@nosmai/react-native-effects-sdk 2.0.1SupportedInstall for React Native
Web@nosmai/web-sdk 1.0.0Public npm releaseInstall for Web

Supported means the documented native or framework integration is available for production use on the stated targets. Available identifies a public Web 1.0.0 API. Browser-dependent features require the relevant browser APIs and permissions. Package-dependent features require compatible authored content; test the exact package on your intended targets. Feature access also depends on your licence.

Core capability matrix

CapabilityiOSAndroidFlutterReact NativeWeb
Real-time camera previewSupportedSupportedSupportedSupportedAvailable
Front/back camera and switchingSupportedSupportedSupportedSupportedAvailable; camera-dependent
Camera lifecycle and rotationSupportedSupportedSupportedSupportedStart/stop/dispose; browser-dependent rotation
Direct beauty and makeup controlsSupportedSupportedSupportedSupportedAvailable
Contour, highlighter, freckles, foundation, and dark-circle correctionSupportedSupportedSupportedSupportedAvailable
Hair colouringSupportedSupportedSupportedSupportedAvailable
Runtime PNG, JPEG, or animated GIF face stickersSupportedSupportedSupportedSupportedNo direct sticker API
Direct colour adjustmentsSupportedSupportedSupportedSupportedAvailable
Effect packagesSupportedSupportedSupportedSupportedPackage-dependent
Face-tracked AR packagesSupportedSupportedSupportedSupportedPackage-dependent
3D authored contentSupportedSupportedSupportedSupportedPackage-dependent
Authored triggersSupportedSupportedSupportedSupportedPackage-dependent
Runtime package parametersSupportedSupportedSupportedSupportedNumeric and string controls
Background blur, colour, and imageSupportedSupportedSupportedSupportedAvailable
Background videoSupportedSupportedSupportedSupportedAvailable; browser playback rules
Cloud Filters catalog and downloadSupportedSupportedSupportedSupportedAvailable; requires Cloud Filters access

Capture and streaming matrix

CapabilityiOSAndroidFlutterReact NativeWeb
Processed photo captureSupportedUse app capture flowSupportedSupportedAvailable (Blob)
Processed video recordingSupportedSupportedSupportedSupportedAvailable; browser-dependent
Processed frame or texture accessSupportedSupportedSupportedSupportedMediaStream / MediaStreamTrack
Agora integrationSupportedSupportedSupportedNot currently documentedCustom track; example
LiveKit integrationSupportedSupportedSupportedNot currently documentedCustom track; example
Raw WebRTC integrationSupportedSupportedNot currently documentedNot currently documentedCustom track; guide

“Use app capture flow” means the host application captures the documented processed output rather than calling a dedicated Nosmai photo helper. “Not currently documented” is not a promise of incompatibility; it means no verified public integration guide is available for that combination.

System requirements

RequirementiOSAndroidFlutterReact NativeWeb
Minimum targetiOS 15Android API 24iOS 15 or Android API 24iOS 15 or Android API 24HTTPS or localhost
ArchitecturePhysical ARM64 devicePhysical arm64-v8a or armeabi-v7a deviceiOS arm64; Android arm64-v8a or armeabi-v7aiOS arm64; Android arm64-v8a or armeabi-v7aBrowser with WebAssembly SIMD and WebGL2
Primary toolchainCocoaPods, Swift or Objective-CJava 11, compile SDK 35Flutter 3.29, Dart 3React Native 0.81.5, React 19.1, New ArchitectureNode 18+ or the bundler's higher minimum, ESM bundler
Camera accessiOS camera permissionAndroid camera permissionNative camera permissionsNative camera permissionsBrowser camera permission
Simulator or emulatorNot supportedNot qualifiedUse physical devicesUse physical devices; Expo Go unsupportedBrowser testing supported

Web requirements and limits

Web 1.0.0 requires WebGL2, WebAssembly SIMD, Web Crypto, and camera access in a secure context. Use a current browser with hardware acceleration and test the devices your users will use.

  • Serve the package's engine/, engine-baseline/, and models/ directories from the configured assetBase. The SDK selects a compatible engine automatically; deploy both engine directories from the same SDK release.
  • The page and any embedding iframe must permit camera access. Content Security Policy and CORS must allow runtime assets, licence verification, and effect downloads. Register the application's Web origin for licensing.
  • Face detection and tracking handle one face at a time. Multi-face tracking is unavailable in this release.
  • Hair controls tint existing hair. Changing hairstyle length or shape is outside the hair-colouring API.
  • Use compatible authored packages for face overlays. The public Web API does not expose a standalone runtime image-sticker API.
  • Check sdk.recording.isSupported before recording. The available video format depends on browser support; photo capture returns a Blob.
  • Processed streaming output is a video-only MediaStream or MediaStreamTrack. Handle the microphone separately. Effect audio is excluded from published output and recordings.

The Web installation guide covers asset hosting and browser security. The Web API reference lists methods, ranges, events, and licence checks. Measure performance with your actual resolution, effects, and recording or streaming workload.

Distribution and application size

SDKDistributionPublished artifact size
iOS 3.0.7CocoaPods or verified framework ZIPFramework files: 42,614,663 bytes (40.6 MiB); release ZIP: 27,200,994 bytes (25.9 MiB)
Android 3.0.7Verified release AAR40,433,979 bytes (38.6 MiB), including both supported ARM ABIs
Flutter 2.0.2pub.dev package plus native dependenciesWrapper is small; native artifacts resolve separately
React Native 2.0.1npm package plus native dependencies249,401 bytes (243.6 KiB) packed; native artifacts resolve separately
Web 1.0.0Public npm package with JavaScript, both engines, and model assets17,848,349 bytes (17.0 MiB) packed; 33,214,195 bytes (31.7 MiB) unpacked

Published artifact size is not the final store-download increase. Store compression, app thinning, ABI splits, symbols, and existing dependencies all affect the shipped app. Measure the signed release build that users will download.

For Web, the npm package contains both engines; a browser loads the selected engine and the model assets from your app's asset host. Measure application JavaScript, runtime assets, and effect downloads separately, including cache behaviour on repeat visits. Effect assets and licensed feature access are separate from installing the npm package.

Verify platform eligibility

Before integration, confirm that:

  1. The target meets the minimum OS and architecture requirement.
  2. The required feature is available and its platform-specific limitations are acceptable.
  3. A physical device is available for native camera testing.
  4. The final application identifier or Web origin is registered for licensing.
  5. The exact authored packages are tested on every target platform.
  6. Performance is measured with the intended camera resolution and effects.

Common errors

SymptomLikely causeResolution
Android reports INSTALL_FAILED_NO_MATCHING_ABISThe device or app build includes neither arm64-v8a nor armeabi-v7aUse a supported physical ARM device and keep at least one supported ABI
iOS linker reports a Simulator architecture mismatchThe current framework is device-onlyBuild and run on a physical iPhone or iPad
Web reports webglUnavailableGraphics support is unavailable or runtime startup failedCheck the underlying error and asset responses; use a browser with WebGL2 and WebAssembly SIMD and enable hardware acceleration
Web runtime or model requests return 404Assets were not copied or assetBase points to the wrong public URLFollow the Web installation guide and verify the deployed asset paths
Web Cloud Filters report FEATURE_NOT_LICENSEDVerification is pending or the key does not grant Cloud Filters accessWait for licence verification and check sdk.isCloudFilterEnabled
React Native preview does not startThe camera view is not mounted or the required architecture is disabledMount the documented view and use the supported New Architecture setup

Next steps

References

Nosmai

An AR and AI company. Founded on the idea that the next decade of software will be visual, and that the tools for it should be within reach of anyone building.

Newsletter

Product updates and release notes. No spam.

© 2026 nosmai, inc · all rights reserved