react-three/xr v6.1.0

Features

• Anchor Support: Added anchor functionality to attach 3D object positioning onto the real world
• Emulator: Integrated emulator via IWER (runs on localhost or everywhere else when pressing windows/command + alt/option + E
• Hit Testing: Now supporting a simple API for Hit Testing
• DOM Overlay: Integrated DOM overlay, enabling HTML content to be layered over the XR scene.

Fixes

• Pointer Event Order: Corrected the inheritance of pointerEventsOrder to ensure events propagate as expected.
• Object Events Forwarding: Fixed issues with inverted object event forwarding, ensuring correct interaction handling.
• Origin Scale & MinDistance: Resolved inaccuracies with origin scaling and minimum distance calculations.
• XR Screen Input: Addressed issues related to XR screen input, improving interaction consistency.
• Teleport Pointer: Disabled teleport pointer by default, preventing unintended navigation in scenes.
• VR Sessions: Fixed a bug related to VR sessions in unbounded environments, ensuring proper session management.

Documentation

• New Tutorials: Adde tutorials on handling anchors, DOM overlays, performing hit tests, and configuring and using the xr store.
• Examples Update: Expanded example documentation for handheld AR, hit testing, and anchor usage.
• Pitfalls & FAQ: Updated the pitfalls and frequently asked questions sections to address common issues and improve developer support.

Introducing @react-three/xr v6.0.0

... a complete rewrite of react-three/xr that aligns this library closer to the react-three ecosystem.

Features

• support for the react-three/fiber event handlers
• reduced boilerplate
• more defaults
• more access to the lower-level WebXR primitives

Migration

We've created a compatibility layer between earlier versions and provide a migration guide.

Feedback

Receiving feedback for improving the developer experience in the AR and VR space is crucial for building good libraries.
Please provide us feedback regarding the new API, the documentation, and everything else viaTwitter or Discord. 🙏🏼

What's Changed

• fix(XRButton): apply fallback for render props by @CodyJasonBennett in https://github.com/pmndrs/react-xr/pull/297

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.7.0...v5.7.1

What's Changed

• feat(Controller): environment map by @saitonakamura in https://github.com/pmndrs/react-xr/pull/282

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.6.2...v5.7.0

What's Changed

• refactor(controllers): Refactored how Controllers interact w/ three by @saitonakamura in https://github.com/pmndrs/react-xr/pull/294

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.6.1...v5.6.2

What's Changed

• fix(hand tracking): fix event order when using hands and hide hands i… by @Ledzz in https://github.com/pmndrs/react-xr/pull/283

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.6.0...v5.6.1

What's Changed

• feat: add teleportation support by @richardanaya in https://github.com/pmndrs/react-xr/pull/263

New Contributors

• @Soham1803 made their first contribution in https://github.com/pmndrs/react-xr/pull/277
• @richardanaya made their first contribution in https://github.com/pmndrs/react-xr/pull/263

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.5.0...v5.6.0

What's Changed

• docs: fixed some ts issues in the examples by @saitonakamura in https://github.com/pmndrs/react-xr/pull/253
• feat: add optional envmap intensity by @Ledzz in https://github.com/pmndrs/react-xr/pull/269

New Contributors

• @Ledzz made their first contribution in https://github.com/pmndrs/react-xr/pull/269

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.4.1...v5.5.0

What's Changed

• fix: switch to type=module for Webpack <5 by @CodyJasonBennett in https://github.com/pmndrs/react-xr/pull/266

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.4.0...v5.4.1

What's Changed

• feat: expose XRControllerModelFactory by @saitonakamura in https://github.com/pmndrs/react-xr/pull/256

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.3.0...v5.4.0

What's Changed

• feat: configurable session framerate by @CodyJasonBennett in https://github.com/pmndrs/react-xr/pull/234
• feat: better label for unsupported states by @saitonakamura in https://github.com/pmndrs/react-xr/pull/244
• chore: support corepack by @saitonakamura in https://github.com/pmndrs/react-xr/pull/240
• chore: set up Codesandbox CI by @saitonakamura in https://github.com/pmndrs/react-xr/pull/241
• chore: started with unit testing by @saitonakamura in https://github.com/pmndrs/react-xr/pull/243
• chore: new examples structure by @saitonakamura in https://github.com/pmndrs/react-xr/pull/246

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.2.0...v5.3.0

What's Changed

• feat: expose utilities for headless button creation by @saitonakamura in https://github.com/pmndrs/react-xr/pull/238
• feat: add modelconnected, modeldisconnected, motionconnected, and motiondisconnected events to XRControllerModelFactory by @saitonakamura in https://github.com/pmndrs/react-xr/pull/239

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.1.4...v5.2.0

What's Changed

• fix: vendor and fix XRControllerModelFactory by @saitonakamura in https://github.com/pmndrs/react-xr/pull/239

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.1.3...v5.1.4

What's Changed

• fix: set foveation on session reset by @saitonakamura in https://github.com/pmndrs/react-xr/pull/235

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.1.2...v5.1.3

What's Changed

• fix: hand mesh not visible after tracking lost/restored by @bodo22 in https://github.com/pmndrs/react-xr/pull/227

New Contributors

• @bodo22 made their first contribution in https://github.com/pmndrs/react-xr/pull/227

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.1.1...v5.1.2

What's Changed

• fix(XRButton): don't overwrite styles by @CodyJasonBennett in https://github.com/pmndrs/react-xr/pull/221

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.1.0...v5.1.1

What's Changed

• chore(docs): tiny addition to doc change in #199 by @rekliner in https://github.com/pmndrs/react-xr/pull/210
• chore: set up SSL for development environment by @donmccurdy in https://github.com/pmndrs/react-xr/pull/212
• feat(XRButton): add onError prop for XR init by @firtoz in https://github.com/pmndrs/react-xr/pull/216

New Contributors

• @donmccurdy made their first contribution in https://github.com/pmndrs/react-xr/pull/212
• @firtoz made their first contribution in https://github.com/pmndrs/react-xr/pull/216

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.0.5...v5.1.0

What's Changed

• docs: update default reference space by @timhc22 in https://github.com/pmndrs/react-xr/pull/199
• docs: prefer Matrix4#decompose in hit test example by @wayfarerboy in https://github.com/pmndrs/react-xr/pull/202
• fix: remove race condition around session events, init by @rekliner in https://github.com/pmndrs/react-xr/pull/208

New Contributors

• @timhc22 made their first contribution in https://github.com/pmndrs/react-xr/pull/199
• @wayfarerboy made their first contribution in https://github.com/pmndrs/react-xr/pull/202
• @rekliner made their first contribution in https://github.com/pmndrs/react-xr/pull/208

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.0.4...v5.0.5

What's Changed

• fix: add provided reference space type to optionalFeatures by @saitonakamura in https://github.com/pmndrs/react-xr/pull/193

Full Changelog: https://github.com/pmndrs/react-xr/compare/v3.6.7...v5.0.4

What's Changed

• fix(XR): eagerly call sessionstart when late by @CodyJasonBennett in https://github.com/pmndrs/react-xr/pull/191

Full Changelog: https://github.com/pmndrs/react-xr/compare/v5.0.2...v5.0.3