---
title: "VL 가이드"
slug: "arceye-app-vl"
updated: 2026-09-17T09:07:47Z
published: 2026-09-17T09:07:47Z
canonical: "guide.ncloud-docs.com/arceye-app-vl"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# VL 가이드

Classic/VPC 환경에서 이용 가능합니다.

VL 가이드에서는 ARC eye Scan 앱의 VL(Visual Localization) 스캔 모드를 사용하는 방법을 안내합니다.

참고

- ARC eye Scan 앱은 테스트 목적으로 단일 공간을 신규 스캔하거나 공간 변경으로 인해 기존 위치를 재스캔해야 하는 경우에 사용하는 앱입니다. 스캔 가능 범위 등 제한 사항은 아래 [촬영 요구사항](/docs/arceye-app-vl#%EC%B4%AC%EC%98%81%EC%9A%94%EA%B5%AC%EC%82%AC%ED%95%AD)을 참조해 주십시오.
- 여러 공간을 신규 스캔해야 하는 경우에는 전용 스캔 장비를 대여하여 진행해 주십시오.

## 갤러리

갤러리에서는 ARC eye Scan 앱에 촬영한 영상을 확인하고 네이버 클라우드 플랫폼에 업로드하는 방법을 설명합니다.

### 영상 확인

​ 앱에서 촬영한 영상 목록을 확인하는 방법은 다음과 같습니다.

1. ARC eye Scan 앱을 터치하여 열어 주십시오.
2. 사용하실 리전을 선택한 후 **[다음]** 버튼을 클릭해 주십시오.
3. **[Visual Localization]** 스캔 모드 선택 후 **[시작하기]** 버튼을 클릭해 주십시오.
4. 화면 아래에 있는 **[갤러리]** 메뉴를 터치해 주십시오.
5. 날짜별 촬영한 영상 목록이 나타납니다.
  - 화면 왼쪽 위에 있는 **전체**는 앱에 현재 저장되어 있는 전체 영상 수를 의미합니다.
  - 화면 오른쪽 위에 있는 필터 버튼을 클릭하여 날짜 정렬 순서를 변경할 수 있습니다.
6. 상세 정보를 확인할 영상을 터치해 주십시오.
7. 영상에 대한 상세 정보를 확인해 주십시오.
  - **▶** 버튼: 터치 시 영상 재생
    - 재생 화면에서 **…** 버튼 터치하여 재생 속도 변경 가능
  - 이름: 자동 생성된 영상의 이름
    - **[이름 수정]** 버튼: 클릭하여 이름 수정 가능. 업로드 완료한 영상인 경우, 콘솔의 영상 이름과 연동되지 않음
  - 생성일: 영상을 촬영한 날짜
  - 크기: 영상 파일의 크기
  - 시간: 영상의 길이

### 영상 업로드

앱에서 촬영한 영상을 네이버 클라우드 플랫폼 콘솔에 업로드하는 방법은 다음과 같습니다.

1. ARC eye Scan 앱을 터치하여 열어 주십시오.
2. 사용하실 리전을 선택한 후 **[다음]** 버튼을 클릭해 주십시오.
3. **[Visual Localization]** 스캔 모드 선택 후 **[시작하기]** 버튼을 클릭해 주십시오.
4. 화면 아래에 있는 **[갤러리]** 메뉴를 터치해 주십시오.
5. **[선택]** 버튼을 터치해 주십시오.
6. 업로드할 영상을 터치하여 선택해 주십시오.
  - 한 번에 최대 5개까지 가능
7. 화면 아래에 있는 **[n개 업로드]** 버튼을 터치해 주십시오.
8. **확인** 팝업 창이 나타나면 **[확인]** 버튼을 터치해 주십시오.
9. 선택한 영상을 업로드할 프로젝트를 터치하여 선택한 다음 **[업로드]** 버튼을 터치해 주십시오.
10. 업로드 내역 화면이 나타나면 업로드 진행률을 확인해 주십시오.

### 업로드 내역 확인

업로드한 영상 목록과 완료 여부를 확인할 수 있습니다. 확인하는 방법은 다음과 같습니다.

1. ARC eye Scan 앱을 터치하여 열어 주십시오.
2. 사용하실 리전을 선택한 후 **[다음]** 버튼을 클릭해 주십시오.
3. **[Visual Localization]** 스캔 모드 선택 후 **[시작하기]** 버튼을 클릭해 주십시오.
4. 화면 아래에 있는 **[갤러리]** 메뉴를 터치해 주십시오.
5. 화면 오른쪽 위에 있는 **[업로드 내역]** 버튼을 터치해 주십시오.
6. 화면 오른쪽에 있는 선택 박스에서 업로드 내역을 확인할 프로젝트를 클릭하여 선택해 주십시오.
7. 선택한 프로젝트에 업로드한 영상 목록이 나타나면 필요한 정보를 확인해 주십시오.
  - 업로드 수: 선택한 프로젝트에 업로드한 영상 총 개수
  - 날짜: 선택한 프로젝트에 영상을 업로드한 날짜
  - 영상 정보: 섬네일, 선택한 프로젝트 업로드한 영상 이름, 업로드한 상세 날짜, 업로드 완료 여부  

​

참고

업로드 내역은 **더 보기**에서 **업로드 내역**을 터치하여 확인할 수도 있습니다.

### 영상 삭제

앱에서 촬영한 영상을 삭제하는 방법은 다음과 같습니다.

1. ARC eye Scan 앱을 터치하여 열어 주십시오.
2. 사용하실 리전을 선택한 후 **[다음]** 버튼을 클릭해 주십시오.
3. **[Visual Localization]** 스캔 모드 선택 후 **[시작하기]** 버튼을 클릭해 주십시오.
4. 화면 아래에 있는 **[갤러리]** 메뉴를 터치해 주십시오.
5. **[선택]** 버튼을 터치해 주십시오.
6. 삭제할 영상을 터치하여 선택해 주십시오.
7. 화면 아래에 있는 **[삭제]** 버튼을 터치해 주십시오.
8. **데이터 삭제** 팝업 창이 나타나면 **[확인]** 버튼을 터치해 주십시오.

주의

삭제한 영상은 복구할 수 없으므로 신중하게 결정해 주십시오.

## 카메라

카메라에서는 ARC eye Scan 앱에서 VL Task의 공간 이미지 데이터를 업로드하기 위해 영상을 촬영하는 방법을 설명합니다.

### 촬영 요구사항

| 카테고리 | 스펙 | 비고 |
| --- | --- | --- |
| 촬영 공간 | 50m*50m 크기의 텍스처가 풍부하며, 움직이는 객체가 적은 공간 | 사람, 영상이 재생되는 디스플레이 등 촬영 지양 |
| 촬영 시간 | 최대 5분(최소 30초, keyframe 10 개 생성 이상) | keyframe 10개 -> 색칠되는 횟수 10회 이상 |
| 촬영 요구사항 | 촬영 시작 지점과 종료 지점이 일치해야함 | 거리 차이 3m 이내, 각도 차이 20도 이내 |
| 촬영 기기 | iPhone 12 Pro 이상 | LiDAR 사용 가능 기기 |

### 영상 촬영

ARC eye Scan 앱에서 객체 영상을 촬영하는 방법은 다음과 같습니다.

1. ARC eye Scan 앱을 터치하여 열어 주십시오.
2. 사용하실 리전을 선택한 후 **[다음]** 버튼을 클릭해 주십시오.
3. **[Visual Localization]** 스캔 모드 선택 후 **[시작하기]** 버튼을 클릭해 주십시오.
4. 화면 아래에 있는 **[카메라]** 메뉴를 터치해 주십시오.
5. 촬영 전 프로젝트 및 촬영 장소 선택 프로세스를 진행해 주십시오.
  - **프로젝트 선택:** VL을 진행할 프로젝트 선택
  - **상위 > 하위 로케이션 선택:** 최하위 로케이션이 화면에 표시될 때까지 로케이션 선택
  - **최종 로케이션 선택:** 파일을 업로드할 최하위 로케이션 선택
    - **[이전]** 버튼: 이동할 상위 로케이션 선택
6. 화면 하단의 **[촬영 시작하기]** 버튼을 클릭해 주십시오.
  - 카메라 화면이 나타나며, 촬영 기기를 움직여 카메라 모듈을 실행할 수 있습니다.
  - 촬영 준비가 완료될 때까지 잠시만 기다려 주십시오.
7. 촬영할 공간을 카메라에 비춘 후 화면 우측 하단의 **●(시작)** 버튼을 터치하여 영상을 촬영해 주십시오.
  - 촬영이 시작되면 공간을 인식하는 과정이 시작됩니다. 기기를 천천히 좌우로 움직여 공간을 인식 시킵니다.
  - 공간을 정확하게 스캔할 수 있도록 너무 빠르게 움직이지 않도록 주의해 주십시오.
  - 공간 스캔이 된 영역은 하늘색과 보라색으로 표시됩니다. 기기의 방향에 따라 표시되는 영역의 색상이 달라지며 하늘색으로 표현될 수록 많은 방향의 데이터가 촬영된것을 의미합니다. 최대한 많은 영역이 하늘색으로 표시되도록 촬영을 진행합니다.
  - 화면 위쪽에서 촬영 가능 잔여 시간(MM:SS)을 확인할 수 있습니다.
  - 화면 아래쪽에서 미니 맵을 통해 현재 스캔 중인 공간의 위치를 확인할 수 있습니다.
8. 촬영이 완료되면 **■(중지)** 버튼을 터치해 주십시오.
  - 스캔이 완료되면 시작 지점으로 돌아온 후 중지합니다.
  - 촬영한 영상은 갤러리에 자동 저장됩니다.

참고

촬영 가능한 시간은 최소 30초, 최대 5분 이내입니다.

참고

촬영을 중간에 취소하는 방법은 다음과 같습니다.

1. 화면 오른쪽 위에 있는 **취소**를 터치해 주십시오.
2. 알림 팝업 창이 나타나면 **[확인]** 버튼을 터치해 주십시오.
  - 촬영을 취소한 영상은 갤러리에 저장되지 않습니다.

주의

**촬영시 주의 사항**

- 네트워크에 연결된 환경에서 촬영을 진행해 주십시오.
- 다음과 같은 공간에서 촬영을 진행하는 경우 결과물의 품질이 떨어질 수 있습니다.
  - 텅 빈 공간
  - 단색 벽과 같이 특징이 없는 공간
  - 반복되는 물체가 많은 공간
  - 유리나 반짝이는 재질이 많은 공간
- 벽면 및 물체까지의 거리는 0.5m ~ 5m 이내를 유지하며 촬영해야 합니다.
- 촬영 시 너무 빨리 움직일 경우 결과물의 품질이 나빠질 수 있습니다.

**촬영 경로** 촬영 경로에 대한 가이드라인입니다. 높은 품질의 영상을 확보하기 위한 방법으로 촬영시 유의하시길 바랍니다.

- 특징이 풍부한 공간에서 시작하여 공간 인식을 성공할 때까지 주변을 천천히 둘러보며 촬영합니다.  

![경로1](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/%E1%84%89%E1%85%B3%E1%84%8F%E1%85%A2%E1%86%AB%E1%84%8B%E1%85%A2%E1%86%B8%E1%84%8B%E1%85%B5%E1%84%8B%E1%85%AD%E1%86%BC%E1%84%8C%E1%85%AE%E1%84%8B%E1%85%B4_1.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A07%3A51Z&se=2026-10-26T22%3A07%3A51Z&sr=c&sp=r&sig=Vu%2FwM87HdVuhNbjU1JbxpkwJsGkPhHCrwpgztgDYdSE%3D)
- 최초 공간 인식 성공 이후 외곽선을 그린다는 느낌으로 한 방향으로 벽면과 물체들이 충분히 화면에 들어오게 하여 촬영합니다.  

![경로2](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/%E1%84%89%E1%85%B3%E1%84%8F%E1%85%A2%E1%86%AB%E1%84%8B%E1%85%A2%E1%86%B8%E1%84%8B%E1%85%B5%E1%84%8B%E1%85%AD%E1%86%BC%E1%84%8C%E1%85%AE%E1%84%8B%E1%85%B4_2.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A07%3A51Z&se=2026-10-26T22%3A07%3A51Z&sr=c&sp=r&sig=Vu%2FwM87HdVuhNbjU1JbxpkwJsGkPhHCrwpgztgDYdSE%3D)
- 가볍게 한 방향으로 촬영 한 후에는 역방향으로 진행하며 구석구석 촬영하여 줍니다.  

![경로3](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/%E1%84%89%E1%85%B3%E1%84%8F%E1%85%A2%E1%86%AB%E1%84%8B%E1%85%A2%E1%86%B8%E1%84%8B%E1%85%B5%E1%84%8B%E1%85%AD%E1%86%BC%E1%84%8C%E1%85%AE%E1%84%8B%E1%85%B4_3.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A07%3A51Z&se=2026-10-26T22%3A07%3A51Z&sr=c&sp=r&sig=Vu%2FwM87HdVuhNbjU1JbxpkwJsGkPhHCrwpgztgDYdSE%3D)
- 촬영 앱에는 5분이라는 제한 시간이 존재하며, 제한 시간 내에 촬영을 마치고 시작 장소로 돌아와서 VL 성공 결과를 받아야 합니다.  

![경로4](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/%E1%84%89%E1%85%B3%E1%84%8F%E1%85%A2%E1%86%AB%E1%84%8B%E1%85%A2%E1%86%B8%E1%84%8B%E1%85%B5%E1%84%8B%E1%85%AD%E1%86%BC%E1%84%8C%E1%85%AE%E1%84%8B%E1%85%B4_4.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A07%3A51Z&se=2026-10-26T22%3A07%3A51Z&sr=c&sp=r&sig=Vu%2FwM87HdVuhNbjU1JbxpkwJsGkPhHCrwpgztgDYdSE%3D)

### 측위 성능 확인 방법

특정 구역에서 측위가 잘 안 될 경우, ARC eye Scan 앱에서 VL 응답률을 실시간으로 확인하여 현장의 측위 성능을 확인할 수 있습니다.

![스크린샷 2026-07-15 오후 2.25.43.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-07-15%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.25.43.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A07%3A51Z&se=2026-10-26T22%3A07%3A51Z&sr=c&sp=r&sig=Vu%2FwM87HdVuhNbjU1JbxpkwJsGkPhHCrwpgztgDYdSE%3D)

1. ARC eye Scan 앱을 실행한 뒤 하단의 카메라 버튼을 눌러 스캔 화면으로 이동합니다. 우측 하단의 빨간색 녹화 버튼을 길게 (long tap) 눌러줍니다.  

짧게 누르면 일반 스캔 모드로, 길게 누르면 VL 측위 테스트 모드로 전환됩니다.

![스크린샷 2026-07-15 오후 2.26.03.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-07-15%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.26.03.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A07%3A51Z&se=2026-10-26T22%3A07%3A51Z&sr=c&sp=r&sig=Vu%2FwM87HdVuhNbjU1JbxpkwJsGkPhHCrwpgztgDYdSE%3D)

1. VL 측위 테스트 모드로 전환되면 녹화 버튼이 VL 상태 아이콘으로 변경됩니다.

![스크린샷 2026-07-15 오후 2.27.12.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-07-15%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.27.12.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A07%3A51Z&se=2026-10-26T22%3A07%3A51Z&sr=c&sp=r&sig=Vu%2FwM87HdVuhNbjU1JbxpkwJsGkPhHCrwpgztgDYdSE%3D)

1. 이동함에 따라 카메라 경로가 증강이 되고, VL 아이콘 색상이 변경됩니다. 색상은 측위 상태를 나타냅니다.
  - 빨간색은 실패, 노란색은 보통(성공/실패 반반), 초록색은 성공
  - 빨간색이 많이 나오는 공간은 변경이 많이 된 공간으로 판단되므로, 재스캔이 필요합니다.

![스크린샷 2026-07-15 오후 2.27.44.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-07-15%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.27.44.png?sv=2026-02-06&spr=https&st=2026-10-26T21%3A07%3A51Z&se=2026-10-26T22%3A07%3A51Z&sr=c&sp=r&sig=Vu%2FwM87HdVuhNbjU1JbxpkwJsGkPhHCrwpgztgDYdSE%3D)

1. VL 아이콘 버튼을 누르면, 측위 테스트가 종료됩니다. 공간 내 측위 결과를 보여주는 경로는 유지됩니다.