플랫폼별 가이드
AR 콘텐츠는 장면과 조화를 이루도록 올바르게 배치되고 크기가 조정되어야 합니다. 실제 객체와 마찬가지로 멀리 있는 가상 객체는 더 작게 표시되어야 합니다. Hit Test (또는 Unity용 AR Foundation의 Raycast)를 실행하여 장면에서 3D 객체의 올바른 배치를 결정할 수 있습니다. 올바른 배치를 통해 AR 콘텐츠가 적절한 (겉보기) 크기로 렌더링됩니다.
Hit Test는 실제 3D 도형과 원점 및 방향으로 구성된 가상 광선 간의 교차점을 찾습니다. 기기의 카메라를 원점으로 하는 광선이 가장 일반적으로 사용되지만 ARCore에는 세계 공간 좌표에서 임의의 광선으로 Hit Test를 실행하는 API가 포함되어 있습니다.
사용자 기기 카메라에서 시작하여 바닥, 벽, 객체와 같은 장면의 3D 도형에 도달할 때까지 앞으로 확장되는 광선이 있다고 가정해 보겠습니다. 이러한 일이 발생하면 감지된 장면 도형과의 교차점인 Hit 결과 목록이 표시됩니다. 목록은 기기와의 거리를 기준으로 정렬되며 가장 가까운 교차점이 먼저 표시됩니다. 일반적으로 다른 객체 뒤에 가려진 객체는 볼 수 없으므로 대부분 첫 번째 결과가 가장 중요합니다.

Hit 결과의 콘텐츠
개별 Hit 결과는 각 결과에 대한 다음 정보가 포함된 목록으로 반환됩니다.
- 광선 원점으로부터의 거리(미터)
- Hit 결과의 포즈 (위치 및 방향)
- Trackable 형식으로 Hit한 3D 도형
그런 다음 원하는 Hit 결과를 사용하여 앵커를 통해 3D 콘텐츠를 현실적으로 배치할 수 있습니다.
Hit 결과 유형
Hit 결과에는 깊이, 평면, 특징점, 인스턴트 배치 결과의 네 가지 유형이 있습니다. 각각의 사용 사례와 장단점은 다음 표에 나와 있습니다.
| Hit 결과 유형 | 설명 | 방향 | 사용 사례 |
|---|---|---|---|
| 깊이 | 전체 장면의 깊이 정보를 사용하여 점의 올바른 깊이와 방향을 결정합니다. | 3D 표면에 수직 | 바닥과 벽뿐만 아니라 임의의 표면에 가상 객체를 배치합니다. |
| 평면 | 수평 및/또는 수직 표면을 Hit하여 점의 올바른 깊이와 방향을 결정합니다. | 3D 표면에 수직 | 평면의 전체 도형을 사용하여 평면 (바닥 또는 벽)에 객체를 배치합니다. 올바른 크기를 즉시 지정해야 합니다. 깊이 Hit Test의 대체 |
| 특징점 | 사용자 탭 지점 주변의 시각적 특징을 사용하여 점의 올바른 위치와 방향을 결정합니다. | 3D 표면에 수직 | 바닥과 벽뿐만 아니라 임의의 표면에 객체를 배치합니다. |
| 인스턴트 배치 (영구 Raycast) | 화면 공간을 사용하여 콘텐츠를 배치합니다. 처음에는 앱에서 제공하는 예상 깊이를 사용합니다. 즉시 작동하지만 ARCore에서 실제 장면 도형을 결정할 수 있게 되면 포즈와 실제 깊이가 변경됩니다. | +Y가 위를 가리키고 중력과 반대 | 빠른 배치가 중요하고 환경에서 알 수 없는 초기 깊이와 크기를 허용할 수 있는 평면의 전체 도형을 사용하여 평면 (바닥 또는 벽)에 객체를 배치합니다. |
기기 호환성
Hit Test는 모든 ARCore 지원 기기에서 작동하지만 깊이 Hit Test에는 깊이 지원 기기가 필요합니다.
Hit 결과를 사용하여 AR 콘텐츠 배치
Hit 결과가 있으면 포즈를 입력으로 사용하여 장면에서 AR 콘텐츠를 배치할 수 있습니다.