Telemetrie und Plugin

Datenweg

ETS2/ATS
  -> SCS Telemetry SDK
  -> TruckSimLogBook.Plugin.dll
  -> TruckSimLogBook.SharedMemory
  -> WinUI-App
  -> SQLite-Datenbank

Das native C++-Plugin registriert Telemetriekanäle und Gameplay-Ereignisse. Es schreibt einen binären Snapshot in eine benannte Shared-Memory-Struktur. Die App liest diesen Snapshot in festen Intervallen.

Erfasste Bereiche

• Spiel- und Pausenzustand
• Auftrag, Route und Firmen
• Fracht und Gewicht
• Zugmaschine und Trailer
• Geschwindigkeit, Drehzahl, Gang und Tempomat
• Treibstoff, AdBlue, Verbrauch und Reichweite
• Kilometerstand und tatsächliche Fahrstrecke
• Fahrzeug-, Trailer- und Frachtschaden
• Einnahmen und Gameplay-Kosten

Shared Memory

Standardname:

TruckSimLogBook.SharedMemory

Plugin und App müssen exakt denselben Namen und dieselbe Datenstruktur verwenden. Eine Strukturänderung erfordert normalerweise einen gemeinsamen Build beider Komponenten.

Auftragserkennung

Die App eröffnet eine aktive Tour, wenn ein valider Auftrag erkannt wird. Bei Auftragswechsel, erfolgreicher Abgabe oder Abbruch wird der Status anhand der SDK-Ereignisse und stabiler Zustandsübergänge festgelegt. Schutzlogik verhindert das erneute Anlegen bereits abgeschlossener Fahrten.

Unterstützte Telemetry-API

Das Plugin akzeptiert SCS Telemetry API 1.01 und 1.00. Der Build verwendet die im Projekt eingebundene SCS-SDK-Version 1.14.

Grenzen

• Mod-Karten können unbekannte Länder- oder Fahrzeugcodes liefern.
• Manche Gameplay-Ereignisse unterscheiden sich zwischen Spielversionen.
• Daten, die das SDK nicht liefert, können nicht zuverlässig rekonstruiert werden.
• Bei Savegame-Reloads prüft die App Zustände konservativ, um Dubletten zu vermeiden.