WebXR 원시 카메라 접근 모듈

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

partial interface XRView {
  [SameObject] readonly attribute XRCamera? camera;
};

XRView view에 대해 카메라를 획득하기 위해, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. session을 view의 session으로 둔다.

2. camera-access 기능 기술자가 session의 set of granted features에 포함되어 있지 않으면, null을 반환하고 이 단계를 중단한다.

3. frame을 view의 frame으로 둔다.

4. frame의 active 불리언이 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

5. frame의 animationFrame 불리언이 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

6. camera image를 frame의 time에 유효한 네이티브 카메라에서 반환된, width x height 텍셀 크기의 카메라 이미지 버퍼를 포함하는 것으로 둔다.

7. camera image가 null이면, null을 반환하고 이 단계를 중단한다.

8. camera image가 view와 정렬된 데이터를 포함하도록 보장한다. 여기에는 적절하게 width와 height를 조정하는 것도 포함된다. 가능하지 않으면, null을 반환하고 이 단계를 중단한다.

9. view, camera image, width 및 height로 카메라 인스턴스 생성 알고리즘을 호출하고 그 결과를 반환한다.

[SecureContext, Exposed=Window]
interface XRCamera {
  readonly attribute unsigned long width;
  readonly attribute unsigned long height;
};

XRView view, camera image, width 및 height로부터 카메라 인스턴스 생성을 하기 위해, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. result를 XRCamera 인터페이스의 새 인스턴스로 둔다.

2. result의 view를 view로 설정한다.

3. result의 camera image를 camera image로 설정한다.

4. result의 width를 width로 설정한다.

5. result의 height를 height로 설정한다.

6. result를 반환한다.

partial interface XRWebGLBinding {
  WebGLTexture? getCameraImage(XRCamera camera);
};

XRWebGLBinding binding에서, XRCamera camera에 대해 카메라 이미지 획득을 하기 위해, 사용자 에이전트는 다음 단계를 실행해야 한다:

1. session을 binding의 session으로 둔다.

2. view를 camera의 view로 둔다.

3. view의 session이 session과 일치하지 않으면, InvalidStateError를 던지고 이 단계를 중단한다.

4. frame을 view의 frame으로 둔다.

5. frame의 active 불리언이 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

6. frame의 animationFrame 불리언이 false이면, InvalidStateError를 던지고 이 단계를 중단한다.

7. context를 binding의 context로 둔다.

8. camera image를 camera의 camera image로 둔다.

9. result를 context에서 생성된, camera image의 데이터를 포함하는 WebGLTexture로 둔다. result는 불투명 텍스처다.

10. result를 반환한다.