https://developer.oculus.com/documentation/unity/unity-mr-utility-kit-overview

Scene API 관련 기능을 더 편하게 쓰게 해준다는 것 같은데 아직은 무슨 의도로 분리해놓은지 잘 모르겠다.

MRUK 프리팹에 있는 Scene Loaded Event - Scene API를 사용할 때 보통 공간 정보를 불러올 때까지 기다려야 하므로 그런 경우에 이 이벤트를 구독할 수 있다. 본 키트의 다른 프리팹에서는 가끔 MRUKStart라는 컴포넌트가 달려 있는데 그것 또한 공간이 다 생길때까지 기다리기 위해 존재한다. 주의해야할 점은 만약 이러한 초기화에 순서가 중요한 것이 있다면 각 프리팹에 있어 순서를 결정할 수 없는 MRUKStart에 의존하지 말고 초기화하는 내용을 MRUK 프리팹에 있는 Scene Loaded Event로 옮기는 것이 좋다고 한다.

🔗 이 부분은 Features를 바탕으로 합니다.

MR 유틸리티 키트는 공간 인식 앱을 구축할 때 필요한 일반적 작업을 수행하기 위해 Scene API 위에 풍부한 유틸리티 및 도구 세트를 제공합니다. 이를 통해 실제 세계에 대해 프로그래밍하기가 더 쉬워지고 개발자는 앱을 독특하게 만드는 요소에 집중할 수 있습니다.

우리가 제공하는 유틸리티는 크게 3가지 범주로 나뉩니다:

• 빌트인 물리 엔진을 사용하지 않고 레이캐스트 쿼리하기.
• 바닥, 벽, 표면에서 유효한 스폰 위치 찾기.
• 레이캐스트를 사용하여 콘텐츠를 배치하기 위한 최적의 표면 위치를 찾기.
• 어떤 위치가 방 안에 있는지 확인하기.
• 방의 바운딩 박스 가져오기.
• 앵커 간의 부모/자식 관계 가져오기(예: 서로의 위에 쌓인 볼륨 또는 벽에 부착된 액자).

• 텍스처를 모델의 크기에 따라 늘어나거나 변형되지 않도록 이음매 없이 래핑하여 벽을 렌더링합니다. 이는 혼합 현실 세계의 스킨 바꿔 입히기에 중요합니다.
• 실제 물체와 일치하는 방향, 크기, 비율의 다양한 옵션을 사용하여 실제 물체를 대체할 수 있도록 가상의 오브젝트와 가구를 쉽게 배치하게 해줍니다.
• 사용자를 안전하게 보호하기 위해 애플리케이션에 구현된 방 바운더리.

• 디버거를 사용하면 앵커를 시각적으로 검사하여 위치, 방향, 레이블 등을 얻을 수 있습니다.
• 애플리케이션이 다양한 환경에서 작동하는지 확인할 수 있도록 하는 30개의 테스트용 방 프리팹 선택지.

🔗 이 부분은 Features를 바탕으로 합니다.

MR 유틸리티 키트를 사용하는 방법에는 두 가지가 있습니다: 코드를 통한 엔지니어링, 또는 Unity Inspector 내 프리팹 도구의 매개변수 조정.

엔지니어링할 때 주로 MRUK, MRUKRoom, MRUKAnchor 클래스를 다루게 될 것입니다. MRUK는 싱글톤 클래스이므로 장면에 MRUK 인스턴스는 하나만 있어야 합니다. 방 당 하나의 MRUKRoom 인스턴스가 있으며 모든 이 인스턴스들의 자식에는 MRUKAnchor 컴포넌트가 있습니다. 이 구조는 OVRSceneManager를 사용할 때의 OVRSceneRoom 및 OVRSceneAnchor와 유사합니다.

_{아래는 공식 문서에 있는 명세 번역입니다.}

• LoadSceneFromDevice(): 퀘스트 디바이스에서 씬 데이터를 로드합니다.
• LoadSceneFromPrefab(): 제공된 프리팹 중 하나 또는 당신의 씬을 로드합니다.
• ClearScene(): 씬 데이터 지우기
• GetRooms(): 현재 로드된 방의 리스트를 가져옵니다.
• GetCurrentRoom(): 사용자가 현재 위치한 방을 가져옵니다.

• GetRoomAnchors(): 방의 모든 MRUKAnchor에 접근합니다(방 자체의 앵커는 포함하지 않음).
• GetFloorAnchor(): 바닥 MRUKAnchor에 접근합니다.
• GetCeilingAnchor(): 천장 MRUKAnchor에 접근합니다.
• GetGlobalMeshAnchor(): 글로벌 메시 MRUKAnchor에 접근합니다.
• GetWallAnchors(): 방의 모든 벽 MRUKAnchor에 접근합니다.
• GetRoomOutline(): 방의 아랫면 모서리 점을 시계 방향 순서로 가져옵니다(위에서 아래로 볼 때).
• GetKeyWall(): 방에서 뒤에 다른 방 모서리가 없는 가장 긴 벽을 가져옵니다(허용 오차 범위 내).
• Raycast()/RaycastAll(): 방의 앵커만을 대상으로 충돌 없이 레이캐스트; 충돌 순서는 보장되지 않음에 유의하세요.
• GetBestPoseFromRaycast(): 레이캐스트에서 추천 포즈를 가져옵니다. 컨트롤러로 AR 콘텐츠를 배치할 때 유용합니다.
• IsPositionInRoom(): 위치가 방 아웃라인 내인지 확인합니다.
• GetRoomBounds(): 매크로 기능을 위한 월드 정렬 바운딩 박스
• GetFacingDirection(): 볼륨에 대해, 가장 가까운 벽면의 방향에 따라 Y-forward 벡터(일 가능성이 높은)를 구합니다.
• IsPositionInSceneVolume(): 위치가 방의 아무 볼륨 내인지 확인합니다.
• TryGetClosestSeatPose(): 광선에서 모든 소파 오브젝트에서 가장 가까운 좌석 포즈를 반환합니다.
• GetSeatPoses(): 방의 모든 좌석 포즈를 반환합니다 (방에 소파 오브젝트가 없는 경우 0).
• TryGetAnchorParent(): 플랫 씬 계층구조(방과 앵커)가 있으므로, 논리적인 부모를 찾으려고 시도합니다. 예를 들어 문이 어느 벽에 붙어 있는지, 또는 볼륨이 다른 볼륨에 쌓여 있는지
• TryGetAnchorChildren(): 위와 비슷하지만 반대 관계의 경우
• `DoesRoomHave(): 방에 시맨틱 레이블이 있는 객체가 있는지 확인하기 위한 한 줄 액세스
• TryGetClosestSurfacePosition(): 주로 RoomGuardian 프리팹에 사용되며, 아무 씬 표면에서 가장 가까운 지점을 반환합니다.
• FindLargestSurface(): 사용 가능한 표면적이 가장 큰 앵커를 반환합니다.
• GenerateRandomPositionInRoom(): 볼륨 씬 오브젝트와 표면에 너무 가까운 점을 피하면서 방에 임의의 위치를 생성합니다.
• GenerateRandomPositionOnSurface(): 방의 아무 유효한 표면에 위치를 생성합니다.

• Raycast(): this 앵커에 대해 충돌 없는 레이캐스트
• IsPositionInBoundary(): 위치가 plane의 2D 경계 내에 있는지 확인합니다(오브젝트에 plane이 없는 경우 false).
• GetDistanceToSurface(): 한 점에서 이 앵커의 표면까지의 최단 거리를 구합니다.
• GetClosestSurfacePosition(): 앵커의 표면에서 주어진 점과 가장 가까운 위치를 구합니다.
• GetAnchorCenter(): 위치가 볼륨의 상단에 있기 때문에 Scene API 볼륨에서 transform.position을 사용하는 것은 올바르지 않습니다. 이것이 중심을 반환합니다.
• GetAnchorSize(): 볼륨을 우선으로 앵커의 Vector3 스케일을 가져옵니다. 일부 앵커에는 2D 및 3D 바운드가 모두 있으므로 특정한 스케일을 원하는 경우 참고하세요:
  • PlaneRect.Value.size: (Vector2를 반환합니다: 먼저 HasPlane이 참인지 확인하세요.)
  • VolumeBounds.Value.size: (Vector3를 반환합니다: 먼저 HasVolume이 참인지 확인하세요.)
• AnchorLabels: 이 앵커에 어떤 시맨틱 레이블이 있는지 파악하려면 이것을 쿼리하세요.
• GetBoundsFaceCenters() -> Vector3: 각 표면의 중심점(평면인 경우 1개, 볼륨인 경우 6개)을 가져옵니다.
• IsPositionInVolume(Vector3 worldPosition, bool testVerticalBounds, float distanceBuffer = 0.0f) -> bool: 위치가 이 볼륨 안에 있는지 테스트합니다.
• HasLabel(string label) -> bool: 앵커에 특정 시맨틱 레이블이 있는지 확인합니다.
• GetLabelsAsEnum() -> SceneLabels: 이 오브젝트의 모든 시맨틱 라벨을 가져옵니다.

패키지에서 직접 스크립트를 확인해 보면 공식 문서에 없는 함수도 보이니 실제로 사용할 때는 확인을 한 번 더 하기

월드 잠금은 개발자가 가상 ​​세계를 현실 세계와 더 쉽게 동기화할 수 있게 해주는 새로운 기능입니다. 가상 콘텐츠는 앵커에 명시적으로 연결할 필요 없이 장면에 임의로 배치할 수 있으며, MRUK는 후드 아래의 장면 앵커를 사용하여 카메라를 실제 세계와 동기화되도록 관리합니다. 이는 카메라 장비의 추적 공간 변환을 눈에 띄지 않게 약간 조정하여 근처 장면 앵커가 올바른 위치에 나타나도록 최적화함으로써 달성됩니다.

이전에는 현실 세계와 가상 세계의 동기화를 유지하기 위해 권장되는 방법은 모든 가상 콘텐츠 조각이 앵커에 연결되도록 하는 것이었습니다. 이는 어떤 것도 정적인 것으로 간주될 수 없으며 매 프레임마다 조금씩 움직이는 것에 대처해야 함을 의미합니다. 이로 인해 네트워킹, 물리, 렌더링 등과 관련된 여러 가지 문제가 발생할 수 있습니다. 월드 잠금이 활성화되면 가상 콘텐츠가 정적으로 유지될 수 있습니다. 플레이어에 가까운 공간은 동기화된 상태로 유지되지만 더 멀리 있는 공간은 실제 세계와 약간 다를 수 있다는 단점이 있습니다.

월드 잠금은 기본적으로 활성화되어 있지만 MRUK 인스턴스에서 EnableWorldLock을 false로 설정하여 비활성화할 수 있습니다.

Core/Tools 폴더에 있는 이러한 프리팹은 장면에 드롭되고 Inspector 인터페이스에서 선택적으로 수정되도록 설계되었습니다. 이러한 프리팹 중 일부는 MRUKStart 컴포넌트를 가지고 있다는 것을 참고하세요. 이는 끌어서 놓기 방식으로 사용하기 쉽도록 하기 위한 것입니다. 그러나 코드에 초기화 종속성이 있는 경우 초기화 함수를 하나의 정렬된 목록(가급적 MRUK 프리팹에서)으로 수동으로 구성해야 합니다. 이에 대한 예는 자신의 게임 코드에서 EffectMesh의 메시에 액세스하려는 경우, EffectMesh.CreateMesh() 함수를 단일 Scene Loaded Event 리스트에서 자신의 코드 함수 위에 있게 하여 먼저 실행되도록 보장해야 합니다. 단계적으로 이는 다음과 같습니다:

1. MRUK 및 EffectMesh 프리팹을 장면으로 드래그합니다. EffectMesh 프리팹에서 MRUKStart 컴포넌트를 제거합니다.
2. MRUK 프리팹에서 Scene Loaded Event 목록에 EffectMesh.CreateMesh() 함수를 추가합니다.
3. 그 밑 리스트에 자신만의 초기화 코드를 추가하세요.

MR 유틸리티 키트를 사용하려면 필요합니다.

• Scene Loaded Event: 이 이벤트에 구독해서 자신의 게임 코드를 초기화하세요 (“Creating a New Scene”을 참고하세요).
• Scene Settings
  • Data Source: Scene Anchor를 생성하는 데 사용되는 트랜스폼:
    • Device: Space Setup을 통해 Quest 장치에서 생성된 데이터를 사용합니다(Link에도 사용).
    • Prefab: Room Index와 Room Prefabs 중 하나에 의해 지정된 인공 방을 사용합니다.
    • DeviceWithPrefabFallback: 기기 데이터가 존재하지 않는 경우 프리팹 룸을 사용합니다.
  • Room Index: Room Prefabs 배열에 대한 인덱스(0 시작)입니다. -1은 랜덤을 의미합니다.
  • Room Prefabs: Scene 데이터를 시뮬레이션하기 위한 인공 방입니다. 기존 방 프리팹의 구조와 게임 오브젝트 이름을 참조하여 자신만의 시뮬레이션된 방을 만들 수 있습니다.
  • Load Scene on Startup: 활성화되면 Scene이 존재하는 경우 자동으로 로드되고 SceneLoadedEvent는 다른 작업 없이 실행됩니다. false인 경우 장치가 없는 회의실(예: 네트워크 연결)에서 MRUK를 사용하는 등 Scene 초기화 동작을 수동으로 제어할 수 있습니다.
  • Seat Width: COUCH 라벨이 있는 Scene 오브젝트의 좌석 포즈를 계산할 때 사람 좌석 크기의 너비/깊이입니다.

이것은 지정한 Scene 오브젝트에서 특수 효과를 생성합니다. 각 엣지에는 선택적 셰이더 사용을 위해 버텍스 컬러가 적용되어 있습니다. 메쉬를 만들 때 다양한 매핑 옵션을 사용할 수 있습니다.

• Mesh Material: 건축된 메시에 적용할 재질입니다. 다중 머리티얼 룸을 원하는 경우 다른 메시 머티리얼와 함께 또다른 EffectMesh 오브젝트를 사용할 수 있습니다.
• Border Size: 엣지 바운드에 대한 정점을 만들 때, 이는 각 엣지의 "두께"입니다. 엣지 버텍스는 검은색으로 표시되고 BorderSize 거리에 따라 흰색으로 희미해집니다. RoomBoxEffects.mat에 사용된 SceneMeshOutline.shader를 조사하면 셰이더에서 이것이 어떻게 활용되는지 확인할 수 있습니다.
• Frames Offset: 벽에 있는 쿼드(예: 문, 창문, 액자)의 경우 동일한 측면 평면에 존재하기 때문에 Z-flickering이 발생할 수 있습니다. FramesOffset은 벽에서 그것들을 이 ​​미터 값만큼 연장합니다.
• Add Colliders: true인 경우 EffectMesh 프리미티브에 대해 충돌이 발생합니다.
• Cast Shadows: effect mesh 오브젝트가 그림자를 투사할지 여부입니다.
• Hide Mesh: effect mesh를 숨깁니다.
• Texture Coordinate Modes: 생성된 메시 UV에 텍스처 좌표가 적용되는 방식, 일반적으로 인접한 WALL_FACE 객체에만 사용됩니다. U는 방 경계의 수평 치수를 나타내고 V는 수직 치수를 나타냅니다.
  • METRIC: 좌표는 0에서 시작하여 미터당 1단위씩 증가합니다.
  • METRIC_SEAMLESS: 좌표는 0에서 시작하여 미터당 1단위씩 증가하지만 이음새를 방지하기 위해 정수로 끝나도록 조정됩니다.
  • MAINTAIN_ASPECT_RATIO: 종횡비가 유지되도록 좌표가 다른 치수에 맞게 조정됩니다.
  • MAINTAIN_ASPECT_RATIO_SEAMLESS: 좌표는 종횡비가 유지되도록 다른 치수에 맞게 조정되지만 이음새를 피하기 위해 정수로 끝나도록 조정됩니다.
  • STRETCH: Coordinates range from 0 to 1.
• Labels: EffectMesh에 포함될 의미 체계 객체.