草案
此页面不完整。
安全上下文
此特征只可用于
安全上下文
(HTTPS)，在某些或所有
支持浏览器
.
requestReferenceSpace()
方法在
XRSession
interface returns a
promise
that resolves with an instance of either
XRReferenceSpace
or
XRBoundedReferenceSpace
as appropriate given the type of reference space requested.
refSpacePromise = xrSession.requestReferenceSpace(referenceSpaceType);
type
DOMString
specifying the type of reference space for which an instance is to be returned. The string must be one of those found in the
XRReferenceSpaceType
enumerated type.
The reference space returned by
XRSession.requestReferenceSpace()
是
XRReferenceSpace
or
XRBoundedReferenceSpace
. The "Interface" column in the table below indicates which of the two types is returned for each reference space type constant..
The types of reference space are listed in the table below, with brief information about their use cases and which interface is used to implement them.
| XRReferenceSpaceType | 描述 | 接口 |
|---|---|---|
bounded-floor
|
类似于
local
type, except the user is not expected to move outside a predetermined boundary, given by the
boundsGeometry
in the returned object.
|
XRBoundedReferenceSpace
|
local
|
A tracking space whose native origin is located near the viewer's position at the time the session was created. The exact position depends on the underlying platform and implementation. The user isn't expected to move much if at all beyond their starting position, and tracking is optimized for this use case.
For devices with six degrees of freedom (6DoF) tracking, the
|
XRReferenceSpace
|
local-floor
|
类似于
local
type, except the starting position is placed in a safe location for the viewer to stand, where the value of the y axis is 0 at floor level. If that floor level isn't known, the
用户代理
will estimate the floor level. If the estimated floor level is non-zero, the browser is expected to round it such a way as to avoid fingerprinting (likely to the nearest centimeter).
|
XRReferenceSpace
|
unbounded
|
A tracking space which allows the user total freedom of movement, possibly over extremely long distances from their origin point. The viewer isn't tracked at all; tracking is optimized for stability around the user's current position, so the native origin may drift as needed to accommodate that need. |
XRReferenceSpace
|
viewer
|
A tracking space whose native origin tracks the viewer's position and orientation. This is used for environments in which the user can physically move around, and is supported by all instances of
XRSession
, both immersive and inline, though it's most useful for inline sessions. It's particularly useful when determining the distance between the viewer and an input, or when working with offset spaces. Otherwise, typically, one of the other reference space types will be used more often.
|
XRReferenceSpace
|
A
Promise
that resolves with an
XRReferenceSpace
对象。
Rather than throwing true exceptions,
requestReferenceSpace()
rejects the returned promise with a
DOMException
whose name is found in the list below:
NotSupportedError
The requested reference space is not supported.
| 规范 | 状态 | 注释 |
|---|---|---|
|
WebXR 设备 API
The definition of 'requestReferenceSpace()' in that specification. |
工作草案 | 初始定义。 |
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
requestReferenceSpace()
|
Chrome 79 | Edge 79 | Firefox No | IE No | Opera No | Safari No | WebView Android No | Chrome Android 79 | Firefox Android No | Opera Android No | Safari iOS No | Samsung Internet Android 11.2 |
完整支持
不支持
XRSession
cancelAnimationFrame()
end()
requestAnimationFrame()
requestReferenceSpace()
updateRenderState()