Wird geladen...

Die Service Runtime und das Runtime SDK für Haply-Geräte. Praktisch in einem Installer gebündelt. Auch bekannt als der „externe“ Service.
3.5.8 ist ein Patch-Release mit Schwerpunkt auf Hot-Plug und Wiederverbindung sowie auf Mount-Presets. Die öffentliche C-API ist gegenüber 3.5.7 unverändert, und keine Route wurde entfernt. Alle Änderungen, die einen Client mit Standardeinstellungen erreichen, beheben Fehler, die in 3.5.7 ausgeliefert wurden, und bieten zusätzlich klarere Diagnosen. Die neuen Funktionen dieses Zyklus befinden sich hinter den opt-in Stage-Schaltern des SDKs, die weiterhin standardmäßig deaktiviert ausgeliefert werden, und sind für einen Client mit Standardeinstellungen nicht sichtbar.
Anders als 3.5.7 ändert dieses Release jedoch, was ein Client mit Standardeinstellungen beobachtet, und zwar an acht Stellen. Fünf davon sind breit angelegt: Ein Gerät wird aus einer Session ausgeblendet, bis diese Session es registriert hat, state.current_cursor_position wird in den Anwendungsbereich verschoben, das Kraft-Gate wird pro Session geführt, Mount-Schreibvorgänge erfordern eine Einheitenrotation, und die zentrierten Presets greifen auf die aktuelle Rotation des Geräts zu und können custom oder defaults melden. Drei davon sind enger gefasst: Auf einem Minverse setzen arm_front und defaults den Session-Mount zurück und die Werte state.body_orientation ändern sich, und device-connection-loop kann für einen Receiver ausgelöst werden, der kein Gerät benennt. Jede dieser Änderungen ist unter Mögliche Breaking Changes aufgeführt, mit Angabe, wer sie bemerkt und wie Sie migrieren.
Ein internes Begleit-Changelog für Ingenieure (__CODE_code-1__) enthält die Details zur stage-gesteuerten API, die internen Mechanismen hinter diesen Fehlerbehebungen, Verweise auf Design-Dokumente und Issue-Referenzen.
device-safety-triggered wird erneut zugestellt. In 3.5.7 gingen sie erst mit einem Neustart des Dienstes wieder verloren.device-connection-loop, und ein erneutes Einstecken stellt den Griff sofort wieder her.state.body_orientation und die Mount-Referenz des Geräts nicht mehr um eine Vierteldrehung um Y rotiert: Das Gerät liefert in seiner Kalibrierungspose wieder die Identität.state.current_cursor_position wird nun im Anwendungsbereich der Session gemeldet, wie cursor_position daneben, sodass eine befohlene Position in den Koordinaten zurückkommt, in denen sie gesendet wurde.device not found, alle 10 s eine Erinnerung mit der Anzahl verworfener Befehle und eine Zeile device found again – statt einer Zeile pro Befehl (16 939 Zeilen in 2,5 s am Prüfstand).POST /ports/{port}/reset bricht außerdem den Backoff eines stummen Receivers ab, sodass der nächste Versuch zum erneuten Öffnen sofort erfolgt.Hot-Plug und Wiederverbindung
GET /devices?session=).Unable to serialize-Zeilen in etwa einer Sekunde am Prüfstand, 11 in 3 ms bei einem Empfänger-Wiederanstecken).Montage und Presets
configure.mount akzeptierte eine Skalierung von null oder NaN, wodurch jedes Kraft- und Positionsziel zu inf/NaN wurde, während HTTP gültige Skalierungen außerhalb von [1, 5.5] ablehnte. Beide Transporte wenden nun dieselbe Regel an: jede endliche Skalierung, die auf keiner Achse nahe null liegt.DELETE config/mount ließ config.preset auf das alte Preset verweisen, sodass dessen erneute Anwendung die gelöschte Montage wiederherstellte. Auf einem Minverse ließen arm_front / defaults die aktuelle Montage bestehen, statt sie zurückzusetzen.state.body_orientation und seine gespeicherte Montagereferenz um eine Vierteldrehung um Y falsch (eine linkshändige Einheit meldete ihre Identitätsreferenz als +90-Grad-Drehung um Y).Gerätekonfiguration
config.gravity_compensation (v3.0 und v3.1) und GET /{device_type}/{id}/config/gravity_compensation innerhalb einer seriellen Round-Trip-Zeit. Jede Sitzung, die das Gerät hält, erhält bei ihrer nächsten Nachricht eine vollständige Antwort. In 3.5.7 wurde die Änderungsmeldung des Geräts ignoriert, und der alte Wert blieb bis zur Wiederverbindung bestehen. Ältere Firmware sendet die Meldung nicht, daher ändert sich dort nichts.Übertragungswerte
cursor_position, cursor_velocity und current_cursor_force im selben Objekt im Anwendungsbereich lagen. Bei einer nicht identischen Basis kam das Echo permutiert zurück (XZ-Y: gesendet (x, 0.090, 0.197), zurückgesendet (x, -0.197, 0.090)). Es wird nun mit der Sitzungsbasis und Montage in v3.1-Vollframes und Streaming-Frames umgerechnet. Seit 3.5.0 vorhanden.34), während session.session_id im selben Frame die echte ID enthielt. Sie ist nun die vollständige 32-Bit-ID, entsprechend dem dokumentierten uint32-Schema. Seit 3.5.0 vorhanden.GET /devices?session=). In 3.5.7 erschien es während des Hot-Plug-Fensters nackt. Die JSON-Struktur bleibt unverändert, und die Standardausgabe behält custom_verse_grip: [], wenn alle benutzerdefinierten Griffe weggelassen werden. Wer es bemerkt: Clients, die Geräte über ihre Array-Position über Frames hinweg indexieren, ein Gerät, das in einem Frame fehlt, als abgezogen behandeln oder die nackten Werte des ersten Frames auslesen. Migration: Geräte über device_id schlüsseln; den ersten Frame, der ein Gerät enthält, als dessen Ankunft werten; Abziehen über den Events-Kanal erkennen, nicht über die Zugehörigkeit im Array.cursor_position und dem kommandierten Ziel.GET/POST/DELETE /{device_type}/{id}/config/filters/force_gate und config.filters.force_gate.gain melden den eigenen Wert der Sitzung (Standard 0.3), nicht die aktuelle Verstärkung des Geräts. Wer es bemerkt: Ein Client, der den Grenzwert aus einer beobachtenden oder konfigurierenden Sitzung gesetzt hat oder ihn zurücklesen und dabei den Live-Wert des Geräts erwartet. Migration: Den Kraftgrenzwert aus der antreibenden Sitzung setzen; den wirksamen Wert über die antreibende Sitzung auslesen.POST|PATCH config/mount antwortet mit 400 invalid mount transform (non-finite, non-unit rotation or ~zero scale axis) bei einem Quaternion, dessen quadrierte Norm um mehr als 1e-3 abweicht. WebSocket configure.mount protokolliert eine Warnung und behält die vorherige Halterung bei. Eine Skalierung außerhalb von [1, 5.5], die 3.5.7 abgelehnt hat, wird nun akzeptiert. Wer es bemerkt: Ein Client, der nicht normalisierte Quaternionen gesendet hat oder sich darauf verlassen hat, dass der Dienst die Skalierung begrenzt. Migration: Quaternionen vor dem Senden normalisieren; gewünschte Skalierungsbereiche in der Client-Oberfläche durchsetzen.arm_front_centered / led_front_centered bestimmen ihre Position bei der Anwendung anhand der aktuellen Geräterotation. config.preset liefert custom (mit einem session-updated für config.preset), sobald sich das Gerät seit der Anwendung um mehr als 1 Grad gedreht hat – auch nach einem Neuanstecken oder einer Neukalibrierung des Inkwells, ohne Schreibvorgang des Clients. Nach einem DELETE config/mount auf Sitzungsebene liefert es defaults. Wer es bemerkt: Ein Client, dessen Verhalten vom Namen config.preset abhängt. Migration: Die Voreinstellung erneut anwenden, um nach dem Bewegen des Geräts neu zu zentrieren; custom als „die Voreinstellung beschreibt die Pose nicht mehr“ interpretieren.arm_front_centered verschiebt sich von x = -0.13 auf x = -0.12 (an der Hardware manuell abgestimmt). Wer es bemerkt: Minverse-Nutzer, die sich darauf verlassen haben, dass diese Voreinstellungen eine benutzerdefinierte Halterung beibehalten, oder die gegen die alte Mitte kalibriert haben. Migration: Minverse-Kalibrierungen, die gegen die alte Mitte erstellt wurden, erneut prüfen.device_id die zuletzt als bereit gesehene ID am Port und leer, falls es nie eine gab. attempts zählt die fehlgeschlagenen Versuche in diesem Vorfall, und window_ms ist die Zeit seit dem ersten Fehlschlag. Die Payload-Struktur bleibt unverändert. Wer es bemerkt: Ein Client, der annahm, dass device_id nie leer ist. Migration: Ein leeres device_id behandeln.Alle verfügbaren Downloads für dieses Release: