ClientControls to accept callbacks for the initial user interaction

ProteanCoding · ProteanCoding · commit 750e9f14f851 · 2025-12-05T15:43:59.000+01:00
diff --git a/src/core/systems/ClientControls.js b/src/core/systems/ClientControls.js
@@ -68,6 +68,9 @@ export class ClientControls extends System {
       delta: 0,
     }
     this.xrSession = null
+
+    this.pointerLockOccurred = false
+    document.addEventListener('pointerlockchange', () => this.pointerLockOccurred = true, { once: true })
   }
 
   start() {
@@ -406,6 +409,15 @@ export class ClientControls extends System {
     }
   }
 
+  onInitialPointerLock(callback) {
+    if (this.pointerLockOccurred) {
+      callback.call()
+
+    } else {
+      document.addEventListener('pointerlockchange', callback, { once: true })
+    }
+  }
+
   onKeyDown = e => {
     if (e.defaultPrevented) return
     if (e.repeat) return

Original file line number	Diff line number	Diff line change
`@@ -68,6 +68,9 @@ export class ClientControls extends System {`
`68`	`68`	`delta: 0,`
`69`	`69`	`}`
`70`	`70`	`this.xrSession = null`
	`71`	`+`
	`72`	`+ this.pointerLockOccurred = false`
	`73`	`+ document.addEventListener('pointerlockchange', () => this.pointerLockOccurred = true, { once: true })`
`71`	`74`	`}`
`72`	`75`
`73`	`76`	`start() {`
`@@ -406,6 +409,15 @@ export class ClientControls extends System {`
`406`	`409`	`}`
`407`	`410`	`}`
`408`	`411`
	`412`	`+ onInitialPointerLock(callback) {`
	`413`	`+ if (this.pointerLockOccurred) {`
	`414`	`+ callback.call()`
	`415`	`+`
	`416`	`+ } else {`
	`417`	`+ document.addEventListener('pointerlockchange', callback, { once: true })`
	`418`	`+ }`
	`419`	`+ }`
	`420`	`+`
`409`	`421`	`onKeyDown = e => {`
`410`	`422`	`if (e.defaultPrevented) return`
`411`	`423`	`if (e.repeat) return`