Basenersetzung

Die Basis dient zur Abbildung zwischen dem internen Koordinatensystem von Haply und dem Koordinatensystem Ihrer Anwendung.

Haply Standardkoordinatensystem

Haply Verwendung desrechtshändigenKoordinatensystems:

Achse	Richtung
+X	rechts
+Y	vorher
+Z	Nach oben

Funktionsweise

Die Platzhalterzeichenfolgen teilen dem Dienst mit, wie die Koordinatenachsen Ihrer Anwendung auf die Koordinatenachsen vonHaply abgebildet werden. Nach der Konfigurationgibt der Dienst alle Werte(Position, Geschwindigkeit, Kraft, Ausrichtung) in Ihrem Bezugssystemzurück, undalle von Ihnen gesendeten Werte werden entsprechend Ihrem Bezugssystem interpretiert. Die Umrechnung erfolgt automatisch und in beide Richtungen.

Diese Zeichenfolge lautet X、Y、Z Ersetzung, wahlweise durch + oder - Wird als Präfix verwendet, um die Richtung einer Achse umzukehren.

Beispiel

Ersetzen	Bedeutung	Typische Anwendungsbereiche
XYZ	Identische Transformation – keine Neuzuordnung	Haply Native App
XZY	Tausche Y und Z aus → Dein +Y zeigt nach oben	Motor mit nach oben gerichteter Y-Achse
X-YZ	Y-Achse invertieren → linkshändiges Koordinatensystem, Z-Achse nach oben	Unreal Engine
ZXY	Zyklische Verschiebung um drei Achsen	Benutzerdefiniertes Koordinatensystem

Erläuterung

"YZX" Anzeige:

• Deine X-Achse = Y(vorne) von Haply
• Deine Y-Achse = Z-Achsevon Haply (oben)
• Deine Z-Achse = X-Achsevon Haply (rechts)

Grundierung auftragen

WebSocket

{
  "session": {
    "configure": {
      "basis": { "permutation": "XZY" }
    }
  }
}

HTTP

curl -X POST "http://localhost:10001/inverse3/0/config/basis?session=:0" \
     -H "Content-Type: application/json" \
     -d '{"permutation": "XZY"}'

Die Grundeinstellung istdauerhaft– sie wird einmal in der ersten Nachricht festgelegt und bleibt so lange gültig, bis sie geändert wird oder die Sitzung endet.

von session.set_basis Migration

Konventionen für Achsenbezeichnungen in älteren Versionen session.set_basis und session.configure.basis Es haben sich Änderungen ergeben. Eine unter dem alten Befehl gültige Substitution kann unter dem neuen Befehl zu einer umgekehrten Transformation führen. Kehren Sie gegebenenfalls die Achsenvorzeichen um (zum Beispiel:X-ZY werden zu XZ-Y). Weitere Informationen finden Sie unter 3.5 Leitfaden zur Migration。