Beschreibung#

Wird ausgelöst, wenn das ausgewählte Objekt ein Signal erhält. Der Sender bestimmt die drei Parameter.

Ereignisdaten#

Feld Typ / Bedeutung Bedeutung
event.object MD-Objekt Signalobjekt.
event.param unknown Benutzerdefinierter Wert, oft Identifizierung der Signalart.
event.param2 unknown Benutzerdefinierter Parameter 2.
event.param3 unknown Benutzerdefinierter Parameter 3.

MD-Bezeichnungen beschreiben MD-Werte und semantische Objektrollen, keine Lua-Typen. unknown bedeutet, dass die Quelle die genaue Darstellung nicht festlegt; es verspricht kein nil. Nicht aufgeführte Ereignisfelder werden nicht vorausgesetzt.

Abonnement-Beispiel#

Fügen Sie dieses unabhängige Fragment in den entsprechenden Cues-Knoten Ihres MD-Skripts ein. Benennen Sie WikiWatch bei Verwendung mehrerer Beispiele um. Der Player muss ein gültiges Primärschiff haben, wenn der Hörer aktiviert ist; die Lebensdauer des Hörers beim Ändern des beobachteten Objekts verwalten.

XML
<cue name="WikiWatch" instantiate="true" namespace="this">
  <conditions>
    <event_object_signalled object="player.primaryship" />
  </conditions>
  <actions>
    <set_value name="$Object" exact="event.object" />
    <set_value name="$Signal" exact="event.param" />
    <set_value name="$Param2" exact="event.param2" />
    <set_value name="$Param3" exact="event.param3" />
    <debug_text text="'Wiki: event_object_signalled received'" />
  </actions>
</cue>

Was geschieht#

Jedes passende Ereignis erstellt eine Handler-Instanz und kopiert die dokumentierten Felder in ihre lokalen Variablen. Bei aktivierter Skriptdiagnose wird folgende Meldung erwartet:

TEXT
Wiki: event_object_signalled received

Dies ist die erwartete Ausgabe eines unabhängigen Lernbeispiels und kein abgeschlossener Spieltest. Abonnements beobachten Ereignisse, ohne die eigentliche Spielaktion auszulösen. Vermeide bei häufigen Ereignissen eine Protokollmeldung pro Ereignis.

XML-Abonnementfilter#

Diese Attribute filtern Ereignisse; sie sind nicht die oben genannten Ereignisdatenfelder. Schematypen.

libraries/common.xsd

Attribut Schematyp Erforderlich Standard / festgelegt
chance expression Nein nicht deklariert
comment comment Nein nicht deklariert
object expression Nein nicht deklariert
group groupeventsource Nein nicht deklariert
check checkeventsource Nein nicht deklariert
param expression Nein nicht deklariert
param2 expression Nein nicht deklariert
param3 expression Nein nicht deklariert

Rückgabewert#

Dies ist eine MD-Ereignisbedingung, kein Funktionsaufruf mit einem Lua-Tupel als Rückgabe. Lies event.object/event.param im zugehörigen MD-Aktionskontext.

Vertragsgrundlage#

Die Feldzuordnung wurde mit den Anmerkungen in common.xsd / md.xsd der installierten X4 9.00 (611726) abgeglichen. Veröffentlicht werden eigene Erklärungen und unabhängige Beispiele. Gültiges XML allein beweist keinen Effekt im Spiel.

Typen und Methoden · MD-cues · Fehlersuche