@faceaisdk/react-native-face-sdk 0.1.1

package/ios/FaceAISDK/VerifyFaceView.swift

@@ -0,0 +1,284 @@
+import SwiftUI
+import FaceAISDK_Core
+
+/**
+ * 1:1 Face Verification and Liveness Detection
+ * 1:1 人脸识别以及活体检测
+ */
+struct VerifyFaceView: View {
+    @StateObject private var viewModel: VerifyFaceModel = VerifyFaceModel()
+    @Environment(\.dismiss) private var dismiss
+    // Prompt that the ambient light is too bright
+    // 提示环境光太亮
+    @State private var showLightHighDialog = false
+    @State private var showToast = false
+    @State private var toastViewTips: String = ""
+    @State private var isTipAppeared = false
+    
+    
+    // Automatically control screen brightness
+    // 自动控制屏幕亮度
+    var autoControlBrightness: Bool = true
+    var retryTime:Int = 0; //记录失败尝试的次数
+
+    let faceID: String
+    let threshold: Float
+    
+    // 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
+    
+    // Motion liveness timeout (seconds)
+    // 动作活体超时（秒）
+    let motionLivenessTimeOut:Int
+    
+    // Number of motion liveness steps
+    // 动作活体步骤个数
+    let motionLivenessSteps:Int
+    
+    // Callback status, face similarity, liveness score
+    // 返回状态，人脸相似度，活体分数
+    let onDismiss: (Int, Float, Float) -> Void
+
+    // Multi-language tips
+    // 多语言提示
+    private func localizedTip(for code: Int) -> String {
+        let key = "Face_Tips_Code_\(code)"
+        let defaultValue = "VerifyFace 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 代表用户取消
+                        onDismiss(0, 0.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, 2)
+                .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())
+                    .padding(.bottom, 6)
+                    .frame(minHeight: 30)
+                    .foregroundColor(.black)
+                
+                FaceSDKCameraView(session: viewModel.captureSession, cameraSize: FaceCameraSize)
+                    .frame(
+                        width: FaceCameraSize,
+                        height: FaceCameraSize
+                    )
+                    .padding(.vertical, 8)
+                    .aspectRatio(1.0, contentMode: .fit)
+                    .clipShape(Circle())
+                    .overlay(Circle().stroke(Color.gray, lineWidth: 1))
+
+                Spacer()
+            }
+            .padding()
+            .frame(maxWidth: .infinity, maxHeight: .infinity)
+            .background(viewModel.colorFlash.ignoresSafeArea())
+            // Hide system navigation bar
+            // 隐藏系统导航栏
+            .navigationBarBackButtonHidden(true)
+            .navigationBarHidden(true)
+            
+            if showToast {
+
+                let similarity = String(format: "%.2f", viewModel.faceVerifyResult.similarity)
+                // Prefer manually set toastViewTips (for handling missing feature values), otherwise use tips returned by SDK
+                // 优先使用手动设置的 toastViewTips (用于处理无特征值的情况)，否则使用 SDK 返回的 tips
+                let displayTips = toastViewTips.isEmpty ? viewModel.faceVerifyResult.tips : toastViewTips
+                let displayMessage = (toastViewTips.isEmpty) ? "\(displayTips)" : displayTips
+                
+                // Calculate style: If it's a missing feature error or low similarity, it's a failure
+                // 计算样式：如果是无特征值错误，或者相似度低，则为 failure
+                let isSuccess = viewModel.faceVerifyResult.similarity > threshold && viewModel.faceVerifyResult.liveness>0.72
+                let toastStyle: ToastStyle = isSuccess ? .success : .failure
+                
+                VStack {
+                    Spacer()
+                    CustomToastView(
+                        message: displayMessage,
+                        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.similarity,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))
+            }
+        }
+         .onAppear {
+             
+             withAnimation(.spring(response: 0.6, dampingFraction: 0.7).delay(0.9)) {
+                 isTipAppeared = true
+             }
+             
+             if autoControlBrightness {
+                 ScreenBrightnessHelper.shared.maximizeBrightness()
+             }
+             
+             withAnimation(.easeInOut(duration: 0.3)) {
+                UIScreen.main.brightness = 1.0
+            }
+            
+            // Check if there is a local feature value
+            // 校验本地是否有特征值
+            guard let faceFeature = UserDefaults.standard.string(forKey: faceID) else {
+                toastViewTips = "No Face Feature for : \(faceID)"
+                showToast = true
+                
+                DispatchQueue.main.asyncAfter(deadline: .now() + 1.5) {
+                    showToast = false
+                    // Callback NO_FACE_FEATURE
+                    // 返回无特征值状态
+                    onDismiss(6,0.0,0.0)
+                    dismiss()
+                }
+                return
+            }
+             
+             
+             guard faceFeature.count >= 1024 else {
+                 toastViewTips = "Invalid Feature length for : \(faceID)"
+                 showToast = true
+                 
+                 DispatchQueue.main.asyncAfter(deadline: .now() + 1.5) {
+                     showToast = false
+                     onDismiss(6, 0.0, 0.0)
+                     dismiss()
+                 }
+                 return
+             }
+             
+            viewModel.initFaceAISDK(
+                faceIDFeature: faceFeature,
+                threshold: threshold,
+                livenessType: livenessType,
+                onlyLiveness: false,
+                motionLiveness: motionLiveness,
+                motionLivenessTimeOut:motionLivenessTimeOut,
+                motionLivenessSteps:motionLivenessSteps
+            )
+        }
+        //和Android 一样允许重试，而不是立即结束整个流程
+        .onChange(of: viewModel.faceVerifyResult.code) { newValue in
+            // Clear manual tips, use SDK results
+            // 清空手动的 tips，使用 SDK 的结果
+            toastViewTips = ""
+            
+            if newValue == VerifyResultCode.COLOR_LIVENESS_LIGHT_TOO_HIGH{
+                // Light is too strong 光线太强了
+                withAnimation {
+                    showLightHighDialog = true
+                }
+            }else{
+                showToast = true
+                
+                if FaceImageManager.saveFaceImage(faceName: faceID, faceImage: viewModel.faceVerifyResult.faceImage){
+                    print("saveFaceImage success ")
+                }
+
+                DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
+                    withAnimation {
+                        showToast = false
+                    }
+                    onDismiss(viewModel.faceVerifyResult.code,viewModel.faceVerifyResult.similarity,viewModel.faceVerifyResult.liveness)
+                    dismiss()
+                }
+            }
+        }
+        .onDisappear {
+            if autoControlBrightness {
+                ScreenBrightnessHelper.shared.restoreBrightness()
+            }
+            
+            viewModel.stopFaceVerify()
+        }
+        .animation(.easeInOut(duration: 0.3), value: showToast)
+    }
+}

package/ios/FaceAISDK/addFace/AddFaceByCamera.swift

@@ -0,0 +1,207 @@
+import SwiftUI
+import AVFoundation
+import FaceAISDK_Core
+
+@MainActor
+var FaceCameraSize: CGFloat {
+    14 * min(UIScreen.main.bounds.width, UIScreen.main.bounds.height) / 20
+}
+
+public struct AddFaceByCamera: View {
+    let faceID: String
+    let addFacePerformanceMode: Int //Alternate fields备用字段
+    let needShowConfirmDialog: Bool
+    
+    // callback Status , FaceFeature
+    let onDismiss: (Int, String) -> Void //status 0 cancel， 1 success
+    
+    var autoControlBrightness: Bool = true
+    
+    @Environment(\.dismiss) private var dismiss
+    
+    @StateObject private var viewModel: AddFaceByCameraModel = AddFaceByCameraModel()
+    
+    // 根据状态码转换为对应的文字提示
+    private func localizedTip(for code: Int) -> String {
+        let key = "Face_Tips_Code_\(code)"
+        let defaultValue = "Add Face Tips Code=\(code)"
+        let tipsString = NSLocalizedString(key, value: defaultValue, comment: "")
+        if code != 0 && code != 1 && code != 11 {
+            TTSPlayer.shared.speak(tipsString)
+        }
+        return tipsString
+    }
+    
+    // 统一处理人脸录入成功的逻辑
+    private func handleFaceAddSuccess() {
+        // Optional
+         if FaceImageManager.saveFaceImage(faceName: faceID, faceImage: viewModel.croppedFaceImage) {
+             print("saveFaceImage success")
+         }
+        
+        // Save face feature 保存人脸特征信息，
+        UserDefaults.standard.set(viewModel.faceFeatureBySDKCamera, forKey: faceID)
+        
+        // Close Page, CallBack
+        DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
+            onDismiss(1, viewModel.faceFeatureBySDKCamera)
+            dismiss()
+        }
+        
+    }
+    
+    public var body: some View {
+        ZStack {
+            VStack(spacing: 20) {
+                HStack {
+                    Button(action: {
+                        onDismiss(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, 2)
+                .padding(.top, 10)
+                
+                // Status Tips
+                Text(localizedTip(for: viewModel.sdkInterfaceTips.code))
+                    .font(.system(size: 19).bold())
+                    .padding(.horizontal, 20)
+                    .padding(.vertical, 8)
+                    .foregroundColor(.white)
+                    .background(Color.faceMain)
+                    .cornerRadius(20)
+                
+                ZStack {
+                    // Camera
+                    FaceSDKCameraView(session: viewModel.captureSession, cameraSize: FaceCameraSize)
+                        .aspectRatio(1.0, contentMode: .fit)
+                        .clipShape(Circle())
+                        .background(Circle().fill(Color.white))
+                        .overlay(Circle().stroke(Color.gray, lineWidth: 1))
+                    
+                    // Confirm Add Face
+                    if viewModel.readyConfirmFace && needShowConfirmDialog {
+                        Color.black.opacity(0.3)
+                            .clipShape(Circle())
+                        
+                        ConfirmAddFaceDialog(
+                            viewModel: viewModel,
+                            cameraSize: FaceCameraSize,
+                            onConfirm: {
+                                handleFaceAddSuccess()
+                            }
+                        )
+                        .transition(.scale.combined(with: .opacity))
+                    }
+                }
+                .frame(width: FaceCameraSize, height: FaceCameraSize)
+                .animation(.easeInOut(duration: 0.25), value: viewModel.readyConfirmFace)
+                
+                Spacer()
+            }
+            .padding()
+            .frame(maxWidth: .infinity, maxHeight: .infinity)
+            .background(Color.white.ignoresSafeArea())
+            .navigationBarBackButtonHidden(true)
+            .navigationBarHidden(true)
+            
+            .onAppear {
+                if autoControlBrightness {
+                    ScreenBrightnessHelper.shared.maximizeBrightness()
+                }
+                viewModel.initAddFace()
+            }
+            .onDisappear {
+                if autoControlBrightness {
+                    ScreenBrightnessHelper.shared.restoreBrightness()
+                }
+                viewModel.stopAddFace()
+            }
+            .onChange(of: viewModel.sdkInterfaceTips.code) { newValue in
+                print("🔔 AddFaceBySDKCamera： \(viewModel.sdkInterfaceTips.message)")
+            }
+            .onChange(of: viewModel.readyConfirmFace) { isReady in
+                if isReady && !needShowConfirmDialog {
+                    handleFaceAddSuccess()
+                }
+            }
+        }
+    }
+}
+
+
+struct ConfirmAddFaceDialog: View {
+    let viewModel: AddFaceByCameraModel
+    let cameraSize: CGFloat
+    let onConfirm: () -> Void
+    
+    var body: some View {
+        VStack(alignment: .center, spacing: 15) {
+            
+            Text("Confirm Add Face")
+                .font(.system(size: 19, weight: .semibold))
+                .foregroundColor(Color.faceMain)
+                .padding(.top, 18)
+            
+            //
+            Image(uiImage: viewModel.originFaceImage)
+                .resizable()
+                .scaledToFill()
+                .frame(width: 190, height: 220)
+                .clipShape(RoundedRectangle(cornerRadius: 12))
+                .overlay(
+                    RoundedRectangle(cornerRadius: 12)
+                        .stroke(Color.gray.opacity(0.2), lineWidth: 1)
+                )
+                .shadow(color: Color.black.opacity(0.1), radius: 4, x: 0, y: 2)
+
+            Text("Ensure face is clear")
+                .font(.system(size: 15))
+                .foregroundColor(.gray)
+                .multilineTextAlignment(.center)
+                .padding(.horizontal)
+            
+            // 按钮组
+            HStack(spacing: 12) {
+                Button(action: {
+                    viewModel.reInit()
+                }) {
+                    Text("Retry")
+                        .font(.system(size: 16, weight: .medium))
+                        .frame(maxWidth: .infinity)
+                        .frame(height: 45)
+                        .background(Color.gray.opacity(0.6))
+                        .foregroundColor(.primary)
+                        .cornerRadius(8)
+                }
+                
+                Button(action: {
+                    onConfirm()
+                }) {
+                    Text("Confirm")
+                        .font(.system(size: 16, weight: .bold))
+                        .frame(maxWidth: .infinity)
+                        .frame(height: 44)
+                        .background(Color.faceMain)
+                        .foregroundColor(.white)
+                        .cornerRadius(8)
+                }
+            }
+            .padding(.horizontal, 16)
+            .padding(.bottom, 16)
+            .padding(.top, 8)
+        }
+        .frame(width: cameraSize * 1.22)
+        .background(Color.white)
+        .cornerRadius(16)
+        .shadow(color: Color.black.opacity(0.2), radius: 10, x: 0, y: 5)
+    }
+}

package/ios/FaceAISDK/addFace/AddFaceByImage.swift

@@ -0,0 +1,174 @@
+import SwiftUI
+import PhotosUI
+import FaceAISDK_Core
+
+// 从相册添加人脸
+public struct AddFaceByImage: View {
+
+    @State private var showImagePicker = false
+    @State private var isLoading = false
+    @State private var canSave = false
+
+    // 用于显示和处理的 Image
+    @State private var selectedImage: UIImage?
+    
+    @StateObject private var viewModel: AddFaceByImageModel = AddFaceByImageModel()
+    
+    let faceID: String
+    let onDismiss: (Int, String?) -> Void // 0 用户取消， 1 添加成功
+
+    @Environment(\.dismiss) private var dismiss
+    
+
+    private func localizedTip(for code: Int) -> String {
+        let key = "Face_Tips_Code_\(code)"
+        let defaultValue = "LivenessDetect Tips Code=\(code)"
+        return NSLocalizedString(key, value: defaultValue, comment: "")
+    }
+    
+    public var body: some View {
+        ZStack {
+            VStack(spacing: 20) {
+                
+                HStack {
+                    // 左侧返回按钮
+                    Button(action: {
+                        onDismiss(0, nil)
+                        dismiss()
+                    }) {
+                        Image(systemName: "chevron.left")
+                            .font(.system(size: 16, weight: .semibold))
+                            .foregroundColor(.black)
+                            .padding(10)
+                            .background(Color.gray.opacity(0.1))
+                            .clipShape(Circle())
+                    }
+                    
+                    // 中间标题
+                    Text("Add Face From Album")
+                        .font(.system(size: 18, weight: .bold))
+                        .foregroundColor(.black)
+                    
+                    Spacer()
+
+                }
+                .padding(.horizontal, 20)
+                .padding(.top, 10)
+                
+                ScrollView {
+                    VStack(spacing: 25) {
+                        
+                        Text(viewModel.message)
+                                .font(.system(size: 17).bold())
+                                .padding(.vertical, 12)
+                                .padding(.horizontal, 24)
+                                .foregroundColor(Color.faceMain)
+                                .cornerRadius(20)
+                                .shadow(color: Color.black.opacity(0.1), radius: 5, x: 0, y: 2)
+                    
+                        // 2. 图片预览区 (作为点击触发热区)
+                        Group {
+                            if let selectedImage {
+                                ZStack {
+                                    Image(uiImage: selectedImage)
+                                        .resizable()
+                                        .scaledToFit()
+                                        .frame(maxWidth: 166, maxHeight: 166)
+                                        .clipShape(RoundedRectangle(cornerRadius: 16))
+                                        .shadow(radius: 8)
+                                    
+                                    if isLoading {
+                                        ZStack {
+                                            Color.black.opacity(0.4)
+                                                .clipShape(RoundedRectangle(cornerRadius: 16))
+                                            ProgressView()
+                                                .scaleEffect(1.5)
+                                                .tint(.white)
+                                        }
+                                        .frame(maxWidth: 166, maxHeight: 166)
+                                    }
+                                }
+                            } else {
+                                VStack(spacing: 12) {
+                                    Image(systemName: "photo.fill")
+                                        .resizable()
+                                        .scaledToFit()
+                                        .frame(width: 80, height: 80)
+                                        .foregroundStyle(.tertiary)
+                                    
+                                    Text("Select from album")
+                                        .font(.system(size: 13))
+                                        .foregroundStyle(.secondary)
+                                }
+                                .frame(width: 166, height: 166)
+                                .background(Color.gray.opacity(0.05))
+                                .cornerRadius(16)
+                                .overlay(
+                                    RoundedRectangle(cornerRadius: 16)
+                                        .stroke(Color.gray.opacity(0.2), style: StrokeStyle(lineWidth: 1, dash: [5]))
+                                )
+                            }
+                        }
+                        .onTapGesture {
+                            showImagePicker = true
+                        }
+                        
+                        Button(action: {
+                            // 此时 viewModel.croppedFaceImage 已经被 async 方法更新为对齐后的图
+                            let feature = viewModel.getFaceFeature(faceUIImage: viewModel.croppedFaceImage)
+                            if !feature.isEmpty {
+                                
+                                //保存人脸特征信息，Save face feature
+                                UserDefaults.standard.set(feature, forKey: faceID)
+                                onDismiss(1, feature)
+                                dismiss()
+                            }
+                            
+                        }) {
+                            Text("Save Face Feature")
+                                .font(.headline)
+                                .frame(maxWidth: .infinity)
+                                .frame(height: 36)
+                        }
+                        .buttonStyle(.borderedProminent)
+                        .tint(canSave ? .green : .gray)
+                        .disabled(!canSave)
+                        .padding(.horizontal, 40)
+                    }
+                    .padding(.bottom, 20)
+                }
+            }
+            .background(Color.white.ignoresSafeArea())
+            .navigationBarBackButtonHidden(true)
+            .navigationBarHidden(true)
+            
+            .onChange(of: viewModel.croppedFaceImage) { newValue in
+                withAnimation {
+                    selectedImage = newValue
+                    isLoading = false
+                    canSave = true
+                }
+            }
+            
+            .sheet(isPresented: $showImagePicker) {
+                ImagePicker(selectedImage: $selectedImage) { uiImage in
+                    isLoading = true
+                    canSave = false
+                    
+                    // 异步方法必须在 Task 中调用
+                    Task {
+                        await viewModel.addFaceByUIImageAsync(faceUIImage: uiImage)
+                    }
+                    
+                    
+//                    Task {
+//                        let faceFeature = await viewModel.addFaceByBase64Async(base64: "your Base64 String")
+//                        print("return faceFeature:"+faceFeature)
+//                    }
+                    
+                }
+            }
+            
+        }
+    }
+}