# [name]

此类表示WebXR设备API的抽象，并由[page:WebGLRenderer]在内部使用。 [name]还提供了一个公共接口，允许用户启用/禁用XR并执行XR相关任务，例如检索控制器。

## Properties

### [property:Boolean cameraAutoUpdate]

manager的XR摄像头是否应自动更新。默认为*true*。

### [property:Boolean enabled]

此标志通知渲染器准备好进行XR渲染。默认为假。 如果您要在应用中使用XR，请将其设置为*true*。

### [property:Boolean isPresenting]

XR演示是否处于活动状态。默认为*false*。该标志是只读的，由[name]自动设置。

## 方法(Methods)

### [method:ArrayCamera getCamera]()

返回表示活动XR会话的XR相机的[page:ArrayCamera]实例。 对于每个视图，它在其[page:ArrayCamera.cameras cameras]属性中包含一个单独的相机对象。

当前未使用相机的*fov*，不反映 XR 相机的 fov。 如果您需要应用级别的fov，则必须从XR相机的投影矩阵中手动计算。

### [method:Group getController]( [param:Integer index] )

[page:Integer index] — 控制器的索引。
返回表示XR控制器所谓的*目标光线*空间的[page:Group 组]。使用此空间可视化3D对象，支持用户完成UI交互等指向任务。

### [method:Group getControllerGrip]( [param:Integer index] )

[page:Integer index] — 控制器的索引。
返回一个[page:Group 组]，代表所谓的XR控制器的*抓地力*空间。如果用户要握住其他3D对象（如光剑），请使用此空间。

注意：如果你想显示用户手中的东西并同时提供指向光线， 你需要将手持对象附加到[page:.getControllerGrip]()返回的组， 并将光线附加到[page:.getController]()返回的组. 这个想法是在同一个WebXR控制器的两个不同坐标空间中有两个不同的组。

### [method:Group getHand]( [param:Integer index] )

[page:Integer index] — 控制器的索引。
返回代表XR控制器所谓的*手或关节*空间的[page:Group 组]。在不使用物理控制器时，使用此空间可视化用户的手。

### [method:String getReferenceSpace]()

返回参考空间。

### [method:XRSession getSession]()

返回*XRSession*对象，它允许在应用程序级别更细粒度地管理活动的WebXR会话。

### [method:undefined setFramebufferScaleFactor]( [param:Float factor], [param:Boolean limited] )

[page:Float factor] — 要设置的帧缓冲区比例因子。
[page:Boolean limited] — 如果值最终高于设备的能力，是否应将帧缓冲区比例因子减小到本机限制。默认为`false`。
指定在渲染到XR设备时确定帧缓冲区大小时要使用的比例因子。 该值是相对于默认XR设备显示分辨率的。默认为*1*。值0.5将指定具有显示器原始分辨率50%的帧缓冲区。

注意：在呈现XR内容时无法更改帧缓冲区比例因子。

### [method:undefined setReferenceSpace]( [param:XRReferenceSpace referenceSpace] )

[page:XRReferenceSpace referenceSpace] — 自定义参考空间。
可用于配置覆盖默认参考空间的自定义参考空间。

### [method:undefined setReferenceSpaceType]( [param:String referenceSpaceType] )

[page:String referenceSpaceType] — 要设置的参考空间类型。
可用于配置与用户物理环境的空间关系。 根据用户在3D空间中的移动方式，设置适当的参考空间可以改进跟踪。 默认为*本层空间*。 请查看[link:https://developer.mozilla.org/en-US/docs/Web/API/XRReferenceSpaceType MDN]以了解可能的值及其用例。

### [method:undefined updateCamera]( [param:PerspectiveCamera camera] )

更新 XR 相机的状态。 如果您将[page:.cameraAutoUpdate]设置为*false*，请在应用级别使用此方法。 该方法需要场景的非 XR 相机作为参数。 调用此方法时，传入的相机变换会自动调整到 XR 相机的位置。

注意：在呈现 XR 内容时无法更改参考空间类型。

## 源代码(Source)

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]