face_train

ZumiAI.face_train(name: str)

스트리밍되는 카메라 영상에서 새로운 얼굴을 학습시키고 등록합니다.

이 함수를 호출하면 주미의 카메라 영상이 PC로 스트리밍되는 화면에서 얼굴 학습 모드가 활성화됩니다. 이 모드에서는 키보드 입력을 통해 얼굴을 학습시키고 저장할 수 있습니다.

매개변수:

name (str) – 등록할 얼굴의 이름. 학습된 얼굴은 이 이름으로 저장됩니다.

반환:

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

예제

>>> zumiAI.camera_stream_start() # 카메라 스트리밍 시작 (필수)
>>> print("학습할 이름을 입력하세요 (예: '철수', '영희'):")
>>> user_name = input()
>>> zumiAI.face_train(name=user_name) # 입력된 이름으로 얼굴 학습 모드 시작
# 이제 PC 화면을 보면서 'r'키를 눌러 얼굴을 학습하고 'e'키로 종료하세요.
>>> print(f"'{user_name}' 얼굴 학습 모드가 종료되었습니다.")
# 학습된 얼굴은 이제 'face_detector_start()'로 인식될 수 있습니다.

참고

  • 학습 과정:
    1. face_train() 함수를 실행하면 얼굴 학습 모드가 시작됩니다.

    2. 화면에 얼굴이 인식된 상태에서 r 키를 누르면 현재 화면에 있는 얼굴이 한 장씩 캡처되어 학습됩니다.

    3. 얼굴이 인식되지 않은 상태에서 r 키를 누르면 학습되지 않으므로, 얼굴이 화면에 잘 보이도록 한 후 여러 번 r 키를 눌러 다양한 각도와 표정으로 학습시키는 것이 좋습니다.

    4. 충분히 학습되었다고 판단되면 e 키를 눌러 학습 모드를 종료합니다.

  • 학습된 얼굴 정보는 자동으로 저장되어 다음에 주미를 시작할 때 자동으로 불러와져 인식에 사용됩니다.

  • 이 함수를 사용하기 전에 camera_stream_start() 로 영상 스트리밍을 시작해야 합니다.

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