Skip to content

Commit

Permalink
first draft for XRInputSource.alreadyVisible
Browse files Browse the repository at this point in the history
  • Loading branch information
AdaRoseCannon committed Oct 31, 2023
1 parent 9a0cb83 commit fcf4899
Showing 1 changed file with 2 additions and 0 deletions.
2 changes: 2 additions & 0 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -1859,6 +1859,8 @@ The <dfn attribute for="XRInputSource">profiles</dfn> attribute is a [=/list=] o

An <dfn for="XRInputSource">input profile name</dfn> is an ASCII lowercase {{DOMString}} containing no spaces, with separate words concatenated with a hyphen (`-`) character. A descriptive name should be chosen, using the prefered verbiage of the device vendor when possible. If the platform provides an appropriate identifier, such as a USB vendor and product ID, it MAY be used. Values that uniquely identify a single device, such as serial numbers, MUST NOT be used. The [=input profile name=] MUST NOT contain an indication of device handedness. If multiple user agents expose the same device, they SHOULD make an effort to report the same [=input profile name=]. The <a href="https://github.com/immersive-web/webxr-input-profiles/tree/master/packages/registry">WebXR Input Profiles Registry</a> is the recommended location for managing [=input profile name=]s.

The <dfn attribute for="XRInputSource">alreadyVisible</dfn> attribute indicates that this input is visible and does not need to be rednered by the Website. Examples include the input source being between the user and the display or the input being shown by the operating system.

Profiles are given in descending order of specificity. Any [=input profile name=]s given after the first entry in the list should provide fallback values that represent alternative representations of the device. This may include a more generic or prior version of the device, a more widely recognized device that is sufficiently similar, or a broad description of the device type (such as "generic-trigger-touchpad"). If multiple profiles are given, the layouts they describe must all represent a superset or subset of every other profile in the list.

If the {{XRSession}}'s [=mode=] is {{XRSessionMode/"inline"}}, {{XRInputSource/profiles}} MUST be an empty list.
Expand Down

0 comments on commit fcf4899

Please sign in to comment.