얼굴 인식

얼굴 감지의 확장 기능으로, 감지된 얼굴을 등록된 얼굴과 비교하여 누구인지 인식합니다. 얼굴의 등록과 삭제도 이 동작의 명령으로 수행합니다.

명령

명령	설명
얼굴 인식	현재 감지된 얼굴이 등록된 얼굴 중 누구인지 식별하여 이름과 유사도를 기록합니다.
등록된 얼굴 수	등록되어 있는 얼굴의 총 개수를 기록합니다.
등록된 얼굴 목록	등록된 얼굴 이름 목록을 콤마로 구분한 문자열로 기록합니다.
얼굴 등록	현재 화면의 얼굴을 얼굴 이름으로 등록합니다.
얼굴 삭제	등록된 얼굴 중 얼굴 이름과 같은 이름의 얼굴을 삭제합니다.
모든 얼굴 삭제	등록된 모든 얼굴을 삭제합니다.

설정

항목	설명
임계값 (%)	유사도 임계값입니다. 0~100, 기본값 70. 유사도가 이 값 이상일 때만 매칭된 것으로 판단합니다.
최소 얼굴 면적 (px²)	인식할 얼굴의 최소 픽셀 면적입니다. 이보다 작은(먼) 얼굴은 인식 대상에서 제외됩니다. 0이면 제한이 없습니다. 입력은 112×112 로 정규화되므로 너무 작은 얼굴은 확대 과정에서 정확도가 떨어집니다. 기본값 6400(80×80)은 권장 균형값이며, 근거리 정밀 인식만 원하면 12544(112×112)로 높입니다.
얼굴 이름	등록하거나 삭제할 얼굴의 이름입니다. 예: john, 홍길동.

얼굴 데이터의 저장소는 분석기 설정의 DB 이름(기본 default)으로 정하며 같은 이름을 쓰는 분석기끼리 데이터를 공유합니다. 사진이나 화면으로 된 얼굴을 차단하는 안티 스푸핑도 분석기 설정에 있습니다(6부 AI 분석기).

얼굴 등록은 화면에 얼굴이 여러 개이면 가장 큰 얼굴을 등록하고, 얼굴이 감지되지 않으면 등록하지 않습니다. 이미 등록된 이름으로 다시 등록하면 기존 얼굴을 덮어쓰지 않고 그 이름에 얼굴 샘플을 추가합니다. 정면, 측면처럼 여러 각도로 같은 이름을 등록해 두면 인식이 안정됩니다. 한 이름을 처음부터 다시 등록하려면 얼굴 삭제로 지운 뒤 등록합니다.

출력 변수

항목	타입	값
얼굴 감지 여부	디지털	얼굴이 감지되면 참.
매칭 여부	디지털	등록된 얼굴과 유사도가 임계값 이상으로 매칭되면 참.
인식된 이름	텍스트	매칭된 얼굴의 이름. 얼굴이 없으면 빈 문자열, 얼굴은 있으나 등록된 얼굴과 매칭되지 않으면 `Unknown`.
유사도 (%)	숫자	가장 비슷한 등록 얼굴과의 유사도, 0~100.
등록된 얼굴 수	숫자	등록된 얼굴의 수.
등록된 얼굴 목록	텍스트	등록된 이름을 콤마로 구분한 문자열.

이 타입에는 JSON 출력이 없습니다.