위젯 작업 > 3D > 영역 대상
  
영역 대상
* 
경험에서 영역 대상 위젯을 사용하려면 먼저 영역 대상을 작성해야 합니다.
이 위젯의 기능은 무엇인가요?
영역 대상 위젯을 사용하면 영역 대상을 추적 방법으로 사용할 수 있습니다. 영역 대상은 Vuforia의 환경 추적 기능을 사용자의 경험에 활용하여 영역과 공간을 추적하고 증강시킬 수 있습니다. 영역 대상을 사용하면 공간 단서를 이용하여 적합한 콘텐츠로 쉽게 이동할 수 있으므로 궁극적으로 운영 효율성과 작업 안전이 개선됩니다.
이 위젯은 언제 사용해야 하나요?
영역 대상은 탐색할 주변 환경을 대화형 요소로 사용하여 공간 지침을 생성할 때 사용할 수 있습니다. 예를 들어, 스캔한 환경에서 증강을 정지 상태의 객체로 전달하려는 경우 영역 대상을 사용할 수 있습니다. 영역 대상에 대한 자세한 내용은 Vuforia Developer Library를 참조하십시오. 또는, 추가 리소스를 확인하려면 영역 대상 문제 해결 및 추가 리소스 항목을 참조하십시오.
특별한 속성, 서비스, 이벤트 또는 작업이 있나요?
공통적인 위젯 속성, 서비스 및 이벤트 목록을 보려면 공통적인 위젯 속성, 서비스 및 이벤트 항목을 참조하십시오.
다음 테이블은 이 위젯에 한정된 속성 목록입니다.
캔버스 도구
설명
- 영역 탐색 모드
사용자의 경험에 영역 대상이 포함되어 있는 경우 영역 탐색 모드가 활성화됩니다. 이 모드를 사용하면 키보드의 키를 사용하여 영역 대상의 영역 또는 공간을 보다 쉽게 탐색할 수 있습니다. 자세한 내용은 3D 캔버스에서 영역 대상 탐색 항목을 참조하십시오.
또한, 위치를 두 번 클릭하여 바로 이동할 수도 있습니다.
속성
JavaScript
유형
설명
데이터 집합
dataset
resource url
영역 대상 파일이 포함된 <target_name>.zip을 업로드합니다. 이 .zip에는 다음 파일이 포함되어야 합니다.
<target_name>.dat
<target_name>.xml
<target_name>_authoring.glb
<target_name>_navmesh.glb(가림의 경우 선택 사항)
XML 데이터
xmlData
resource url
데이터 집합이 업로드되면 XML 데이터가 영역 대상 .zip에서 .xml 파일의 값으로 설정됩니다.
모델 URL
src
resource url
데이터 집합이 업로드되면 모델 URL이 영역 대상 .zip에서 .dat 파일의 값으로 설정됩니다.
미리 보기에 모델 표시
showRepresentation
boolean
선택할 경우 Vuforia Studio에서 경험을 미리 볼 때 모델이 표시됩니다.
가림 URL
occluder
resource url
데이터 집합을 업로드했으며 이 데이터 집합에 <target_name>_navmesh.glb 파일이 포함된 경우, 가림 URL이 영역 대상 .zip<target_name>_navmesh.glb 파일의 값으로 설정됩니다.
가림 적용
applyOcclusion
boolean
선택할 경우 영역 대상 탐색 메쉬(지정된 경우)에 가림이 적용됩니다.
안내 텍스트
guideText
string
영역 대상을 사용할 때 사용자를 안내하는 텍스트입니다.
추적됨
istracked
boolean
카메라가 대상을 인식할 때 활성화됩니다.
이벤트
JavaScript
설명
추적 얻음
trackingacquired
카메라가 영역을 인식할 때 트리거됩니다.
추적 손실
trackinglost
카메라가 영역을 더 이상 인식하지 않을 때 트리거됩니다.
위젯 작동
본 예는 위젯의 작동 장면입니다.
사용에 필요한 최소 단계
작동 장면
* 
사용자의 경험에 영역 대상을 포함하려면 이미 영역 대상을 작성해 두어야 합니다.
1. 영역 대상 위젯을 캔버스로 끌어서 놓습니다.
2. 데이터 집합 필드 옆의 + 아이콘을 클릭하여 사용자의 영역 대상에 대한 .zip 파일을 업로드합니다.
3. 영역 대상의 다른 위치에 위젯을 추가합니다. 이 예에서는 3D 게이지를 추가했습니다.