Eigene Instrumente

Jeder benutzerdefinierte Zähler verfügt über ein Skript. main() im Skript ist der Zeichnungseintrag und gibt einen Bildschirm zurück, der aus integrierten View besteht: Text zeigt Text an, Circle zeichnet Kreise, LineChart zeigt Kurven an und der Layout-Container ist für die Anordnung dieser Inhalte verantwortlich.

Das Skript kann die aktuelle Geschwindigkeit, Rotationsgeschwindigkeit (RPM) und andere Messwerte in main() abrufen, die anzuzeigende Zahl, Farbe oder den anzuzeigenden Winkel berechnen und das Ergebnis dann als Inhalt und Attribute von View zurückgeben. Nachdem Sie beispielsweise die Geschwindigkeit gelesen haben, können Sie den Wert entweder in Text schreiben oder ihn in den Bogenwinkel von Circle umrechnen.

CapDrive ruft main() erneut auf, wenn der Bildschirm aktualisiert und das zurückgegebene Ergebnis angezeigt werden muss. Der Instrumentencode muss nur den Bildschirm basierend auf dieser Eingabe beschreiben, und die Attributanimation wird auch vom Zeichnungsende ausgeführt. Bildressourcen können mit dem Instrument gespeichert und über den Ressourcennamen im Code verwendet werden.

Instrumente werden über .instrument-Dateien importiert und geteilt. Vorhandene Dateien können über Instrument importieren im benutzerdefinierten Instrumentenmenü geöffnet werden, oder Dateien können mit CapDrive geöffnet werden. Die importierten Werke müssen separat zum Dashboard hinzugefügt werden.

Die importierten Instrumente werden in Mehr（…）→ Eigene Instrumente gespeichert. Wählen Sie es über Mehr（…）→ Dashboard bearbeiten → + aus und klicken Sie auf Fertig, um es im Dashboard anzuzeigen.

Werke, die Fahrzeugparameter verwenden, müssen auch ihre eigenen Fahrzeugparameter in Instrumenteneinstellungen → Eingabezuordnungen für die vorhandene OBD-Eingabe auswählen. Wenn Sie die Eingabekennung unverändert lassen, können Sie den Code des Werks erben, ohne die Gerätekennung in das Skript schreiben zu müssen.

Wählen Sie Neues Instrument hinzufügen in Mehr（…）→ Eigene Instrumente aus, um den Editor aufzurufen. Der Bearbeitungsbereich wird zum Schreiben von main() und View verwendet; Klicken Sie oben auf den Namen, um den Instrumentennamen, die Eingabezuordnungen und andere Optionen festzulegen. Das Zahnrad öffnet Parameterkonfiguration, das sechs Arten von Eingaben verwalten kann: numerischer Wert, Text, Schalter, Auswahlelement, Basisdaten und OBD-Daten. Der neue Zähler verfügt bereits über einen Basisgeschwindigkeitseingang mit der Kennung speed.

Sie können während der Bearbeitung jederzeit eine Vorschau von Text, Layout, Grafiken und Animationen anzeigen. Die Vorschau bietet einen analogen Eingang zur einfachen Überprüfung des Instruments im geparkten Zustand. Wenn ein Codefehler auftritt, kann dieser anhand der Zeilennummer im Protokoll lokalisiert werden. Fügen Sie das Messgerät nach dem Speichern zum Dashboard hinzu, um die tatsächlichen Messwerte zu verwenden.

„First Speed ​​​​Gauge“ bietet vollständigen Code und eine Beschreibung; Die API-Referenz listet die verfügbaren View, Eigenschaften, Typen und Laufzeitschnittstellen auf.

$data stellt dem Skript den aktuellen Messwert und aktuelle Beispiele zur Verfügung. Grundfelder wie Geschwindigkeit und Distanz können direkt zur numerischen Anzeige verwendet werden; Parameter wie Fahrzeuggeschwindigkeit (U/min) und Kühlmitteltemperatur werden über das konfigurierte OBD-Gerät bereitgestellt. Das Skript kann auch Kurven anhand historischer Stichproben generieren.

Bei jeder Ausführung von main() werden die erforderlichen Felder gelesen, die Werte verarbeitet und View generiert. Messwerte sind möglicherweise vorübergehend nicht verfügbar, daher sollte der Anzeigecode geeignete Inhalte für fehlende Messwerte bereitstellen. Gerätedatendokumente beschreiben zentral die Feldstruktur, OBD-Referenzen, historische Stichproben und die Handhabung von Nullwerten.