在此页

• 特性
• 方法
• 用法注意事项
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

安全上下文
此特征只可用于 安全上下文 (HTTPS)，在某些或所有 支持浏览器 .

WebXR Device API's XRInputSource interface describes a single source of control input which is part of the user's WebXR-compatible virtual or augmented reality system. The device is specific to the platform being used, but provides the direction in which it is being aimed and optionally may generate events if the user triggers performs actions using the device.

特性

gamepad 只读

A Gamepad object describing the state of the buttons and axes on the XR input source, if it is a gamepad or comparable device. If the device isn't a gamepad-like device, this property's value is NULL .

注意： While XRInputSource 使用 Gamepad interface from the 手柄 API , this input device is strictly associated with the WebXR hardware and is not a general-purpose gaming device.

gripSpace 只读

XRSpace whose origin tracks the pose which is used to render objects which should appear as if they're held in the hand indicated by handedness . The orientation of this space indicates the angle at which the hand is gripping the object. Read on in the main article on gripSpace for more details on how to use this space.

handedness 只读

DOMString that indicates which hand the device represented by this XRInputSource is being used in, if any. The value will be left , right ，或 none .

profiles 只读

An array of DOMString objects, each specifying the name of an input profile describing the preferred visual representation and behavior of this input source.

targetRayMode 只读

A DOMString indicating the methodology used to produce the target ray: gaze , tracked-pointer ，或 screen .

targetRaySpace 只读

XRSpace object defining the origin of the target ray and the direciton in which it extends. This space is established using the method defined by targetRayMode .

方法

XRInputSource interface defines no methods.

用法注意事项

Actions and the target ray

If the device provides an indication of the direction in which it is pointed, this is done using a target ray . This is a ray extending from the position of the device outward in the direction in which it is pointed.