is_face_detected

ZumiAI.is_face_detected(name: str = 'Unknown') → bool

스트리밍되는 카메라 영상에서 특정 이름의 얼굴이 감지되었는지 확인합니다.

이 함수는 face_detector_start() 로 시작된 얼굴 인식 기능이 활성화된 상태에서, PC 화면에 스트리밍되는 영상에 지정된 name을 가진 얼굴이 있는지 여부를 반환합니다.

매개변수:

name (str, optional) – 감지 여부를 확인할 등록된 얼굴의 이름. 기본값은 “Unknown”이며, 이 경우 ‘알 수 없는’ 또는 ‘등록되지 않은’ 얼굴의 감지 여부를 확인합니다.

반환:

지정된 name을 가진 얼굴이 영상에서 감지되었는지 여부.

  • True: 해당 이름의 얼굴이 현재 영상에서 감지되었습니다.

  • False: 해당 이름의 얼굴이 현재 영상에서 감지되지 않았습니다.

반환 형식:

bool

예제

>>> zumiAI.camera_stream_start()
>>> zumiAI.face_detector_init()
>>> zumiAI.face_detector_start()
>>>
>>> # '학생1'이라는 이름의 얼굴이 감지되었는지 확인
>>> detected_student = zumiAI.is_face_detected(name="학생1")
>>> print(f"'학생1' 감지 여부: {detected_student}")
'학생1' 감지 여부: True # 예시 출력: '학생1' 얼굴이 감지됨

>>> # 'Unknown'(알 수 없는) 얼굴이 감지되었는지 확인
>>> detected_unknown = zumiAI.is_face_detected() # 또는 is_face_detected("Unknown")
>>> print(f"알 수 없는 얼굴 감지 여부: {detected_unknown}")
알 수 없는 얼굴 감지 여부: False # 예시 출력: 알 수 없는 얼굴이 감지되지 않음

참고

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

  • 이 기능은 주미 자체의 하드웨어 기능이 아니라, PC 기반 소프트웨어로 처리됩니다.