@moveris/react-native

React Native SDK for Moveris Live API - Mobile implementation.

Installation

pnpm add @moveris/react-native
# or
npm install @moveris/react-native
# or
yarn add @moveris/react-native

Additional Setup

iOS

Add to ios/Podfile:

pod 'react-native-vision-camera', :path => '../node_modules/react-native-vision-camera'

Then:

cd ios && pod install

Android

Add to android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.CAMERA" />

Usage

import { MoverisProvider, useLiveness } from '@moveris/react-native';

function App() {
  return (
    <MoverisProvider apiKey="mv_your_api_key_here" model="mixed-30-v2">
      <LivenessCheck />
    </MoverisProvider>
  );
}

function LivenessCheck() {
  const { start, stop, result, state } = useLiveness({
    sessionId: 'optional-fixed-id', // auto-generated if omitted
    onResult: (result) => {
      console.log('Result:', result);
    },
  });

  return (
    <View>
      <Button title="Start" onPress={start} />
      <Button title="Stop" onPress={stop} />
      {result && <Text>Result: {result.prediction}</Text>}
    </View>
  );
}

Eye Region Quality Analysis

The package re-exports eye region quality utilities from @moveris/shared for use in custom frame processors (e.g. with Vision Camera frame processor plugins):

import {
  checkEyeRegionQuality,
  getEyeRegionBounds,
  EYE_QUALITY_THRESHOLDS,
  EYE_LANDMARK_INDICES,
} from '@moveris/react-native';

// With face landmarks from ML Kit / Expo Face Detection:
const bounds = getEyeRegionBounds(landmarks);
if (bounds) {
  const quality = checkEyeRegionQuality(eyePixels);
  if (!quality.passed) {
    console.log(quality.message); // e.g. "Eyes are in shadow - improve lighting"
  }
}

These functions operate on raw RGBA pixel arrays and are platform-agnostic, so they can be used with any face landmark provider.

API

See API Documentation for complete API reference.