使用 Next.js 和 FACEIOm 建立具有臉部辨識功能的輔助系統

執行摘要

在數位轉型時代，傳統的考勤追蹤正在迅速過時。我們的尖端解決方案利用先進的臉部辨識技術、Next.js 和 Faceio 創建一個複雜、安全和智慧的考勤管理生態系統。

介紹

對組織來說，考勤管理歷來是一項耗時且容易出錯的任務。 FACEIO 的創新系統透過引入先進的臉部辨識技術改變了這種模式，提供了可提高安全性和使用者體驗的簡化流程。

FACEIO 現代輔助系統

由 FACEIO 支援的現代考勤系統標誌著組織利用尖端的臉部辨識技術追蹤考勤方式的變革。這種先進的系統以無縫、安全和高效的非接觸式解決方案取代了手動簽到和基於卡片的系統等傳統方法。 FACEIO 優先考慮準確性、詐欺預防和用戶隱私，使其成為考勤管理中的革命性元素。

安裝包

專案結構

環境設定

Next.js 配置

供應商配置

針對 IO 上下文

// src/context/FaceIOContext.tsx
'use client';

import React, { 
  createContext, 
  useState, 
  useContext, 
  useEffect, 
  ReactNode 
} from 'react';
import faceIO from '@faceio/fiojs';

interface FaceIOContextType {
  faceioInstance: any;
  error: Error | null;
}

const FaceIOContext = createContext<FaceIOContextType>({
  faceioInstance: null,
  error: null,
});

export const FaceIOProvider = ({ children }: { children: ReactNode }) => {
  const [faceioInstance, setFaceioInstance] = useState<any>(null);
  const [error, setError] = useState<Error | null>(null);

  useEffect(() => {
    const initializeFaceIO = async () => {
      try {
        if (process.env.NEXT_PUBLIC_FACEIO_PUBLIC_KEY) {
          const instance = new faceIO(process.env.NEXT_PUBLIC_FACEIO_PUBLIC_KEY);
          setFaceioInstance(instance);
        } else {
          throw new Error('FACEIO Public Key is not configured');
        }
      } catch (err) {
        console.error('Face Recognition Initialization Failed', err);
        setError(err instanceof Error ? err : new Error('Initialization failed'));
      }
    };

    initializeFaceIO();
  }, []);

  return (
    <FaceIOContext.Provider value={{ faceioInstance, error }}>
      {children}
    </FaceIOContext.Provider>
  );
};

export const useFaceIO = () => useContext(FaceIOContext);

人臉辨識掛鉤

// src/hooks/useFaceRecognition.ts
'use client';

import { useState } from 'react';
import { useFaceIO } from '../context/FaceIOContext';

export function useFaceRecognition() {
  const { faceioInstance } = useFaceIO();
  const [isLoading, setIsLoading] = useState(false);
  const [error, setError] = useState<Error | null>(null);

  const enrollUser = async (userMetadata: Record<string, any>) => {
    if (!faceioInstance) {
      throw new Error('FaceIO not initialized');
    }

    setIsLoading(true);
    setError(null);

    try {
      const enrollResult = await faceioInstance.enroll({
        locale: "auto",
        payload: {
          ...userMetadata,
          enrollmentTimestamp: new Date().toISOString()
        }
      });

      setIsLoading(false);
      return {
        facialId: enrollResult.facialId,
        metadata: enrollResult
      };
    } catch (err) {
      setIsLoading(false);
      setError(err instanceof Error ? err : new Error('Enrollment failed'));
      throw err;
    }
  };

  const authenticateUser = async () => {
    if (!faceioInstance) {
      throw new Error('FaceIO not initialized');
    }

    setIsLoading(true);
    setError(null);

    try {
      const authResult = await faceioInstance.authenticate({
        locale: "auto"
      });

      setIsLoading(false);
      return {
        facialId: authResult.facialId,
        payload: authResult.payload
      };
    } catch (err) {
      setIsLoading(false);
      setError(err instanceof Error ? err : new Error('Authentication failed'));
      throw err;
    }
  };

  return { 
    enrollUser, 
    authenticateUser, 
    isLoading, 
    error 
  };
}

人臉辨識組件

// src/components/FaceRecognition.tsx
'use client';

import { useState } from 'react';
import { useFaceRecognition } from '../hooks/useFaceRecognition';

export function FaceRecognitionComponent() {
  const { enrollUser, authenticateUser, isLoading, error } = useFaceRecognition();
  const [userData, setUserData] = useState(null);

  const handleEnroll = async () => {
    try {
      const result = await enrollUser({
        username: 'example_user',
        email: 'user@example.com'
      });
      setUserData(result);
    } catch (err) {
      console.error('Enrollment error', err);
    }
  };

  const handleAuthenticate = async () => {
    try {
      const result = await authenticateUser();
      setUserData(result);
    } catch (err) {
      console.error('Authentication error', err);
    }
  };

  return (
    <div>
      {isLoading && <p>Processing...</p>}
      {error && <p>Error: {error.message}</p>}
      <button onClick={handleEnroll}>Enroll</button>
      <button onClick={handleAuthenticate}>Authenticate</button>
      {userData && <pre class="brush:php;toolbar:false">{JSON.stringify(userData, null, 2)}

}