diff --git a/docs/api/en/renderers/webxr/WebXRManager.html b/docs/api/en/renderers/webxr/WebXRManager.html index fd965930bc70031a05f220a1501bacb50cbb3220..f9cbdb25c5fae38b0a36c823c67dde3f339a5438 100644 --- a/docs/api/en/renderers/webxr/WebXRManager.html +++ b/docs/api/en/renderers/webxr/WebXRManager.html @@ -68,6 +68,19 @@ Note: It is not possible to change the framebuffer scale factor while presenting XR content.

+

[method:void setReferenceSpaceType]( [param:String referenceSpaceType] )

+

+ [page:String referenceSpaceType] — The reference space type to set.

+ + Can be used to configure a spatial relationship with the user's physical environment. Depending on how the user moves in 3D space, setting an + appropriate reference space can improve tracking. Default is *local-floor*. + Please check out the [link:https://developer.mozilla.org/en-US/docs/Web/API/XRReferenceSpaceType MDN] for possible values and their use cases. +

+ +

+ Note: It is not possible to change the reference space type while presenting XR content. +

+

Source

diff --git a/docs/api/zh/renderers/webxr/WebXRManager.html b/docs/api/zh/renderers/webxr/WebXRManager.html index fd965930bc70031a05f220a1501bacb50cbb3220..f9cbdb25c5fae38b0a36c823c67dde3f339a5438 100644 --- a/docs/api/zh/renderers/webxr/WebXRManager.html +++ b/docs/api/zh/renderers/webxr/WebXRManager.html @@ -68,6 +68,19 @@ Note: It is not possible to change the framebuffer scale factor while presenting XR content.

+

[method:void setReferenceSpaceType]( [param:String referenceSpaceType] )

+

+ [page:String referenceSpaceType] — The reference space type to set.

+ + Can be used to configure a spatial relationship with the user's physical environment. Depending on how the user moves in 3D space, setting an + appropriate reference space can improve tracking. Default is *local-floor*. + Please check out the [link:https://developer.mozilla.org/en-US/docs/Web/API/XRReferenceSpaceType MDN] for possible values and their use cases. +

+ +

+ Note: It is not possible to change the reference space type while presenting XR content. +

+

Source

diff --git a/examples/jsm/webxr/VRButton.d.ts b/examples/jsm/webxr/VRButton.d.ts index af62ccabc12a196f75ed95d805a4a749c04ce94f..6ded0e85279c4dbddacded44df479d3a4e8cc33d 100644 --- a/examples/jsm/webxr/VRButton.d.ts +++ b/examples/jsm/webxr/VRButton.d.ts @@ -2,10 +2,6 @@ import { WebGLRenderer } from '../../../src/Three'; -export interface WebXROptions { - referenceSpaceType: string; -} - export namespace VRButton { - export function createButton( renderer: WebGLRenderer, options?: WebXROptions ): HTMLElement; + export function createButton( renderer: WebGLRenderer ): HTMLElement; } diff --git a/examples/jsm/webxr/VRButton.js b/examples/jsm/webxr/VRButton.js index 76cb6932bfc68616c9e7f58617465fe9dc708bc7..8675d30c7354964a5985676a8758134a0054de69 100644 --- a/examples/jsm/webxr/VRButton.js +++ b/examples/jsm/webxr/VRButton.js @@ -7,9 +7,9 @@ var VRButton = { createButton: function ( renderer, options ) { - if ( options && options.referenceSpaceType ) { + if ( options ) { - renderer.xr.setReferenceSpaceType( options.referenceSpaceType ); + console.error( 'THREE.VRButton: The "options" parameter has been removed. Please set the reference space type via renderer.xr.setReferenceSpaceType() instead.' ); } diff --git a/examples/webxr_vr_panorama.html b/examples/webxr_vr_panorama.html index e3384facbdff5d8b69d9948dccc175ac5ce90766..04dc714cbccb1c285f123e5ddbab4edf1d3bf30e 100644 --- a/examples/webxr_vr_panorama.html +++ b/examples/webxr_vr_panorama.html @@ -27,9 +27,10 @@ renderer.setPixelRatio( window.devicePixelRatio ); renderer.setSize( window.innerWidth, window.innerHeight ); renderer.xr.enabled = true; + renderer.xr.setReferenceSpaceType( 'local' ); document.body.appendChild( renderer.domElement ); - document.body.appendChild( VRButton.createButton( renderer, { referenceSpaceType: 'local' } ) ); + document.body.appendChild( VRButton.createButton( renderer ) ); // diff --git a/examples/webxr_vr_panorama_depth.html b/examples/webxr_vr_panorama_depth.html index 4c5871f36881bbfac6f35d32abd79fdb2384ea77..4f7114c00ce3d6c650e3b8deb8275a8076dd2c3e 100644 --- a/examples/webxr_vr_panorama_depth.html +++ b/examples/webxr_vr_panorama_depth.html @@ -84,9 +84,10 @@ renderer.setPixelRatio( window.devicePixelRatio ); renderer.setSize( window.innerWidth, window.innerHeight ); renderer.xr.enabled = true; + renderer.xr.setReferenceSpaceType( 'local' ); container.appendChild( renderer.domElement ); - document.body.appendChild( VRButton.createButton( renderer, { referenceSpaceType: 'local' } ) ); + document.body.appendChild( VRButton.createButton( renderer ) ); // diff --git a/examples/webxr_vr_rollercoaster.html b/examples/webxr_vr_rollercoaster.html index e2bce7e7166ecb6a076c6e04e5ce3554b00d8c1c..36aeb32b5af56418259b0ea37af5346c691e84f1 100644 --- a/examples/webxr_vr_rollercoaster.html +++ b/examples/webxr_vr_rollercoaster.html @@ -27,9 +27,10 @@ renderer.setPixelRatio( window.devicePixelRatio ); renderer.setSize( window.innerWidth, window.innerHeight ); renderer.xr.enabled = true; + renderer.xr.setReferenceSpaceType( 'local' ); document.body.appendChild( renderer.domElement ); - document.body.appendChild( VRButton.createButton( renderer, { referenceSpaceType: 'local' } ) ); + document.body.appendChild( VRButton.createButton( renderer ) ); // diff --git a/examples/webxr_vr_video.html b/examples/webxr_vr_video.html index 6f7ff3516e3b7dac54622348e533ddea51eedbb6..87a672a748358e917e979c60302af6e3846546cb 100644 --- a/examples/webxr_vr_video.html +++ b/examples/webxr_vr_video.html @@ -115,9 +115,10 @@ renderer.setPixelRatio( window.devicePixelRatio ); renderer.setSize( window.innerWidth, window.innerHeight ); renderer.xr.enabled = true; + renderer.xr.setReferenceSpaceType( 'local' ); container.appendChild( renderer.domElement ); - document.body.appendChild( VRButton.createButton( renderer, { referenceSpaceType: 'local' } ) ); + document.body.appendChild( VRButton.createButton( renderer ) ); //