위젯 작업 > 3D > 공간 대상
  
공간 대상
이 위젯의 기능은 무엇인가요?
공간 대상 위젯을 사용하면 경험에서 공간을 추적할 수 있습니다.
이 위젯은 언제 사용해야 하나요?
ThingMark를 사용하지 않고 모델을 서피스에 배치하려는 경우 공간 대상을 사용합니다. 예를 들어 잠재 고객에게 생성기가 현장의 특정 위치에서 어떻게 작동하는지 보여주려는 경우 AR 경험을 만들 때 공간 대상을 사용하십시오.
공간 대상 위젯을 포함하는 경험을 생성할 때 다음을 고려하십시오.
모바일 장치에서 공간 추적 경험을 볼 때 쉐이크 제스처를 사용하면 추적이 중단되고 배치 모드로 되돌아갑니다. 추적이 손실된 경우 장치를 쉐이크하여 추적을 복원합니다.
HoloLens에서 추적을 중단하려면 "Hey View, update tracking"이라고 말하거나 모델 근처의 메뉴에서 "재설정" 버튼을 누릅니다.
공간 추적 보기가 포함된 경험은 지원되는 iOS 및 Android 장치에만 표시됩니다. 지원되는 장치에 대한 자세한 내용은 Vuforia Developer Library에서 Ground Plane: 사전 요구 사항 섹션을 참조하십시오.
* 
Vuforia View는 Vuforia의 Ground Plane 기술의 최신 버전을 사용하지 않을 수도 있습니다. 따라서 사용자의 장치가 Vuforia View에 대해 아직 지원되지 않을 수 있습니다.
시퀀스는 경험의 배치 단계 중 가상 효과를 방해할 수 있습니다. 현재 가상 렌더링은 TML에서 명시적으로 선언된 모든 모델 및 모델 항목에 적용됩니다. 모델에 적용된 모든 시퀀스는 시퀀스의 모든 모델 항목에 대한 렌더링 모드를 무시합니다. 시퀀스의 모델 항목이 TML에서 해당하는 모델 항목을 포함하고 있지 않은 경우 가상으로 렌더링되지 않습니다. 시퀀스가 포함된 모델의 경우 모범 사례는 배치가 완료될 때까지 모델에 대한 시퀀스가 설정되도록 기다린 후 추적이 손실되면 시퀀스의 설정을 해제하는 것입니다. 화면을 탭핑하여 배치 모드로 설정하면 추적 얻음 이벤트가 발생합니다. 장치를 쉐이크하면 추적 손실 이벤트가 발생합니다. 원하는 모델에서 시퀀스를 설정 또는 제거하려면 이러한 두 개 이벤트를 사용합니다.
공간 추적을 사용하는 경험을 보려면 사용자의 Vuforia View 설정에서 ThingView 렌더러가 사용 가능해야 합니다.
* 
HoloLens 장치에는 적용되지 않습니다.
공간 추적 콘텐츠는 장치에 따라 다르게 배율을 조정할 수 있습니다.
ARKit 장치의 경우 모델 배치 시 추적을 시작하려면 장치를 이동해야 할 수 있습니다.
비 ARKit 장치의 경우 ARKit 장치에 비해 3D 객체 안정성이 감소할 수 있습니다.
* 
HoloLens 장치에는 적용되지 않습니다.
단색 표면에 3D 객체를 배치하거나 투명도가 높거나 빛을 반사하는 물체를 피하십시오(예: 모두 흰색으로 된 책상). 대신 돌극성, 흥미로운 특징 및 텍스처를 가진 서피스에 3D 객체 또는 객체를 배치하십시오.
특별한 속성, 서비스, 이벤트 또는 작업이 있나요?
공통적인 위젯 속성, 서비스 및 이벤트 목록을 보려면 공통적인 위젯 속성, 서비스 및 이벤트 항목을 참조하십시오.
다음 테이블은 이 위젯에 한정된 속성, 서비스 및 이벤트 목록을 제시합니다.
속성
JavaScript
유형
설명
X 좌표
x
number
x축에서의 공간 대상 위치입니다.
Z 좌표
z
number
z축에서의 공간 대상 위치입니다.
추적됨
istracked
boolean
카메라가 대상을 인식할 때 활성화됩니다.
이동 제스처 사용
enabletranslategesture
boolean
경험에서 이동 제스처를 사용할 수 있으며 장면을 이동할 수 있습니다.
회전 제스처 사용
enablerotategesture
boolean
경험에서 회전 제스처를 사용할 수 있으며 두 손가락으로 장면을 회전할 수 있습니다.
배율 제스처 사용
enablescalegesture
boolean
경험에서 배율(확대/축소) 제스처를 사용할 수 있으며 장면의 크기를 변경할 수 있습니다.
서비스
JavaScript
설명
제스처 변경 내용 재설정
resetGesture
제스처(이동, 회전, 확대/축소)를 사용해 요소를 주변으로 이동한 후 장면을 원래 크기 및 위치로 재설정합니다.
이벤트
JavaScript
설명
추적 얻음
trackingacquired
카메라가 표면을 인식할 때 트리거됩니다. 증강에는 대상(ID) 및 연관된 메타데이터가 포함됩니다.
추적 손실
trackinglost
카메라가 표면을 더 이상 인식하지 않을 때 트리거됩니다. 증강에는 대상(ID) 및 연관된 메타데이터가 포함됩니다.
위젯 작동
본 예는 위젯의 작동 장면입니다.
사용에 필요한 최소 단계
작동 장면
1. 공간 추적 위젯을 캔버스로 끌어서 놓습니다.
2. 경험에서 표시하려는 위젯을 끌어서 놓습니다. 본 예에서는 모델 위젯을 입력했습니다.
3. 프로젝트 창의 구성 > 경험 아래에서 ThingMark 연결 드롭다운의 없음을 선택합니다.
4. 경험이 게시되면 사용자의 라이브러리에 표시됩니다. 경험을 열고 카메라를 수평 서비스에 맞춘 다음 화면을 탭핑해 모델을 배치합니다.