face_detector_init

ZumiAI.face_detector_init(face_recognize_threshold=0.8)

스트리밍되는 카메라 영상에서 얼굴 인식 기능을 초기화합니다.

이 함수는 주미에서 PC로 전송되는 실시간 영상 스트림을 사용하여 컴퓨터에서 사람의 얼굴을 인식할 수 있도록 필요한 설정과 리소스(예: 얼굴 인식 모델)를 준비합니다. 얼굴 인식은 단순히 얼굴이 감지되는 것을 넘어, 학습된 특정 얼굴을 구별하는 기능입니다.

매개변수:

face_recognize_threshold (float, optional) –

얼굴 인식의 정확도 임계값을 설정합니다. 기본값은 0.8이며, 0.0부터 1.0 사이의 값을 가집니다.

• 값이 높을수록: 더 엄격한 기준으로 얼굴을 비교하여 오인식률은 낮아지지만, 인식 성공률이 떨어질 수 있습니다.

• 값이 낮을수록: 좀 더 관대한 기준으로 얼굴을 비교하여 인식 성공률은 높아지지만, 오인식률이 증가할 수 있습니다.

반환:

이 함수는 값을 반환하지 않습니다.

예제

>>> zumiAI.camera_stream_start() # 먼저 카메라 스트리밍 시작
>>> zumiAI.face_detector_init() # 기본 임계값 0.8로 PC 기반 얼굴 인식 기능 초기화
>>> zumiAI.face_detector_init(face_recognize_threshold=0.7) # 임계값을 0.7로 설정하여 초기화
>>> zumiAI.face_detector_start() # 얼굴 인식 시작
# ... 얼굴 인식 로직 ...
>>> zumiAI.face_detector_stop() # 얼굴 인식 중지

참고

• 얼굴 인식을 사용하기 전에 camera_stream_start() 함수를 호출하여 영상 스트리밍을 시작해야 합니다.

• 이 함수로 초기화한 후, face_detector_start() 함수를 호출해야 실제로 얼굴 인식이 시작됩니다.

• 이 기능은 주미 자체의 하드웨어에서 처리되는 얼굴 감지/인식 기능과는 다릅니다.