v6.4.0

XR - v6.4.0

which includes the packages react-three/xr, pmndrs/xr, pmndrs/pointer.events

Breaking Changes

• forwardHtmlEvents and forwardObjectEvents now return an object { destroy(): void, update(): void } instead of a destroy function () => void. Using these 2 functions now requires calling update on every frame for each forward call, which improves intersection performance in non-XR environments under heavy load.

Deprecation

• useControllerLocomotion is deprecated since it was renamed to properly fit the other hooks to useXRControllerLocomotion. Please switch to useXRControllerLocomotion.

Features

• instead of writing your own hook for using the pmndrs/xr event system you can now use the provided component PointerEvents and use the exported noEvents to disable the R3F events in non-XR environments. <Canvas events={nonEvents}><PointerEvents/></Canvas>

v6.3.0

react-three/xr v6.3.0

Breaking Changes

• by default hands and controllers are now placed at the inputSource.targetRaySpace to align with the WebXR standard. Use <XRSpace space="grib-space" /> for the controller or <XRSpace space="wrist" /> for hands to place your objects according the the previous defaults.

Features

• emulate options (e.g. control the initial controller position)
• more values allowed in (e.g. you can use <XRSpace space="grib-space"> inside of custom input sources)
• interaction speed optimizations and preparation for react-three/handle
• Bug fixes

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