Effects React Native
Effects / Guides / AR masks / React Native

Add an AR face mask in React Native with Nosmai Effects

Updated August 27, 2026

Download a face-tracked AR mask through Cloud Filters, apply it through the React Native SDK, and keep the UI synchronized.

Prerequisites

Obtain and apply the mask

const page = await NosmaiCameraSdk.getCloudFilters({
  packageType: 'effect',
  page: 1,
  limit: 20,
});
const mask = page.filters[0];

if (mask) {
  const download = await NosmaiCameraSdk.downloadCloudFilter(mask);
  await NosmaiCameraSdk.applyEffect(download.path);
}

Remove it

await NosmaiCameraSdk.removeEffect(download.path);

Verify it worked

Test face loss, reacquisition, rotation, navigation, and Fast Refresh cleanup on both native platforms.

Common errors

Error or symptomFix
E_INVALID_PACKAGE_PATHUse the successful Cloud Filter download result
Mask appears after screen closesIgnore stale Promises and call cleanup during unmount
Selection becomes staleObserve active effects instead of trusting the last button tap

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