공통 사항
분석기와 타입
AI 분석기에서 사용할 분석기를 선택합니다. 분석기는 선택 창에서 바로 추가, 편집, 삭제할 수 있고 설정 > AI 분석기에서도 관리할 수 있습니다. 분석 타입은 분석기의 AI 모델로 정해지므로, 동작 창에는 선택한 분석기의 모델에 해당하는 명령과 항목만 표시됩니다.
분석기의 미디어 타입에 따라 쓸 수 있는 분석 타입이 나뉩니다. 비디오 (카메라) 분석기는 객체 감지, 얼굴 감지, 얼굴 인식, 자세 추정, 손 추적, 색상 추적, QR / 바코드, OCR (문자 인식), 라인 트래킹, 라인 크로싱 카운터, 화재 감지, 동작 인식, 손동작 인식, 번호판 인식, Teachable Machine 분류, Edge Impulse 분류, Edge Impulse 객체 감지, Edge Impulse 이상 탐지를 쓰고, 오디오 (마이크/스피커) 분석기는 소리 분류와 Edge Impulse 분류를 씁니다.
타입 항목은 이 동작이 분석기에 무엇을 할지 정합니다.
| 타입 | 설명 |
|---|---|
| 분석 추가 | AI 분석기에 분석을 추가합니다. 하나의 분석기에 여러 개의 분석을 추가할 수 있습니다. 아래의 명령·설정·출력 항목은 이 타입일 때만 표시됩니다. |
| 분석 삭제 / 분석 모두 삭제 | 이 분석기에 등록된 모든 분석을 삭제합니다. 비디오 분석기에서는 분석 삭제, 오디오 분석기에서는 분석 모두 삭제로 표시됩니다. |
| 분석 시작 | 오디오 캡처와 분석을 시작합니다. 오디오 분석기에만 표시됩니다. |
| 분석 중지 | 오디오 캡처와 분석을 중지합니다. 오디오 분석기에만 표시됩니다. |
명령
명령은 분석 타입마다 다르며, 무엇을 계산하여 어느 변수에 기록할지 정합니다. 명령을 고르면 그 명령에 필요한 설정 항목과 출력 항목만 표시됩니다. 타입별 명령은 아래 각 절의 표에 있습니다.
공통 설정
여러 타입에 같은 뜻으로 쓰이는 항목입니다. 값의 범위와 기본값이 타입마다 다르면 각 절에 따로 적었습니다.
| 항목 | 설명 |
|---|---|
| 신뢰도 (%) | 이 값 이상인 감지 결과만 사용합니다. 0~100 사이의 값이며 높일수록 확실한 결과만 남고 낮출수록 놓치는 것이 줄어듭니다. 기본값은 대부분 50이고 얼굴 감지는 70입니다. 임계값, 최소 신뢰도, 감지 임계값이라는 이름으로 표시되는 타입도 뜻은 같습니다. |
| 감지 영역 | 카메라 프리뷰 위에서 드래그하여 감지할 사각형 범위를 지정합니다. 지정하지 않으면 화면 전체에서 감지하고, 지정하면 그 영역 안의 결과만 사용합니다. |
| 선택 기준 | 여러 개가 감지되었을 때 어느 것의 값을 변수에 기록할지 정합니다. 객체 감지·얼굴 감지는 최고 신뢰도, 신뢰도 인덱스 (0부터), 최대 크기, 기준점에서 가장 가까움, 색상 추적은 최대 크기, 기준점에서 가장 가까움, 면적 인덱스, QR / 바코드는 최대 면적, 가장 가까움, 인덱스, Edge Impulse 객체 감지는 최고 신뢰도, 인덱스, 가장 큰, 가장 가까운 중에서 고릅니다. |
| 인덱스 (0부터) | 선택 기준이 인덱스일 때 고를 순번입니다. 객체 감지·얼굴 감지는 신뢰도가 높은 순으로 0, 1, 2…, 색상 추적과 QR / 바코드는 면적이 큰 순으로 0, 1, 2…, Edge Impulse 객체 감지는 모델이 검출한 순서입니다. 객체·얼굴은 0~15, 색상은 0~100 범위입니다. |
| 기준점 | 선택 기준이 기준점에서 가장 가까움일 때 카메라 프리뷰에서 클릭하여 지정하는 기준 좌표입니다. |
출력 변수와 값 규약
출력 항목에 연결한 변수는 분석이 실행되는 동안 계속 갱신됩니다. 연결하지 않은 출력은 기록하지 않으므로 필요한 항목에만 변수를 연결합니다. 변수 타입은 항목에 따라 정해져 있습니다.
- 디지털: 감지 여부, 매칭 여부, 일치 여부처럼 참/거짓으로 기록되는 항목입니다.
- 숫자: 개수, 좌표, 너비·높이, 신뢰도, 확률, 각도, 거리입니다. 좌표와 크기는 카메라 프레임의 픽셀 단위이고, 중심점은 감지 상자의 가운데입니다. 신뢰도와 확률은 0~100 범위의 값입니다(OCR 은 예외, 해당 절 참고).
- 텍스트: 클래스 이름, 인식된 이름, 데이터, JSON 출력입니다.
- 색상: 색상 추적의 평균 색상입니다.
감지되지 않았을 때의 값은 타입마다 정해져 있습니다. 텍스트는 none 또는 빈 문자열,
숫자는 -1 또는 0 이 기록되며 각 절의 출력 표에 적혀 있습니다.
출력 (JSON 텍스트) 항목은 감지 결과 전체를 JSON 문자열로 텍스트 변수에 기록합니다. 결과가
여러 개인 타입은 배열이고 감지된 것이 없으면 빈 배열 [] 입니다. 키 이름과 예시는 각
절의 JSON 출력에 있으며, 값을 골라 쓰려면 블록 코딩에서 파싱합니다.