Scripting: Einführung

  • Tutorial

Training

Scripting ist der Baustein, der es ermöglicht, die Anpassung Beholder Geschäftsbedürfnisse ohne Deploye die Anwendung erneut. Die Drehbücher, geschrieben in JavaScript, sind Auf der Serverseite gespeichert, Versioniert dann Angetrieben von den Spielern (Beholder) für die lokale Hinrichtung. Sie können sich verändern Anwendungsverhalten anpassen, die Schnittstelle anpassen, das Erscheinungsbild des digitalen Zwillings steuern und Prozesse orchestrieren. Das Ergebnis: schnell eine funktionale Antwort zu entwickeln, autonom, mit einer zugänglichen Sprache.

Erschaffung digitaler Zwillingsreise

Ein immersiver digitaler Zwilling besteht aus vier sich ergänzenden Schritten: Geospatiale Modellierung, Erstellung des Ausrüstungskatalogs, Geometrie und Datenverbindung dann Skriptbildung um Geschäftslogik hinzuzufügen. Das Ziel ist es, von einem korrekt georeferenzierten 3D-Referenzsystem zu einer Anwendung zu gelangen das in Echtzeit auf Daten reagiert, ohne dass der Spieler neu eingesetzt werden muss.

4 Schritte: letzter Teil des Skripts

Die folgenden Abschnitte beschreiben jeden Schritt, die erwarteten Ergebnisse und Aufmerksamkeitspunkte die einen robusten, nachverfolgbaren und wartbaren Twin gewährleisten.

1) Geographische Modellierung & Metadaten

Baue die 3D-Karte und das räumliche Rahmen, in dem der Zwilling lebt: Standorte, Gebäude, Etagen, Bereiche, Orientierungspunkte und Koordinaten. Je reichhaltiger die Modellierung (Geometrie + Semantik), desto mehr Weitere Anwendungen (Ort, Navigation, Filterung, Analyse) werden einfach und genau sein.

  • Tut: Erstellen und Zusammenstellen von 2D/3D-Modellen, Definition der Topologie (Standort → Gebäude → Etage → Fläche), Ausfüllen von Koordinatensystemen.
  • Liefermaterial: kohärentes räumliches Archiv, bereit zur Empfangsausrüstung.

2) Herstellung/Import von Ausrüstung

Liste alle beaufsichtigbaren Objekte (Sensoren, Systeme, Kameras, Fahrzeuge usw.) von Die Geschäftsquellen des Kunden (CMMS, GIS, IoT, Excel-Exporte, APIs usw.). Normalisieren, reinigen und Transformiere diese Daten in ein immersives Format, sodass sie zu umsetzbaren Entitäten werden.

  • Tut: Kartiere Felder (Typen, Kennungen, Eigenschaften, Variablen, Zustände), kontrolliere die Qualität, bereichere sie bei Bedarf an.
  • Liefermaterial: Bereit zum Laden Immersiv-Equipment-Katalog (Typen + Instanzen + Variablen).

3) Verknüpfung von Geräteobjekten ↔

Verknüpfe visuelle Objekte (3D-Meshes, 2D-Symbole) aus der Modellierung mit Geräten Referenziert. Dieser Schritt erzeugt das Rückverfolgbarkeit : Ein Klick auf ein Objekt öffnet das richtige Formular, eine Änderung von Wert aktualisiert die korrekte Darstellung, und Cross-Abfragen (nach Zone, Typ, Kritikalität) werden trivial.

  • Tut: Stabile Verbindungen (IDs, Mitgliedschaftsregeln, Muster) herstellen und räumliche Ausrichtung validieren.
  • Liefermaterial: robuster Verknüpfungsgraph zwischen Geometrie und Daten, testbar im Beholder.

4) Skripting & Geschäftslogik

Lokale Intelligenz über JavaScript-Skripte hinzufügen, die vom Beholder ausgeführt werden: Alarmregeln, Bedingte Stile/Animationen, Operatorpfade, Widgets und Automatisierungen. Skripting erlaubt Verhaltensänderung ohne Umverteilung : Veröffentliche die Skripte einfach auf der Serverseite.

  • Tut: Skripte nach Umfang schreiben, Handles anhören, UI/Zwillingsreaktionen anwenden, protokollieren.
  • Liefermaterial: Versionierte, dokumentierte und getestete Skriptbibliothek.

Rolle und Zweck des Skripts

  • Reagieren auf Daten über den Hub empfangen (Status, Metriken, Ereignisse) und lösen lokale Aktionen aus.
  • Anpassung der Benutzeroberfläche : Wege vereinfachen, Unterstützungselemente hinzufügen, Prioritäten anzeigen.
  • Styling des Zwillings : Das Aussehen der Ausrüstung ändern, Abzeichen/Tags anzeigen, visuelle Effekte anwenden.
  • Prozesse automatisieren : Aktionssequenzen, Modusverwaltung (Tag/Nacht), Alarmregeln, Bedienerverfahren.

Alle in den Skript-Tutorials beschriebenen Operationen werden in der Backend-Immersivität, Kategorie "Business > Content". Hier strukturierst du deinen Umfang der Ausführung (Arbeitsbereiche), Erstellen Sie Ihre Skripte (Controller), verwalten Sie Versionen und veröffentlichen Sie.

Grundlagen

  • Handle : Datenpfad, der einen Dialog mit dem Hub ermöglicht. Skripte "hören" auf Wertveränderungen und reagieren.
  • Arbeitsbereich —Repräsentiert eine Menge von Controllern, die während einer Beholder-Sitzung angewendet werden. Zum Start ist nur ein Arbeitsbereich aktiv. Der Arbeitsbereich repräsentiert den Geschäftsarbeitsbereich, der das Standardverhalten des Betrachters überschreibt, um eine Geschäftsantwort zu erstellen, die an die Bedürfnisse eines Kunden angepasst ist.
  • Controller : Ein Container für ein Skript (oder parametrischen Inhalt) mit seinem Typ, Importregel und Versionen.
    • Parametrisierungsregler (Präfix Infos.) — Format JSON. Steuern Sie die Konfiguration beim Start (z. B. Standardkarte, Umfang, Titel, Hub-Adresse).
    • Geräteskript-Controller (ohne Präfix) — Format JavaScript. Logik ist an ein oder mehrere Geräte gebunden.
    • Anwendungsskript-Controller (Präfix App.) — Format JavaScript. Gesamtlogik, unabhängig von der Ausrüstung.
    • Standortkontrolleure (Präfix Translation.) — Format Text. Übersetzungsschlüssel wurden hinzugefügt.
  • Importregel —Bestimmt, auf welche Geräte ein Geräteskript angewendet wird. Beispiele:
    • Nachname —Zielt auf alle Ausrüstungen einer Familie. Zum Beispiel alle Aufzüge.
    • Mehrere Familien : wobei jede Familie getrennt wird durch |.
    • Alle Ausrüstungen : Muster .*.
    • Vorhandensein einer Variablen : Muster $(NomDeVariable) (Gilt nur für Geräte mit dieser Variablen).

Backend-Lebenszyklus

Die typischen Aufgaben eines immersiven Nutzers, der Skripte erstellen möchte, um den Betrachter an ein geschäftliches Bedürfnis anzupassen, sind die folgenden:

  1. Erstellen Sie einen Arbeitsbereich und definieren ihre Eigenschaften (Zugriffsrechte, Liste der verknüpften Controller).
  2. Erstellen Sie einen Controller : Geben Sie einen Namen an (achten Sie auf das Präfix, das den Typ bestimmt), die Beschreibung und gegebenenfalls die Importregel.
  3. Drehbuch bearbeiten (oder JSON, je nach Controllertyp) und Erstellen Sie eine Version.
  4. Eine Version veröffentlichen : Nur die veröffentlichte Version ist Vom Betrachter aufgeladen.. Ein Controller kann zwar seine Skripte versionieren, aber nur eines auf einmal veröffentlichen.
  5. Verknüpfe den Controller mit dem Arbeitsbereich : Nur Controller, die mit dem aktiven Arbeitsbereich verknüpft sind, werden ausgeführt. Ein Controller kann mit mehreren verschiedenen Arbeitsbereichen verknüpft werden.
  6. Spielerseitige Ladung : Beim Start (oder je nach Neuladestrategie) ruft der Beholder den Arbeitsbereich, seine zugehörigen Controller und die veröffentlichte Version für jeden von ihnen ab, die er lokal ausführt.

Gute redaktionelle Praktiken

Es ist wichtig, die Wartung Ihres Projekts zu vereinfachen und denen, die an den von Ihnen erstellten Arbeitsbereichen, Controllern oder Skripten arbeiten, zu helfen, Best Practices einzuhalten:

  • Eindeutige Benennung : Selbsterklärende Namen für Controller, Arbeitsbereiche und Familien.
  • Präzise Importregeln : Ziel klar (Familien, Variablen), um Nebenwirkungen zu vermeiden.
  • Kurze und häufige Versionen : Veröffentlichen Sie in Schritten und Dokumentenänderungen.
  • Isolierung : Trennung der "globalen" Logik (App.) der "Geräte"-Logik (ohne Präfix).
  • Reversibilität : Jede UI- oder visuelle Änderung sollte einfach rückgängig gemacht werden können.
  • Leistung : bevorzugen ereignisbasierte Reaktionen und einen begrenzten Umfang (gezielte Handles).

Häufige Verwendungen

Scripting ermöglicht es Ihnen, die Bedienung des Beholders zu überlasten, um Ihren Nutzern mehr Möglichkeiten und Funktionen zu bieten. Scripting wird in der Lage sein, Folgendes zu beeinflussen:

  • Vermögensstatus : Markiere ein Gerät, das sich in Anomalie befindet, zeigt eine Operator-Nachricht an.
  • 2D/3D-UI-Anpassung : Bereichern Sie die Karte (Patronen, Blasen), Ausrüstungslisten, Kritikalitätsabzeichen.
  • Abfrage & Filterung : Fokussiere den Blick auf eine relevante Teilmenge der Ausrüstung.
  • Geolokalisierung & Flotte : Markiere die nächstgelegene Ressource, führe zu einem Punkt, bediene "virtuelle" Geräte.
  • Geschichte & Heatmap —Aktiviere historische oder Dichteschichten für die Analyse.

Nächste Schritte im Tutorial

  • Erstellung eines Arbeitsbereich.
  • Erstellung eines Controller und die Verwaltung seiner Versionen.
  • Parametrisierungsregler (Infos.).
  • Geräteskripting (Importregeln, Zielerfassung, Anwendungsfälle).
  • Anwendungsskripting (App.).
  • Lage (Translation.).
  • Thematischer Fokus: Vermögensstatus, Widget2D/3D-Anpassung, Abfrage, 3D-Anpassung,

Geolokalisierung, Weitere Aktionen, Inspektor, HMI-Anpassung, Flotte/GeoTracking/GeoMove/NavMeshMove, Berichte, Heatmap, Streckengeschichte.

Entwickler

  • Lernzentrum
  • Launcher
  • Immersive Script
  • Immersive Forge
  • SDK Immersive