WebXR 평면 감지 모듈

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

enum XRPlaneOrientation {
    "horizontal",
    "vertical"
};

[Exposed=Window]
interface XRPlane {
    [SameObject] readonly attribute XRSpace planeSpace;

    readonly attribute FrozenArray<DOMPointReadOnly> polygon;
    readonly attribute XRPlaneOrientation? orientation;
    readonly attribute DOMHighResTimeStamp lastChangedTime;
    readonly attribute DOMString? semanticLabel;
};

[Exposed=Window]
interface XRPlaneSet {
  readonly setlike<XRPlane>;
};

partial interface XRFrame {
  readonly attribute XRPlaneSet detectedPlanes;
};

partial interface XRSession {
  Promise<undefined> initiateRoomCapture();
};

이 메서드가 호출되면 사용자 에이전트는 다음 단계를 실행해야 한다:

1. session을 this로 둔다

2. promise을 session의 관련 렐름에서 생성한 새 Promise로 둔다.

3. session의 ended 값이 `true`이면, "InvalidStateError" DOMException으로 promise을 거부하고 promise을 반환한다.

4. 방 캡처 완료가 `true`이면, "InvalidStateError" DOMException으로 promise을 거부하고 promise을 반환한다.

5. plane-detection 기능 설명자가 session의 XR 기기에 있는 session의 모드용 활성화된 기능 목록에 포함되어 있지 않으면, "NotSupportedError" DOMException으로 promise을 거부하고 promise을 반환한다.

6. session의 XR 기기가 수동 캡처를 지원하지 않거나 XRSystem이 방 캡처가 필요하지 않다고 판단하면:

   1. session의 방 캡처 완료를 `true`로 설정한다.

   2. promise을 이행한다.

   3. promise을 반환한다.

7. 다음 단계를 수행하도록 태스크를 큐에 넣는다:

   1. session의 XR 기기에 있는 방 캡처 메서드를 호출하고 그 결과를 기다린 뒤, 해당 결과를 result에 할당한다.

   2. 다음 단계를 실행한다:

      result가 `true`인 경우:

      promise을 이행한다

      그렇지 않은 경우:

      "OperationError" DOMException으로 promise을 거부한다

   3. session의 방 캡처 완료를 `true`로 설정한다.

8. promise을 반환한다.

frame의 평면을 갱신하려면 사용자 에이전트는 다음 단계를 실행해야 한다:

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

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

3. plane-detection 기능 설명자가 device의 session 모드용 활성화된 기능 목록에 포함되어 있지 않으면 이 단계를 중단한다.

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

5. trackedPlanes의 각 native plane에 대해 다음을 실행한다:

   1. 필요한 경우 native plane이 trackedPlanes에 없는 것처럼 취급하고 다음 항목으로 계속한다. 이 방식으로 항목을 무시할지 판단하는 데 사용할 수 있는 기준은 § 6 개인정보 보호 및 보안 고려사항을 참조한다.

   2. session의 추적 중인 평면 집합에 native plane에 대응하는 객체 plane이 포함되어 있으면, plane, native plane, frame을 사용해 평면 객체 갱신 알고리즘을 호출하고 다음 항목으로 계속한다.

   3. plane을 native plane과 frame을 사용해 평면 객체 생성 알고리즘을 호출한 결과로 둔다.

   4. plane을 session의 추적 중인 평면 집합에 추가한다.

6. 이 알고리즘을 호출하는 동안 생성되거나 갱신되지 않은 모든 객체를 session의 추적 중인 평면 집합에서 제거한다.

7. frame의 detectedPlanes를 추적 중인 평면 집합으로 설정한다.

네이티브 평면 객체 native plane과 XRFrame frame에서 평면 객체를 생성하려면 사용자 에이전트는 다음 단계를 실행해야 한다:

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

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

3. result의 planeSpace를 세션은 frame의 session으로 설정하고, 네이티브 원점은 native plane의 네이티브 원점을 추적하도록 설정하여 생성한 새 XRSpace 객체로 설정한다.

4. result, native plane, frame을 사용해 평면 객체 갱신 알고리즘을 호출한다.

5. result를 반환한다.

이 방식으로 생성한 평면 객체 result는 전달된 네이티브 평면 객체 native plane에 대응한다고 한다.

네이티브 평면 객체 native plane과 XRFrame frame으로부터 plane 평면 객체를 갱신하려면 사용자 에이전트는 다음 단계를 실행해야 한다:

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

2. 기반 시스템이 native plane을 수직으로 분류한 경우 plane의 orientation을 "vertical"로 설정한다. 그렇지 않고 기반 시스템이 native plane을 수평으로 분류한 경우 plane의 orientation을 "horizontal"로 설정한다. 그 외의 경우에는 plane의 orientation을 null로 설정한다.

3. plane의 polygon을 네이티브 평면 다각형 표현의 차이를 고려하는 데 필요한 모든 변환을 수행하여 native plane의 다각형을 나타내는 새 꼭짓점 배열로 설정한다.

4. plane의 semanticLabel을 의미 레이블이 포함된 새 문자열로 설정한다.

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

6. plane의 lastChangedTime을 시간으로 설정한다.

// `planes`는 애플리케이션이 알고 있는 감지된 모든 평면과
// 해당 평면이 갱신된 타임스탬프를 추적한다. 처음에는 빈 맵이다.
const planes = Map();

function onXRFrame(timestamp, frame) {
  const detectedPlanes = frame.detectedPlanes;

  // 먼저, 알고 있던 평면 중 더 이상 추적되지 않는 평면이 있는지 확인한다:
  for (const [plane, timestamp] of planes) {
    if(!detectedPlanes.has(plane)) {
      // 제거된 평면을 처리한다. `plane`은 이전 프레임에는 있었지만
      // 이제 더 이상 추적되지 않는다.

      // 평면이 더 이상 존재하지 않음을 알았으므로 맵에서 제거한다:
      planes.delete(plane);
    }
  }

  // 그런 다음 아직 추적 중인 모든 평면을 처리한다.
  // 여기에는 이전에 확인한 추적 중인 평면(갱신되었을 수 있음)과
  // 새 평면이 모두 포함된다.
  detectedPlanes.forEach(plane => {
    if (planes.has(plane)) {
      // 이전에 확인한 평면을 처리한다:

      if(plane.lastChangedTime > planes.get(plane)) {
        // 갱신된, 이전에 확인한 평면을 처리한다.
        // 이는 평면의 속성 중 하나가 이전과 달라졌음을 의미하며,
        // 대부분의 경우 다각형이 변경된 것이다.

        ... // 평면을 렌더링하거나 렌더링을 준비하는 등의 작업을 한다.

        // 평면을 갱신한 시간을 갱신한다:
        planes.set(plane, plane.lastChangedTime);
      } else {
        // 현재 프레임에서 갱신되지 않은, 이전에 확인한 평면을 처리한다.
        // 다른 공간에 대한 평면의 상대 자세는 변경되었을 수 있다.
      }
    } else {
      // 새 평면을 처리한다.

      // 평면을 갱신한 시간을 설정한다:
      planes.set(plane, plane.lastChangedTime);
    }

    // 평면을 이전에 확인했는지 또는 갱신했는지와 관계없이
    // 해당 평면의 자세는 변경되었을 수 있다:
    const planePose = frame.getPose(plane.planeSpace, xrReferenceSpace);
  });

  frame.session.requestAnimationFrame(onXRFrame);
}