얼굴 감지

카메라 영상에서 사람의 얼굴을 실시간으로 감지하고 위치를 추적합니다. 감정 인식과 나이·성별 추정을 포함합니다.

명령

명령	설명
얼굴 감지 여부	얼굴이 감지되었는지 확인합니다.
얼굴 개수	감지된 얼굴의 수를 기록합니다.
얼굴 정보 읽기	선택 기준에 맞는 얼굴 1개의 신뢰도, 중심점, 너비·높이를 변수에 기록합니다.
모든 얼굴 정보 읽기	감지된 모든 얼굴의 정보를 JSON 으로 기록합니다.
감정 인식	얼굴이 감지되면 표정을 분석하여 8가지 감정 중 하나로 분류합니다.
나이/성별 추정	감지된 얼굴의 나이와 성별을 추정합니다.

감지 영역을 지정하면 그 영역 안의 얼굴만 대상으로 합니다.

설정

항목	설명
신뢰도 (%)	기본값 70.
감지 영역	공통 사항 참고.
선택 기준	최고 신뢰도(기본), 신뢰도 인덱스 (0부터), 최대 크기, 기준점에서 가장 가까움.
인덱스 (0부터)	0~15, 기본값 0.
기준점	공통 사항 참고.

출력 변수

항목	타입	값
감지 여부	디지털	얼굴이 감지되면 참.
갯수	숫자	감지된 얼굴 수.
신뢰도 (%)	숫자	선택된 얼굴의 신뢰도, 0~100.
중심점 X / 중심점 Y	숫자	선택된 얼굴 중심의 픽셀 좌표.
너비 (픽셀) / 높이 (픽셀)	숫자	선택된 얼굴 상자의 크기.
출력 (JSON 텍스트)	텍스트	감지된 모든 얼굴의 배열.
감정	텍스트	인식된 감정의 영문 이름. 미감지 시 `none`.
감정 ID	숫자	감정 번호 0~7. 미감지 시 -1.
감정 신뢰도 (%)	숫자	0~100. 미감지 시 -1.
나이	숫자	추정 나이 0~100. 미감지 시 -1.
성별	텍스트	`male` 또는 `female`. 미감지 시 `none`.
성별 신뢰도 (%)	숫자	0~100. 미감지 시 -1.

JSON 출력

얼굴마다 score(신뢰도 0~100), bbox, center, width, height를 담습니다. 감정 항목(emotion, emotion_id, emotion_confidence)은 감정 인식이, 나이·성별 항목(age, gender, gender_confidence)은 나이/성별 추정이 실행 중일 때만 포함됩니다. 신뢰도 키가 객체 감지의 confidence와 달리 score인 점에 주의합니다.

[
  {
    "score": 95,
    "bbox": { "x1": 120, "y1": 80, "x2": 250, "y2": 300 },
    "center": { "x": 185, "y": 190 },
    "width": 130,
    "height": 220,
    "emotion": "happy",
    "emotion_id": 4,
    "emotion_confidence": 87,
    "age": 28,
    "gender": "male",
    "gender_confidence": 92
  }
]

감정 8종과 ID

ID	감정	뜻
0	angry	분노
1	contempt	경멸
2	disgust	혐오
3	fear	공포
4	happy	행복
5	neutral	무표정
6	sad	슬픔
7	surprise	놀람