WebXR 메시 감지 모듈

const session = await navigator.xr.requestSession("immersive-ar", {
  requiredFeatures: ["mesh-detection"]
});

[Exposed=Window] interface XRMesh {
    [SameObject] readonly attribute XRSpace meshSpace;

    readonly attribute Float32Array vertices;
    readonly attribute Uint32Array indices;
    readonly attribute DOMHighResTimeStamp lastChangedTime;
    readonly attribute DOMString? semanticLabel;
};

[Exposed=Window] interface XRMeshSet {
  readonly setlike<XRMesh>;
};

partial interface XRFrame {
  readonly attribute XRMeshSet detectedMeshes;
};

frame에 대한 메시를 업데이트하기 위해 사용자 에이전트는 다음 단계를 실행해야 한다:

1. session을 frame의 세션으로 둔다.

2. device를 session의 XR 기기로 둔다.

3. trackedMeshs를 frame의 시간에 추적 중인 메시를 가져오기 위해 device의 네이티브 메시 감지 기능을 호출한 결과로 둔다.

4. trackedMeshs의 각 native mesh에 대해 다음을 실행한다:

   1. 필요한 경우 native mesh가 trackedMeshs에 존재하지 않는 것처럼 처리하고 다음 항목으로 계속한다. 이러한 방식으로 항목을 무시할지 결정하는 데 사용할 수 있는 기준은 § 6 개인정보 보호 및 보안 고려사항을 참조한다.

   2. session의 추적 중인 메시 집합에 native mesh와 대응하는 객체 mesh가 포함되어 있으면, mesh, native mesh, frame을 사용하여 메시 객체 업데이트 알고리즘을 호출하고 다음 항목으로 계속한다.

   3. mesh를 native mesh와 frame을 사용하여 메시 객체 생성 알고리즘을 호출한 결과로 둔다.

   4. mesh를 session의 추적 중인 메시 집합에 추가한다.

5. 이 알고리즘을 호출하는 동안 생성되거나 업데이트되지 않은 session의 추적 중인 메시 집합의 각 객체를 제거한다.

6. frame의 detectedMeshes를 추적 중인 메시 집합으로 설정한다.

네이티브 메시 객체 native mesh와 XRFrame frame으로부터 메시 객체를 생성하기 위해 사용자 에이전트는 다음 단계를 실행해야 한다:

1. result를 XRMesh의 새로운 인스턴스로 둔다.

2. result의 네이티브 엔터티를 native mesh로 설정한다.

3. result의 meshSpace를 세션이 frame의 session으로 설정되고 네이티브 원점이 native mesh의 네이티브 원점을 추적하도록 설정되어 생성된 새로운 XRSpace 객체로 설정한다.

4. result, native mesh, frame을 사용하여 메시 객체 업데이트 알고리즘을 호출한다.

5. result를 반환한다.

이러한 방식으로 생성된 메시 객체 result는 전달된 네이티브 메시 객체 native mesh에 대응한다고 한다.

네이티브 메시 객체 native mesh와 XRFrame frame으로부터 메시 객체 mesh를 업데이트하기 위해 사용자 에이전트는 다음 단계를 실행해야 한다:

1. mesh의 프레임을 frame으로 설정한다.

2. mesh의 vertices를 native mesh의 정점을 나타내는 새로운 정점 배열로 설정하고, 네이티브 메시 표현의 차이를 처리하는 데 필요한 모든 변환을 수행한다.

3. mesh의 indices를 native mesh의 정점을 나타내는 새로운 색인 배열로 설정하고, 네이티브 메시 표현의 차이를 처리하는 데 필요한 모든 변환을 수행한다.

4. 필요한 경우 § 6 개인정보 보호 및 보안 고려사항에 설명된 대로 mesh의 vertices와 indices의 세부 수준을 낮춘다.

5. mesh의 lastChangedTime을 시간으로 설정한다.