XR8.XrController.hitTest()

XrController.hitTest(X, Y, includedTypes = [])

Beschreibung

Schätzen Sie die 3D-Position eines Punktes auf dem Kamerabild. X und Y werden als Zahlen zwischen 0 und 1 angegeben, wobei (0, 0) die obere linke Ecke und (1, 1) die untere rechte Ecke des Kamerabildes ist, wie es in der Kamera gerendert wird, die durch XR8.XrController.updateCameraProjectionMatrix() angegeben wurde. Je nach Datenquelle, die zur Schätzung der Position verwendet wird, können mehrere 3D-Positionsschätzungen für einen einzigen Treffertest zurückgegeben werden. Die Datenquelle, die zur Schätzung der Position verwendet wurde, wird durch den "hitTest.type" angegeben.

Parameter

Parameter	Typ	Beschreibung
X	Nummer	Wert zwischen 0 und 1, der die horizontale Position auf dem Kamerabild von links nach rechts angibt.
Y	Nummer	Wert zwischen 0 und 1, der die vertikale Position auf dem Kamerabild von oben nach unten angibt.
includedTypes	[String]	Liste, die 'FEATURE_POINT' enthalten sollte.

Rückgabe

Eine Reihe von geschätzten 3D-Positionen aus dem Treffertest:

[{ Typ, Position, Drehung, Abstand }]

Parameter	Typ	Beschreibung
Typ	String	Eines von 'FEATURE_POINT', 'ESTIMATED_SURFACE', 'DETECTED_SURFACE' oder 'UNSPECIFIED'.
Position	{x, y, z}	Die geschätzte 3D-Position des abgefragten Punktes auf dem Kamerabild.
Rotation	³{x, y, z, w}`	Die geschätzte 3D-Drehung des abgefragten Punktes auf dem Kamerabild.
Entfernung	Nummer	Die geschätzte Entfernung des abgefragten Punktes auf dem Kamerabild vom Gerät.

Beispiel

const hitTestHandler = (e) => {
  const x = e.touches[0].clientX / window.innerWidth
  const y = e.touches[0].clientY / window.innerHeight
  const hitTestResults = XR8.XrController.hitTest(x, y, ['FEATURE_POINT'])
}