v6.2.0

react-three/xr v6.2.0

🎥 YouTube Video | 🪿 Tweet

Features

• ⛰️ Unbounded spaces using bounded: false - Example
• 📐 Depth sensing using depthSensing: true - Example
• ➕ Secondary input sources using secondaryInputSources: true - Example | Tutorial
• 📺 Dynamic and static high quality layers using <XRLayer ... /> - Example | Tutorial

Fixes

• #322: incorrect XRRigidTransform when using frame.createAnchor
• #331: Window is not defined error when using @react-three/xr with Next.js
• #324: Wheel scrolling not working when using forwardObjectEvents

Breaking Changes

• useSessionSupported is now called useSessionModeSupported
• useXRHandState("right"), useXRHandState("controller"), ... is now called useXRInputSource("hand", "right"), useXRInputSource("controller", "right"), ...
• useXRHandState("right"), useXRControllerState("right"), ... for getting the hand state when rendering a hand is now called useXRInputSourceStateContext("hand"), useXRInputSourceStateContext("controller"), ...
• removed unnecessary useXRPlane hook

Documentation

• Layers example
• Layers tutorial
• Secondary input sources example
• Secondary input sources tutorial
• Minecraft example improvements thanks to @shpowley
• Depth sensing stage example
• Unbounded space watch example

v6.1.0

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.

v6.0.0

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. 🙏🏼

v5.7.1

What's Changed

• fix(XRButton): apply fallback for render props by @CodyJasonBennett in #297

Full Changelog: v5.7.0...v5.7.1

v5.7.0

What's Changed

• feat(Controller): environment map by @saitonakamura in #282

Full Changelog: v5.6.2...v5.7.0

v5.6.2

What's Changed

• refactor(controllers): Refactored how Controllers interact w/ three by @saitonakamura in #294

Full Changelog: v5.6.1...v5.6.2

v5.6.1

What's Changed

• fix(hand tracking): fix event order when using hands and hide hands i… by @Ledzz in #283

Full Changelog: v5.6.0...v5.6.1

v5.6.0

What's Changed

• feat: add teleportation support by @richardanaya in #263

New Contributors

• @Soham1803 made their first contribution in #277
• @richardanaya made their first contribution in #263

Full Changelog: v5.5.0...v5.6.0

v5.5.0

What's Changed

• docs: fixed some ts issues in the examples by @saitonakamura in #253
• feat: add optional envmap intensity by @Ledzz in #269

New Contributors

• @Ledzz made their first contribution in #269

Full Changelog: v5.4.1...v5.5.0

v5.4.1

What's Changed

• fix: switch to type=module for Webpack <5 by @CodyJasonBennett in #266

Full Changelog: v5.4.0...v5.4.1