get_detected_face_name

ZumiAI.get_detected_face_name() → str

스트리밍되는 카메라 영상에서 인식된 첫 번째 얼굴의 이름을 가져옵니다.

이 함수는 face_detector_start() 함수로 얼굴 인식이 활성화된 상태에서, 현재 스트리밍 영상에 인식된 얼굴이 있다면 해당 얼굴의 등록된 이름을 반환합니다. 만약 인식된 얼굴이 없거나 등록되지 않은 얼굴이라면 “Unknown”을 반환합니다.

매개변수:

없음

반환:

인식된 얼굴의 이름.

• 등록된 이름 (str): 얼굴이 성공적으로 인식된 경우.

• ”Unknown” (str): 얼굴이 인식되지 않았거나, 등록되지 않은 얼굴인 경우.

반환 형식:

str

예제

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

>>> while True:
>>>     face_name = zumiAI.get_detected_face_name()
>>>     if face_name != "Unknown":
>>>         print(f"인식된 얼굴: {face_name}")
>>>     else:
>>>         print("얼굴 인식 대기 중... (알 수 없는 얼굴)")
>>>     time.sleep(1) # 1초 대기

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

참고

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

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