get_detected_face_result

ZumiAI.get_detected_face_result() → tuple

스트리밍되는 카메라 영상에서 인식된 얼굴의 이름과 신뢰도 점수를 가져옵니다.

이 함수는 face_detector_start() 함수로 얼굴 인식이 활성화된 상태에서 현재 스트리밍 영상에 인식된 얼굴이 있다면, 가장 크게 감지된 얼굴이름과 해당 이름에 대한 신뢰도 점수를 튜플 형태로 반환합니다.

매개변수:

없음

반환:

얼굴의 이름과 신뢰도 점수를 담은 튜플.

• [0] 이름 (str): 인식된 얼굴의 이름 (예: “학생1”). 얼굴이 인식되지 않았다면 “Unknown” 또는 마지막으로 인식된 이름이 반환될 수 있습니다.

• [1] 신뢰도 점수 (float): 해당 이름에 대한 신뢰도 점수 (0.00 ~ 1.00). 얼굴이 인식되지 않았다면 0.00이 반환될 수 있습니다.

예시: (“학생1”, 0.95)

반환 형식:

tuple

예제

>>> zumiAI.camera_stream_start()  # 카메라 스트리밍 시작
>>> zumiAI.face_detector_init()   # 얼굴 인식 초기화
>>> zumiAI.face_detector_start()  # 얼굴 인식 시작

>>> while True:
>>>     name, score = zumiAI.get_detected_face_result()
>>>     if name != "Unknown" and score > 0.5: # Unknown이 아니며 신뢰도가 0.5보다 높을 때
>>>         print(f"인식된 얼굴: {name}, 신뢰도: {score:.2f}")
>>>     else:
>>>         print("얼굴 인식 대기 중...")
>>>     time.sleep(1) # 1초 대기

>>> zumiAI.face_detector_stop() # 얼굴 인식 중지

참고

• 이 함수를 사용하기 전에 camera_stream_start(), face_detector_init(), 그리고 face_detector_start() 함수를 순서대로 호출하여 스트리밍 및 얼굴 인식 기능을 활성화해야 합니다.

• face_recognize_threshold 값에 따라 신뢰도 점수가 달라질 수 있습니다.

• 이 함수는 한 번에 하나의 얼굴(가장 크게 감지된 얼굴)에 대한 정보만 반환합니다.