IFU011(01) Reader SDK React Native Integration Guide

brew install awscli

aws configure --profile ndxcodeartifact

aws configure set aws_access_key_id "${ECR_KEY}"
aws configure set aws_secret_access_key "${ECR_SECRET}"
aws configure set region "${AWS_REGION}"

aws codeartifact login --tool npm --domain novarumdx --domain-owner 945969778369 --repository novarum.client.npm --profile ndxcodeartifact --namespace novarumdx

npm install @novarumdx/ndx-imaging-expo

yarn add @novarumdx/ndx-imaging-expo

  "dependencies": {
    "@novarumdx/ndx-imaging-expo": "3.0.0"
  }

    "plugins": [
      [
        "expo-build-properties",
        {
          "ios": {
            "deploymentTarget": "15.1"
          },
          "android": {
            "minSdkVersion": 26
          }
        }
      ]
    ]

      [
        "@novarumdx/ndx-imaging-expo",
        {
          "cameraPermission": "camera permission message",
        }
      ]

import React from "react";
import { View, Text, Button } from "react-native";
import { useCameraPermissions } from "@novarumdx/ndx-imaging-expo";

function AppContent() {
  return <Text>Camera is ready. Your app goes here.</Text>;
}

export default function App() {
  const [permission, requestPermission] = useCameraPermissions();

  // Permission state is still loading
  if (!permission) {
    return (
      <View style={{ flex: 1, alignItems: "center", justifyContent: "center" }}>
        <Text>Loading...</Text>
      </View>
    );
  }

  // Permission not granted yet: show a button to request
  if (!permission.granted) {
    return (
      <View style={{ flex: 1, alignItems: "center", justifyContent: "center", padding: 16 }}>
        <Text style={{ textAlign: "center", marginBottom: 16 }}>
          We need camera access to continue.
        </Text>
        <Button title="Grant Camera Permission" onPress={requestPermission} />
      </View>
    );
  }

  // Permission granted: render the app
  return <AppContent />;
}

import testConfigJson from './assets/test-config.json';
const testInfoJson = JSON.stringify(testConfigJson);

import { NdxImagingExpoView } from 'ndx-imaging-expo';
import testConfigJson from './assets/test-config.json';

export function ScannerPage({ navigation }) {
  const cameraRef = useRef<any>(null);
  const testInfoJson = JSON.stringify(testConfigJson);

  const handleAbort = () => {
    if (cameraRef.current) {
      cameraRef.current.abort();
    }
  };

  return (
    <View style={styles.container}>
      <NdxImagingExpoView
        ref={cameraRef}
        style={styles.camera}
        testInfoJson={testInfoJson}
        previewMode="Fit"
        onFrameCaptured={({ nativeEvent }) => {
          const { frame } = nativeEvent;
          console.log('Frame progress:', frame.progress);   // 0.0-1.0
          console.log('PMF Status:', frame.resultPMF);      // "Fit" | "MarginalFit" | "NoFit"
          console.log('Lux:', frame.lux);                   // Light level
          console.log('Orientation:', frame.orientation);   // [roll, pitch, yaw]
        }}
        onComplete={({ nativeEvent }) => {
          const { resultModel } = nativeEvent;
          console.log('Scan complete!');
          console.log('Frames captured:', resultModel.pmfStory.length);
          navigation.navigate('ResultDetail', resultModel);
          // resultModel.pmfStory - array of captured frames
          // resultModel.testStrips - analyzed test strips with T/C lines
          // resultModel.testConfiguration - test parameters used
        }}
        onAbort={({ nativeEvent }) => {
          const { resultModel } = nativeEvent;
          console.log('Scan aborted');
          navigation.navigate('ResultDetail', resultModel);
          // Contains partial results up to abort
          // May contain some images if scan was partially complete
        }}
      />
      <Button onPress={handleAbort} title="Abort Scan" />
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    backgroundColor: '#000',
  },
  camera: {
    flex: 1,
  },
});

export type FrameCapturedCallback = {
  /** Fractional progress of the capture or analysis (0.0 to 1.0). */
  progress: Float;
  /** Result from the Point Model Fitter (PMF) analysis. */
  resultPMF: keyof typeof ResultPMF;
  /** Statuses of detected strips in the frame. */
  stripStatuses: (keyof typeof StripStatus)[];
  /** Device or image orientation as [roll, pitch, yaw] (Euler angles). */
  orientation: Double[];
  /** Ambient light level in lux. */
  lux: Float;
};

/**
 * Contains the results of the image analysis process.
 */
export type ResultModel = {
  /** List of analysed test strips and their results. */
  testStrips: TestStrip[];
  /** Sequence of frame data captured during the scan. */
  pmfStory: FrameDataRecord[];
  /** The configuration used for the test. */
  testConfiguration: TestConfigurationRecord;
};