@faceaisdk/react-native-face-sdk 0.1.1

package/android/src/main/java/com/faceaisdk/reactnative/FaceRNPackage.kt

@@ -0,0 +1,16 @@
+package com.faceaisdk.reactnative
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+class FaceRNPackage : ReactPackage {
+    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+        return listOf(FaceRNModule(reactContext))
+    }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        return emptyList()
+    }
+}

package/ios/FaceAISDK/CustomToastView.swift

@@ -0,0 +1,34 @@
+import Foundation
+import SwiftUI
+
+//  Created by anylife on 2025/12/2.
+
+// 定义 Toast 样式
+enum ToastStyle {
+    case success
+    case failure
+    var backgroundColor: Color {
+        switch self {
+        case .success: return Color.faceMain
+        case .failure: return Color.red
+        }
+    }
+}
+struct CustomToastView: View {
+    let message: String
+    let style: ToastStyle
+    var body: some View {
+        VStack {
+            HStack {
+                Text(message)
+                    .foregroundColor(.white)
+                    .font(.system(size: 19).bold())
+                    .padding(.vertical, 14)
+                    .padding(.horizontal, 22)
+            }
+            .background(style.backgroundColor)
+            .cornerRadius(25)
+            .shadow(radius: 5)
+        }
+    }
+}

package/ios/FaceAISDK/FaceAINaviView.swift

@@ -0,0 +1,212 @@
+import SwiftUI
+import FaceAISDK_Core
+
+/**
+ * iOS FaceAISDK navigation page, UI is for reference only.
+ * iOS FaceAISDK 功能导航页面，UI 仅供参考。
+ */
+struct FaceAINaviView: View {
+    
+    // The FaceID value used for saving the face feature. Usually, it's the unique identifier of a person in your business system, such as an account ID or ID card number.
+    // 录入保存的 FaceID 值。一般是你的业务体系中个人的唯一编码，比如账号或身份证号。
+    private let faceID = "yourFaceID";
+    
+    var onDismiss: (() -> Void)?
+
+    var body: some View {
+        NavigationView {
+            ZStack {
+                // 背景色铺满
+                Color.faceMain.ignoresSafeArea()
+                
+                // 使用 ScrollView 适配小屏幕机型
+                ScrollView(.vertical, showsIndicators: false) {
+                    VStack(spacing: 18) {
+                        
+                        // --- 模块一：人脸录入 ---
+                        VStack(spacing: 14) {
+                            // 通过 SDK 相机录入人脸
+                            NavigationLink(destination: AddFaceByCamera(
+                                faceID: faceID,
+                                addFacePerformanceMode: 1,
+                                needShowConfirmDialog: true,
+                                onDismiss: { result, feature in
+                                    print("🎆 AddFace   Status: \(result), Feature: \(feature)")
+                                }
+                            )) {
+                                MenuRowView(icon: "camera.viewfinder", title: "Add Face By Camera")
+                            }
+                            
+                            // 通过图片录入人脸信息
+                            NavigationLink(destination: AddFaceByImage(
+                                faceID: faceID,
+                                onDismiss: { result, feature in
+                                    print("🎆  AddFace  Status: \(result), Feature: \(feature ?? "")")
+                                }
+                            )) {
+                                MenuRowView(icon: "photo.on.rectangle.angled", title: "Add Face From Album")
+                            }
+                        }
+                        .padding(.top, 20)
+                        
+                        // --- 模块二：识别与活体 ---
+                        VStack(spacing: 14) {
+                            // 人脸识别 + 活体检测
+                            NavigationLink(destination: VerifyFaceView(
+                                faceID: faceID,
+                                // Threshold range [0.8, 0.9].  阈值范围【0.8，0.9】。
+                                threshold: 0.83,
+                                
+                                // 1. Motion Liveness, 2. Motion + Color, 3. Color, 4. Silent Liveness only (the first three all include silent liveness).
+                                // 1.动作活体 2.动作+炫彩 3.炫彩 4.仅静默活体(前三种都会带静默)。
+                                livenessType: 1,
+                                // 1. Open mouth, 2. Smile, 3. Blink, 4. Shake head, 5. Nod.
+                                // 1.张嘴 2.微笑 3.眨眼 4.摇头 5.点头。
+                                motionLiveness: "1,2,3,4,5",
+                                // Timeout: 3-22 seconds.  超时时间：3-22秒。
+                                motionLivenessTimeOut: 11,
+                                // Number of motion steps.  动作步骤个数。
+                                motionLivenessSteps:2,
+                                
+                                onDismiss: {code, similarity, liveness in
+                                    print("🎆 Face Verify  Status: \(code), Similarity: \(similarity), Liveness: \(liveness)")
+                                }
+                            )) {
+                                MenuRowView(icon: "faceid", title: "Face Verify & Liveness")
+                            }
+                            
+                            // 仅活体检测（建议动作活体+静默组合）
+                            NavigationLink(destination: LivenessDetectView(
+                                // 1. Motion Liveness, 2. Motion + Color, 3. Color, 4. Silent Liveness only (the first three all include silent liveness).
+                                // 1. 动作活体 2.动作+炫彩 3.炫彩 4.仅静默活体(前三种都会带静默)。
+                                livenessType: 1,
+                                // 1. Open mouth, 2. Smile, 3. Blink, 4. Shake head, 5. Nod.
+                                // 1. 张嘴 2.微笑 3.眨眼 4.摇头 5.点头。
+                                motionLiveness: "1,2,3,4,5",
+                                // Timeout in seconds. 超时时间(秒)。
+                                motionLivenessTimeOut: 5,
+                                // Number of motion steps. 动作步骤个数。
+                                motionLivenessSteps:2,
+                                //show Result Tips? For Flutter,RN,UNIApp plugin
+                                showResultTips: true,
+                                onDismiss: { code,liveness in
+                                    print("🎆 Liveness Result: \(code), Liveness Score: \(liveness)")
+                                }
+                            )) {
+                                MenuRowView(icon: "person.crop.circle.badge.checkmark", title: "ONLY Liveness Detection")
+                            }
+                        }
+                        .padding(.top, 8)
+                        
+                        // --- 模块三：功能辅助测试 ---
+                        VStack(spacing: 14) {
+                            // 判断 faceID 对应人脸特征值是否存在
+                            Button(action: {
+                                guard let faceFeature = UserDefaults.standard.string(forKey: faceID) else {
+                                    print("isFaceFeatureExist？ ： No ! ")
+                                    return
+                                }
+                                print("\n😊FaceFeature: \(faceFeature)")
+                            }) {
+                                MenuRowView(icon: "magnifyingglass.circle", title: "Is Face Feature Exist", showChevron: false)
+                            }
+                            
+                            // 验证两张人脸的相似度
+                            NavigationLink(destination: VerifyTwoFaceSimiView()) {
+                                MenuRowView(icon: "person.2.crop.square.stack", title: "Verify Two Face Similarity")
+                            }
+                        }
+                        .padding(.top, 8)
+
+                        Spacer().frame(height: 30)
+                        
+                        // 打开关于我们的外部链接 (保持简洁风格)
+                        Button(action: {
+                            if let url = URL(string: "https://faceaisdk.github.io/index") {
+                                DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
+                                    if UIApplication.shared.canOpenURL(url) {
+                                        UIApplication.shared.open(url)
+                                    }
+                                }
+                            }
+                        }) {
+                            Text("About us")
+                                .font(.system(size: 14, weight: .medium))
+                                .foregroundColor(Color.white.opacity(0.8))
+                                .underline()
+                        }
+                        .padding(.bottom, 40)
+                        .padding(.top, 22)
+                    }
+                    .padding(.horizontal, 22)
+                    .padding(.top, 22)
+                }
+            }
+            .navigationBarTitleDisplayMode(.inline)
+            // 顶部导航栏添加关闭按钮
+            .toolbar {
+                ToolbarItem(placement: .navigationBarLeading) {
+                    Button(action: {
+                        onDismiss?()
+                        UIControl().sendAction(#selector(URLSessionTask.suspend), to: UIApplication.shared, for: nil)
+                    }) {
+                        Image(systemName: "xmark")
+                            .font(.system(size: 13, weight: .bold))
+                            .foregroundColor(.white)
+                            .padding(8)
+                            .background(Circle().fill(Color.white.opacity(0.2)))
+                    }
+                }
+            }
+        }
+        .navigationViewStyle(.stack)
+        .onAppear {
+            // 视图显示时将屏幕亮度调至最大
+            ScreenBrightnessHelper.shared.maximizeBrightness()
+            withAnimation(.easeInOut(duration: 0.3)) {
+                UIScreen.main.brightness = 1.0
+            }
+        }
+    }
+}
+
+// MARK: - 统一的菜单行组件
+/// 用于美化导航列表的按钮卡片视图
+struct MenuRowView: View {
+    var icon: String
+    
+    // 将 String 改为 LocalizedStringKey，这样 SwiftUI 就会自动去 Localizable.strings 查找多语言
+    var title: LocalizedStringKey
+    
+    var showChevron: Bool = true // 是否显示右侧的小箭头
+    
+    var body: some View {
+        HStack(spacing: 16) {
+            Image(systemName: icon)
+                .font(.system(size: 22, weight: .light))
+                .frame(width: 30)
+            
+            Text(title)
+                .font(.system(size: 17, weight: .semibold))
+            
+            Spacer()
+            
+            if showChevron {
+                Image(systemName: "chevron.right")
+                    .font(.system(size: 14, weight: .semibold))
+                    .foregroundColor(Color.white.opacity(0.5))
+            }
+        }
+        .foregroundColor(.white)
+        .padding(.horizontal, 20)
+        .padding(.vertical, 18)
+        .background(
+            RoundedRectangle(cornerRadius: 16)
+                .fill(Color.white.opacity(0.15))
+        )
+        .overlay(
+            RoundedRectangle(cornerRadius: 16)
+                .stroke(Color.white.opacity(0.3), lineWidth: 1)
+        )
+    }
+}

package/ios/FaceAISDK/FaceSDKCameraView.swift

@@ -0,0 +1,40 @@
+import SwiftUI
+import AVFoundation
+
+/**
+ * 人脸相机预览管理
+ *
+ */
+public struct FaceSDKCameraView: UIViewControllerRepresentable {
+    let session: AVCaptureSession
+    let cameraSize:CGFloat
+    
+    public init(session: AVCaptureSession, cameraSize: CGFloat) {
+        self.session = session
+        self.cameraSize = cameraSize
+    }
+    
+    public func makeUIViewController(context: Context) -> UIViewController {
+        let viewController = UIViewController()
+        
+        let previewLayer = AVCaptureVideoPreviewLayer(session: session)
+        
+        // Ensure square preview
+        previewLayer.videoGravity = .resizeAspectFill
+        previewLayer.frame = CGRect(x: 0, y: 0, width: cameraSize, height: cameraSize)
+        
+        viewController.view.layer.addSublayer(previewLayer)
+        viewController.view.clipsToBounds = true
+        
+        return viewController
+    }
+    
+    public func updateUIViewController(_ uiViewController: UIViewController, context: Context) {
+        // Update preview layer frame if needed
+        if let previewLayer = uiViewController.view.layer.sublayers?.first as? AVCaptureVideoPreviewLayer {
+            previewLayer.frame = CGRect(x: 0, y: 0, width: cameraSize, height:cameraSize)
+        }
+    }
+    
+}
+

package/ios/FaceAISDK/FaceSDKLocalizer.swift

@@ -0,0 +1,21 @@
+import Foundation
+
+@objcMembers
+public class FaceSDKLocalizer: NSObject {
+    /// 统一的多语言获取方法
+    /// - Parameters:
+    ///   - key: 多语言 Key
+    ///   - defaultValue: 如果找不到则返回的默认字符串
+    /// - Returns: 翻译后的字符串
+    public static func text(_ key: String, defaultValue: String? = nil) -> String {
+        // 使用 NSLocalizedString 从 Localizable.strings 中查找
+        let localizedString = NSLocalizedString(key, comment: "")
+
+        // 如果返回的字符串与 Key 相同，说明没有找到对应的翻译
+        if localizedString == key {
+            return defaultValue ?? key
+        }
+
+        return localizedString
+    }
+}

package/ios/FaceAISDK/LivenessDetectView.swift

@@ -0,0 +1,317 @@
+import SwiftUI
+import AVFoundation
+import FaceAISDK_Core
+
+/**
+ * Liveness Detection (Supports motion, color flash, and silent liveness)
+ * UI style is for reference only and can be adjusted according to your business needs
+ * 活体检测（支持动作活体，炫彩活体，静默活体）UI 样式仅供参考，根据你的业务可自行调整
+ */
+struct LivenessDetectView: View {
+    @StateObject private var viewModel: VerifyFaceModel = VerifyFaceModel()
+    @State private var showToast = false
+    @State private var showLightHighDialog = false
+    @State private var showFailureDialog = false
+    @State private var isTipAppeared = false
+    
+    @Environment(\.dismiss) private var dismiss
+
+    // Automatically control screen brightness
+    // 自动控制屏幕亮度
+    var autoControlBrightness: Bool = true
+    
+    // 0. No liveness detection  1. Motion only  2. Motion + Color flash  3. Color flash only
+    // 0. 无需活体检测 1.仅仅动作 2.动作+炫彩 3.炫彩
+    let livenessType:Int
+    
+    // Types of motion liveness:  1. Open mouth  2. Smile  3. Blink  4. Shake head  5. Nod
+    // 动作活体种类：1. 张张嘴  2.微笑  3.眨眨眼  4.摇摇头  5.点头
+    let motionLiveness:String
+    
+    // Timeout in seconds
+    // 动作活体超时时间，秒
+    let motionLivenessTimeOut:Int
+    
+    // Number of motion steps
+    // 动作活体个数
+    let motionLivenessSteps:Int
+    
+    // show Result Tips? For Flutter,RN,UNIApp plugin
+    let showResultTips:Bool
+    
+    // callback status liveness score,多加一个参数吧message
+    let onDismiss: (Int, Float) -> Void
+    
+    // Multi-language tips can be provided based on the Code
+    // 可以根据Code进行多语言提示
+    private func localizedTip(for code: Int) -> String {
+        let key = "Face_Tips_Code_\(code)"
+        let defaultValue = "LivenessDetect Tips Code=\(code)"
+        let tipsString = NSLocalizedString(key, value: defaultValue, comment: "")
+        if code != 0 && code != 1 && code != 3 {
+            TTSPlayer.shared.speak(tipsString)
+        }
+        return tipsString
+    }
+    
+    
+    var body: some View {
+        ZStack {
+            VStack {
+                HStack {
+                    Button(action: {
+                        // 0 represents user cancellation 0代表用户取消
+                        onDismiss(0,0.0)
+                        dismiss()
+                    }) {
+                        Image(systemName: "chevron.left")
+                            .font(.system(size: 16, weight: .semibold))
+                            .foregroundColor(.black)
+                            .padding(10)
+                            .background(Color.gray.opacity(0.1))
+                            .clipShape(Circle())
+                    }
+                    Spacer()
+                }
+                .padding(.horizontal, 10)
+                .padding(.top, 10)
+                
+                
+                if isTipAppeared {
+                    Text(localizedTip(for: viewModel.sdkInterfaceTips.code))
+                        .font(.system(size: 20).bold())
+                        .padding(.horizontal, 20)
+                        .padding(.vertical, 8)
+                        .foregroundColor(.white)
+                        .background(Color.faceMain)
+                        .cornerRadius(20)
+                        .id(viewModel.sdkInterfaceTips.code)
+                        .transition(.asymmetric(
+                            insertion: .scale(scale: 0.8).combined(with: .opacity),
+                            removal: .opacity
+                        ))
+                        .animation(.spring(response: 0.4, dampingFraction: 0.6), value: viewModel.sdkInterfaceTips.code)
+                }
+                
+                
+                Text(localizedTip(for: viewModel.sdkInterfaceTipsExtra.code))
+                    .font(.system(size: 20).bold())
+                    .multilineTextAlignment(.center)
+                    .padding(.bottom, 8)
+                    .frame(minHeight: 30)
+                    .foregroundColor(.black)
+                
+                FaceSDKCameraView(session: viewModel.captureSession, cameraSize: FaceCameraSize)
+                    .frame(width: FaceCameraSize, height: FaceCameraSize)
+                    .aspectRatio(1.0, contentMode: .fit)
+                    .padding(.vertical, 8)
+                    .clipShape(Circle())
+                
+                Spacer()
+            }
+            .padding()
+            .frame(maxWidth: .infinity, maxHeight: .infinity)
+            .background(viewModel.colorFlash.ignoresSafeArea())
+            .navigationBarBackButtonHidden(true)
+            .navigationBarHidden(true)
+
+             if showToast && showResultTips {
+                 // iOS 静默活体通过分数暂时调低为0.72
+                 let isSuccess = viewModel.faceVerifyResult.liveness > 0.72
+                 let toastStyle: ToastStyle = isSuccess ? .success : .failure
+                 
+                VStack {
+
+                    Spacer()
+                    CustomToastView(
+                        message: "\(viewModel.faceVerifyResult.tips) \(viewModel.faceVerifyResult.liveness)",
+                        style: toastStyle
+                    )
+                     .padding(.bottom, 77)
+                }
+                .frame(maxWidth: .infinity, maxHeight: .infinity)
+                .transition(.move(edge: .bottom).combined(with: .opacity))
+                .zIndex(1)
+            }
+            
+            // Custom dialog for high light levels,光线过强自定义弹窗 (Dialog)
+            if showLightHighDialog {
+                ZStack {
+                    VStack(spacing: 22) {
+                        Text(viewModel.faceVerifyResult.tips)
+                            .font(.system(size: 16).bold())
+                            .fontWeight(.semibold)
+                            .multilineTextAlignment(.center)
+                            .foregroundColor(.black)
+                            .padding(.horizontal,25)
+
+
+                        if let uiImage = UIImage(named: "light_too_high") {
+                                    Image(uiImage: uiImage)
+                                        .resizable()
+                                        .scaledToFit()
+                                        .frame(maxHeight: 120)
+                                        .padding(.horizontal,1)}
+                        
+                        Button(action: {
+                            withAnimation {
+                                showLightHighDialog = false
+                                onDismiss(viewModel.faceVerifyResult.code,viewModel.faceVerifyResult.liveness)
+                                dismiss()
+                            }
+                        }) {
+                            Text("Confirm")
+                                .font(.system(size: 18).bold())
+                                .foregroundColor(.white)
+                                .frame(maxWidth: .infinity)
+                                .padding(.vertical, 10)
+                                .background(Color.faceMain)
+                                .cornerRadius(10)
+                        }
+                        .padding(.horizontal, 30)
+                    }
+                    .padding(.vertical, 22)
+                    .background(Color.white)
+                    .cornerRadius(20)
+                    .shadow(color: Color.black.opacity(0.2), radius: 20, x: 0, y: 10)
+                    .padding(.horizontal, 30)
+                }
+                .zIndex(2)
+                .transition(.scale(scale: 0.8).combined(with: .opacity))
+            }
+
+            // Failure dialog when liveness detection fails (两按钮：知道了 / 重试)
+            if showFailureDialog {
+                ZStack {
+                    VStack(spacing: 18) {
+                        Text(viewModel.faceVerifyResult.tips)
+                            .font(.system(size: 18).bold())
+                            .fontWeight(.semibold)
+                            .multilineTextAlignment(.center)
+                            .foregroundColor(.black)
+                            .padding(.vertical,18)
+
+                        HStack(spacing: 12) {
+                            Button(action: {
+                                withAnimation {
+                                    showFailureDialog = false
+                                    showToast = true
+                                    _ = FaceImageManager.saveFaceImage(faceName: "Liveness", faceImage: viewModel.faceVerifyResult.faceImage)
+                                }
+                                DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
+                                    withAnimation { showToast = false }
+                                    onDismiss(viewModel.faceVerifyResult.code, viewModel.faceVerifyResult.liveness)
+                                    dismiss()
+                                }
+                            }) {
+                                Text("I Know")
+                                    .font(.system(size: 18).bold())
+                                    .foregroundColor(.black)
+                                    .frame(maxWidth: .infinity)
+                                    .padding(.vertical, 10)
+                                    .background(Color.white)
+                                    .cornerRadius(10)
+                                    .overlay(
+                                        RoundedRectangle(cornerRadius: 10)
+                                            .stroke(Color.gray.opacity(0.2), lineWidth: 1)
+                                    )
+                            }
+
+                            Button(action: {
+                                withAnimation {
+                                    showFailureDialog = false
+                                }
+                                viewModel.reInit() //重新
+                            }) {
+                                Text("Retry")
+                                    .font(.system(size: 18).bold())
+                                    .foregroundColor(.white)
+                                    .frame(maxWidth: .infinity)
+                                    .padding(.vertical, 10)
+                                    .background(Color.faceMain)
+                                    .cornerRadius(10)
+                            }
+                        }
+                        .padding(.horizontal, 12)
+                    }
+                    .padding(.vertical, 18)
+                    .background(Color.white)
+                    .cornerRadius(20)
+                    .shadow(color: Color.black.opacity(0.2), radius: 20, x: 0, y: 10)
+                    .padding(.horizontal, 30)
+                }
+                .zIndex(2)
+                .transition(.scale(scale: 0.8).combined(with: .opacity))
+            }
+            
+        }
+        .onAppear {
+            if autoControlBrightness {
+                ScreenBrightnessHelper.shared.maximizeBrightness()
+            }
+            withAnimation(.spring(response: 0.6, dampingFraction: 0.7).delay(0.9)) {
+                isTipAppeared = true
+            }
+            
+            withAnimation(.easeInOut(duration: 0.3)) {
+                UIScreen.main.brightness = 1.0
+            }
+            
+            viewModel.initFaceAISDK(faceIDFeature: "",
+                                    livenessType: livenessType,
+                                    onlyLiveness: true,
+                                    motionLiveness: motionLiveness,
+                                    motionLivenessTimeOut:motionLivenessTimeOut,
+                                    motionLivenessSteps:motionLivenessSteps)
+        }
+        .onChange(of: viewModel.faceVerifyResult.code) { newValue in
+            // 忽略默认状态（例如刚初始化或重试时变成 0），避免直接掉入底部的默认退出流程
+            if newValue == VerifyResultCode.DEFAULT { return }
+            
+            // 根据不同的 code 值来决定是否显示 toast 或者弹窗
+            // 优先处理光线过强的专用弹窗
+            if newValue == VerifyResultCode.COLOR_LIVENESS_LIGHT_TOO_HIGH {
+                withAnimation {
+                    showLightHighDialog = true
+                }
+                return
+            }
+
+            // 如果是下列失败码之一，则弹出失败对话框（允许用户知道了或重试），并返回以避免继续执行默认的 toast/退出流程
+            let failureCodes: [Int] = [
+                VerifyResultCode.MOTION_LIVENESS_TIMEOUT,
+                VerifyResultCode.NO_FACE_MULTI,
+                VerifyResultCode.COLOR_LIVENESS_FAILED,
+                VerifyResultCode.SILENT_LIVENESS_FAILED
+            ]
+
+            if failureCodes.contains(newValue) {
+                withAnimation {
+                    showFailureDialog = true
+                }
+                return
+            }
+
+            // 其余情况沿用原有流程：展示 toast -> 回调 -> 退出
+            withAnimation {
+                showFailureDialog = false
+                showToast = true
+                _ = FaceImageManager.saveFaceImage(faceName: "Liveness", faceImage: viewModel.faceVerifyResult.faceImage)
+            }
+            DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
+                withAnimation { showToast = false }
+                onDismiss(viewModel.faceVerifyResult.code, viewModel.faceVerifyResult.liveness)
+                dismiss()
+            }
+            
+        }
+        .onDisappear {
+            if autoControlBrightness {
+                ScreenBrightnessHelper.shared.restoreBrightness()
+            }
+            
+            viewModel.stopFaceVerify()
+        }
+        .animation(.easeInOut(duration: 0.3), value: showToast)
+    }
+}