---
title: "Object"
slug: "arceye-votobject"
updated: 2026-09-17T09:07:47Z
published: 2026-09-17T09:07:47Z
canonical: "guide.ncloud-docs.com/arceye-votobject"
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.

# Object

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

Object에서는 모바일 기기에서 촬영 후 업로드한 영상에서 VOT 프로세싱을 거쳐 오브젝트(객체)를 생성하는 방법을 설명합니다. 객체 생성 방법은 크게 다음 4단계로 이루어집니다.

1. [ARC eye Scan 앱에서 객체 영상을 촬영 후 업로드](/docs/arceye-app-vl#%EC%98%81%EC%83%81-%EC%97%85%EB%A1%9C%EB%93%9C)
2. [네이버 클라우드 플랫폼 콘솔의 ARC eye에서 업로드된 영상 확인](/docs/arceye-votobject#%EC%98%A4%EB%B8%8C%EC%A0%9D%ED%8A%B8%EB%AA%A9%EB%A1%9D%ED%99%95%EC%9D%B8)
3. [영상에서 태깅 작업을 통해 객체 생성](/docs/arceye-votobject#%EC%98%A4%EB%B8%8C%EC%A0%9D%ED%8A%B8%EC%83%9D%EC%84%B1)
4. [생성한 객체에 대한 위치 정보l API로 배포](/docs/arceye-votapi)

## Object 화면

Object 화면은 다음과 같이 구성되어 있습니다.

![arceye-object_01_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/arceye-object_01_ko.png?sv=2026-02-06&spr=https&st=2026-10-26T20%3A12%3A08Z&se=2026-10-26T21%3A12%3A08Z&sr=c&sp=r&sig=Z%2FWEclRbEWkYr97dT2L85RwqYN%2FbJYF1nNnCR9NZCZI%3D)

| 영역 | 설명 |
| --- | --- |
| ① 메뉴명 | 현재 확인 중인 메뉴 이름 |
| ② 기본 기능 | **Object** 메뉴 최초 진입 시 표시되는 기능 - **[기능 및 요금 안내]**: 클릭하여 ARC eye 소개 페이지로 이동 - **[새로 고침]**: 클릭하여 페이지 새로 고침 |
| ③ 프로젝트 선택 | 업로드한 영상에서 오브젝트를 생성하여 관리할 프로젝트를 선택 |
| ④ 업로드 후 기능 | 영상 업로드 후 표시되는 기능으로 오브젝트 선택 시 활성화 - **[오브젝트 삭제]**: 클릭하여 오브젝트 삭제([오브젝트 삭제](/docs/arceye-votobject#%EC%98%A4%EB%B8%8C%EC%A0%9D%ED%8A%B8%EC%82%AD%EC%A0%9C) 참조) |
| ⑤ 검색창 | 오브젝트 이름과 업로드 시작 날짜 또는 객체 생성 완료 날짜를 입력하여 검색 가능 |
| ⑥ 오브젝트 목록 | 오브젝트의 목록([오브젝트 목록 확인](/docs/arceye-votobject#%EC%98%A4%EB%B8%8C%EC%A0%9D%ED%8A%B8%EB%AA%A9%EB%A1%9D%ED%99%95%EC%9D%B8) 참조) |

## 오브젝트 목록 확인

오브젝트 목록 및 오브젝트 정보를 확인할 수 있습니다. 확인하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Digital Twin** > **ARC eye** 메뉴를 차례대로 클릭해 주십시오.
2. **Visual Object Tracking > Object** 메뉴를 차례대로 클릭해 주십시오.
3. 오브젝트 목록에서 오브젝트 정보를 확인해 주십시오.
  - **오브젝트 ID**: 오브젝트 생성 시 자동 생성된 ID
  - **오브젝트 썸네일**: 업로드한 영상 식별을 위한 이미지
  - **오브젝트 이름**: 프로젝트에서 오브젝트의 고유한 이름
    - **[수정]**: 클릭 시 프로젝트 이름 수정 가능([프로젝트 수정](/docs/arceye-votobject#%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8%EC%88%98%EC%A0%95) 참고)
  - **업로드 시작 일시 (UTC+09:00)**: ARC eye Scan 앱으로 영상을 콘솔에 업로드한 날짜
  - **객체 생성 완료 일시 (UTC+09:00)**: 업로드한 영상에서 오브젝트를 생성한 날짜
  - **작업**: 업로드한 영상에서 오브젝트 생성 완료를 위한 2단계 액션
    - **[Tagging]**: 클릭 시 영상에서 오브젝트를 설정
    - **[3D Viewer]**: 클릭 시 영상에서 태깅 후 3D 복원이 완료된 오브젝트 확인
  - **상태**: 업로드한 영상에서 오브젝트 생성 진행 현황
    - 업로드 실패: 영상 업로드 실패
    - 데이터 준비 중: 영상에서 태깅(객체 생성 작업)이 가능하도록 준비 중
    - 데이터 준비 실패: 영상에서 태깅이 가능하도록 준비 실패
    - 태깅 대기: 영상에서 태깅이 가능한 상태
    - 객체 생성 중: 영상에서 객체 생성 중
    - 객체 생성 완료: 영상에서 객체 생성 완료
      - 3D Viewer에서 객체 생성 결과 확인 가능
      - 객체 생성 결과인 PCD 파일 다운로드 가능
      - 태깅 다시 작업 후 새 생성 결과로 덮어쓰기 가능
    - 객체 생성 실패: 영상에서 객체 생성 실패
      - 태깅 다시 작업 가능
  - **다운로드**: 태깅이 완료된 최종 PCD 파일을 로컬 환경에 저장

## 오브젝트 생성

업로드한 영상에서 오브젝트를 생성할 수 있습니다. 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Digital Twin** > **ARC eye** 메뉴를 차례대로 클릭해 주십시오.
2. **Visual Object Tracking > Object** 메뉴를 차례대로 클릭해 주십시오.
3. 업로드된 영상 목록에서 오브젝트를 생성할 영상의 상태를 확인해 주십시오.
  - 정상: 데이터 준비 중 → 태깅 대기
  - 비정상: 업로드 실패, 데이터 준비 실패
4. 영상의 상태가 태깅 대기로 변경되면 영상 속 객체 영역을 지정하는 태깅 작업을 진행하기 위해 **[Tagging]** 버튼을 클릭해 주십시오.
5. **Tagging** 팝업 창이 나타나면 비트맵 결과물에서 오브젝트로 지정할 영역을 선택해 주십시오.
  - **Tagging** 팝업 창의 **ATM > Shortcut Description** 내용을 참고해 주십시오.
6. **[저장]** 버튼을 클릭해 주십시오.
7. 목록에서 태깅을 완료한 영상의 상태를 확인해 주십시오.
  - 정상: 객체 생성 중 → 객체 생성 완료
  - 비정상: 객체 생성 실패
8. 영상의 상태가 객체 생성 완료로 변경되면 **[PCD 다운로드]** 버튼을 클릭해 주십시오.
  - 1MB 이하의 PCD 파일이 로컬 환경에 다운로드됩니다.

              참고

              

- 데이터 준비에서 태깅 대기로 변경되기까지 최대 2시간 정도 소요될 수 있습니다.
- 실패한 경우에 다음과 같이 조치해 주십시오. 자세한 내용은 [ARC eye 문제 해결](/docs/arceye-troubleshoot)에서 확인할 수 있습니다.
  - 업로드 실패, 데이터 준비 실패: 업로드한 영상 삭제 후 앱에서 다시 업로드 또는 영상 재촬영 후 다시 업로드
  - 객체 생성 실패: **[Tagging]** 버튼을 클릭하여 태깅 작업 다시 진행
- 객체 생성 완료 후 **[Tagging]** 버튼을 클릭하여 태깅을 다시 진행할 수 있습니다. 단, 기존 객체에 새로운 객체 데이터로 덮어쓰게 됩니다.

## 오브젝트 수정

업로드한 영상이 데이터 준비 중 또는 태깅 대기 상태일 때 오브젝트 이름을 수정할 수 있습니다. 단, 콘솔에서 오브젝트 이름을 변경하더라도 ARC eye Scan 앱에 저장된 파일 이름과 연동되지 않습니다. 오브젝트 이름을 수정하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Digital Twin** > **ARC eye** 메뉴를 차례대로 클릭해 주십시오.
2. **Visual Object Tracking > Object** 메뉴를 차례대로 클릭해 주십시오.
3. 오브젝트 목록에서 수정 대상 오브젝트에 있는 **[수정]** 버튼을 클릭해 주십시오.
4. 수정 창이 나타나면 **새 이름**에  오브젝트 이름을 수정한 후 **[저장]** 버튼을 클릭해 주십시오.
  - 영어 소문자, 한글, 숫자, 특수문자(-)를 사용하여 최대 36자 이하로 입력
  - 수정을 취소하려면 **[취소]** 버튼을 클릭해 주십시오.

## 오브젝트 삭제

생성한 오브젝트를 삭제할 수 있습니다. 삭제하는 방법은 다음과 같습니다.

              주의

              

삭제한 데이터는 복구할 수 없으므로 신중하게 결정해 주십시오.

              참고

              

API 배포 중이거나 배포 완료된 오브젝트는 삭제할 수 없습니다. 오브젝트를 삭제하려면 **[API](/docs/arceye-votapi)** 메뉴에서 해당 오브젝트의 API 배포를 모두 중지한 후 다시 시도해 주십시오.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Digital Twin** > **ARC eye** 메뉴를 차례대로 클릭해 주십시오.
2. **Visual Object Tracking > Object** 메뉴를 차례대로 클릭해 주십시오.
3. 삭제할 오브젝트를 클릭하여 선택한 후 **[오브젝트 삭제]** 버튼을 클릭해 주십시오.
4. 오브젝트 삭제 팝업 창이 나타나면 **[삭제]** 버튼을 클릭해 주십시오.