04
검색
여러 모드로 데이터를 검색하고 헤더에서 빠르게 검색하는 방법을 안내합니다.
검색 시작하기
공통 검색 화면에서 모드를 선택하고 조건을 설정하여 검색을 실행합니다.
![[캡처 필요: 검색 화면 기본 구성 - 좌측 모드 / 상단 조건 / 중앙 결과 / 우측 상세]](/_next/image?url=%2Fmanual%2Fvunexhub%2Fimages%2F1779777400539_Search_-_Default_ko.png&w=1920&q=75)
- 왼쪽 메뉴에서 [검색]을 클릭하여 검색 화면을 여세요.검색 화면이 열리며 기본적으로 [AI] 모드가 선택됩니다. 상단의 [AI], [AC], [FR] 버튼을 클릭하여 모드를 전환할 수 있습니다.
- 조건을 지정하여 검색 결과를 좁히세요.조건 설정 영역에 조건을 지정하면 조건에 맞는 검색 결과를 확인할 수 있습니다. 조건 항목은 모드에 따라 다르며, 자세한 내용은 각 모드 안내를 참고하세요.

- 결과 카드를 클릭하여 상세 정보를 확인하세요.우측에 [검색 결과 상세] 영역이 열립니다. 표시되는 메타 정보 항목은 검색 모드에 따라 다르며, 자세한 내용은 각 모드 안내를 참고하세요.

- 결과 영역 상단 칩의 X 버튼을 클릭하여 조건을 제거하세요.해당 조건이 제거되고 결과가 즉시 갱신됩니다. 조건을 다시 설정하여 재검색하면 새로운 조건으로 결과가 갱신됩니다.
참고
- VUNex AI 모듈에서 검색 서비스가 비활성화되어 있으면 검색이 불가합니다. 시스템 관리자에게 VUNex AI 설정 확인을 요청하세요.
- 영문자와 공백만 입력할 수 있습니다.
헤더에서 빠르게 검색하기
헤더의 전역 검색 바에서 어느 화면에서든 AI 검색을 실행합니다.
![[캡처 필요: 헤더 AI Quick Search 바 - Default / Focus(최근 검색어) / Input 상태]](/_next/image?url=%2Fmanual%2Fvunexhub%2Fimages%2F1779777557753_Search_-_Header_ko.png&w=1920&q=75)
- 헤더의 검색 바에 자연어로 검색어를 입력하고 Enter 키를 누르세요.검색 화면으로 자동 이동하여 결과가 표시됩니다. 진입 시 검색 조건은 오늘, 모든 카메라, [AI] 모드 기본값으로 적용됩니다.
- 검색 바에 포커스를 두고 [최근 검색어] 목록에서 검색어를 재사용하세요.최근 검색어가 최대 5개(중복 제거) 표시됩니다. 항목을 클릭하면 검색 바에 해당 검색어가 입력되며, Enter 키로 검색을 실행할 수 있습니다.
참고
영문자와 공백만 입력할 수 있습니다.
AI로 검색하기
텍스트 키워드, 업로드한 이미지, 속성·이벤트 조건을 활용해 영상 속 인물·물체를 검색합니다.
![[캡처 필요: AI 검색 - 텍스트 / 이미지 / 상세 검색 세 가지 입력 방식과 결과·상세 영역]](/_next/image?url=%2Fmanual%2Fvunexhub%2Fimages%2F1779777400539_Search_-_Default_ko.png&w=1920&q=75)
- [검색 방식] 입력란에 자연어 설명을 입력하고 Enter 키를 눌러 텍스트 검색을 실행하세요.
- 예시 — blue top man, person with red backpack.
- 결과는 기본적으로 [정확도순]으로 정렬되며, [최신순]을 클릭하면 최신순으로 재정렬됩니다.
![**[검색 방식]** 입력란에 자연어 설명을 입력하고 **Enter** 키를 눌러 텍스트 검색을 실행하세요.](/manual/vunexhub/images/1779777569950_Search_-_prompt_ko.png)
- [검색 방식]의 이미지 아이콘을 클릭하여 이미지를 업로드하고 유사 인물을 검색하세요.업로드 영역에 이미지를 드래그 앤 드롭하거나 클릭하여 파일을 선택합니다. 업로드 후 해당 이미지를 기준으로 검색이 자동 실행됩니다.
![**[검색 방식]**의 이미지 아이콘을 클릭하여 이미지를 업로드하고 유사 인물을 검색하세요.](/manual/vunexhub/images/1779777721284_Search_-_Similar_person_search_ko.png)
- 조건 설정 영역의 [상세]를 클릭하여 [상세 검색] 창을 열고 속성·이벤트 조건으로 검색하세요.[클래스], [이벤트], [성별], [상의], [하의], [모자], [소지품] 값을 설정한 뒤 [검색]을 클릭하세요. Any로 둔 항목은 필터로 적용되지 않습니다.
![조건 설정 영역의 **[상세]**를 클릭하여 **[상세 검색]** 창을 열고 속성·이벤트 조건으로 검색하세요.](/manual/vunexhub/images/1779777683310_Search_-_Attribute_search_ko.png)
- 결과 카드를 클릭하여 [검색 결과 상세] 영역을 열고 후속 작업을 실행하세요.
- [유사 인물 검색] : 선택한 이미지로 재검색합니다.
- [영상 재생] : 해당 카메라의 단일 재생 화면을 엽니다.
참고
- 이미지 검색 정확도를 높이려면 한 사람만 명확히 보이고 전신이 나오는 사진을 사용하세요.
- 이미지 업로드는 .jpg, .png, .jpeg 형식을 지원하며, 파일당 최대 5MB까지 업로드할 수 있습니다.
출입 이벤트 검색하기 (AC)
AC 장비에서 기록된 출입 이벤트를 기간·장치·이벤트 종류로 검색합니다.
![[캡처 필요: AC 검색 - 조건(기간/장치/이벤트) + 결과 카드 + 검색 결과 상세 영역]](/_next/image?url=%2Fmanual%2Fvunexhub%2Fimages%2F1779777733512_Search_-AC_ko.png&w=1920&q=75)
- [AC] 모드로 전환한 뒤 [기간], [장치], [이벤트] 조건을 설정하세요.
- [기간] : 오늘(기본값)
- [장치] : 전체(기본값), 복수 선택 가능
- [이벤트] : 전체(기본값), 복수 선택 가능
- 검색이 실행되면 결과 카드를 확인하세요.각 결과 카드에는 이벤트명, 사용자명, 장치명, 시간이 표시됩니다.
- 결과 카드를 클릭하여 [검색 결과 상세] 영역에서 출입 정보를 확인하세요.영역에는 이벤트명, [사용자 그룹], [사용자], [출입문], [장치] 명, 시간이 표시됩니다. 등록된 얼굴 이미지가 있는 경우 이벤트 시점의 크롭된 얼굴 이미지와 함께 표시됩니다.
![결과 카드를 클릭하여 **[검색 결과 상세]** 영역에서 출입 정보를 확인하세요.](/manual/vunexhub/images/1779777745658_Search_-AC_result_ko.png)
얼굴로 사용자 검색하기 (FR)
사용자 이름이나 업로드한 얼굴 이미지로 사용자를 검색하고, 정확도 기준값을 조정합니다.
![[캡처 필요: FR 검색 - 사용자 이름 검색 / 얼굴 이미지 검색 창 / 검색 결과 상세]](/_next/image?url=%2Fmanual%2Fvunexhub%2Fimages%2F1779777942378_Search_-FR_ko.png&w=1920&q=75)
- [FR] 모드로 전환한 뒤 [기간], [카메라], [정확도] 조건을 설정하세요.
- [기간] : 오늘(기본값)
- [카메라] : 전체 카메라(기본값)
- [정확도] : 80% 이상(기본값), 범위 70~100
- [검색 방식] 입력란에 사용자 이름을 입력하고 Enter 키를 눌러 사용자 이름으로 검색하세요.입력란에 포커스를 두면 등록된 사용자(최대 5명), 등록되지 않은 사용자, [최근 검색어]가 표시되는 가이드 영역이 열립니다. 목록 항목을 클릭하면 입력란에 자동으로 채워집니다.
- 결과 카드를 클릭하여 [검색 결과 상세] 영역을 열고 후속 작업을 실행하세요.영역에는 [사용자 유형], [사용자], [카메라], [시간] 값이 표시됩니다.
- [얼굴 이미지 검색] : 선택한 얼굴 이미지로 재검색합니다.
- [영상 재생] : 해당 카메라의 단일 재생 화면을 엽니다.
![결과 카드를 클릭하여 **[검색 결과 상세]** 영역을 열고 후속 작업을 실행하세요.](/manual/vunexhub/images/1779777957566_Search_-FR_result_ko.png)
참고
- 결과 카드에는 사용자명 앞에 사용자 유형이 표시됩니다. 사용자 목록에 등록되지 않은 얼굴은 미등록 사용자로 표시됩니다.
- 얼굴 이미지 검색, 얼굴 매칭 기준값 기능은 추후 업데이트에서 지원될 예정입니다.
녹화 영상 재생 화면에서 검색하기
재생 중인 영상에서 특정 영역을 직접 크롭하여 유사 인물을 검색합니다.
![[캡처 필요: 재생 화면 Image Crop 모드 - 사각형 크롭 영역 + Search/Undo/Out 메뉴]](/_next/image?url=%2Fmanual%2Fvunexhub%2Fimages%2F1779777969102_Playback_Single_View_Menu_ko.png&w=1920&q=75)
- 재생 컨트롤 우측의 [⋮](더보기)를 클릭하여 [유사 인물 검색]을 선택하세요.영상이 일시정지되고 영역 선택 모드로 전환됩니다. 영상 영역 외의 화면은 클릭할 수 없으며, 마우스 포인터가 변경됩니다.
- 영상 위에서 검색할 영역을 드래그하여 사각형으로 선택하세요.마우스에서 손을 떼면 크롭 영역이 확정되고 메뉴가 표시됩니다.

- 표시된 메뉴에서 동작을 선택하세요.
- [검색] : 해당 크롭 이미지로 검색을 실행하고, 검색 화면으로 자동 이동합니다.
- [되돌리기] : 크롭을 취소하고 다시 영역을 선택할 수 있는 상태로 돌아갑니다.
- [종료] : 영역 선택 모드를 종료하고 재생 화면으로 돌아갑니다.
참고
[얼굴 이미지 검색] 메뉴도 동일한 방식으로 동작하며 추후 업데이트에서 지원될 예정입니다.