API1:Ereignisse: Unterschied zwischen den Versionen

Aus AntMe! Wiki
Wechseln zu: Navigation, Suche
 
Zeile 7: Zeile 7:
 
! Ereignis ||  Kurzbeschreibung
 
! Ereignis ||  Kurzbeschreibung
 
|-
 
|-
| [[API1:Wartet|Wartet]] || Tritt ein, wenn die Ameise keine anderen Befehle hat.
+
| [[API1:Wartet|Wartet]] || Wenn die Ameise keinerlei Aufträge hat, wartet sie auf neue Aufgaben. Um dir das mitzuteilen, wird diese Methode hier aufgerufen.
 
|-
 
|-
| [[API1:WirdMüde|WirdMüde]] || Tritt ein, wenn die Ameise langsam müde wird.
+
| [[API1:WirdMüde|WirdMüde]] || Erreicht eine Ameise ein drittel ihrer Laufreichweite, wird diese Methode aufgerufen.
 
|-
 
|-
| [[API1:IstGestorben|IstGestorben]] || Dieses Ereignis tritt ein, wenn die Ameise gestorben ist.
+
| [[API1:IstGestorben|IstGestorben]] || Wenn eine Ameise stirbt, wird diese Methode aufgerufen. Man erfährt dadurch, wie die Ameise gestorben ist. Die Ameise kann zu diesem Zeitpunkt aber keinerlei Aktion mehr ausführen.
 
|-
 
|-
| [[API1:Tick|Tick]] || Tritt in jeder Simulationsrunde ein mal ein. Eignet sich für Aktionen, die nicht an Ereignisse gebunden sind.
+
| [[API1:Tick|Tick]] || Diese Methode wird in jeder Simulationsrunde aufgerufen - ungeachtet von zusätzlichen Bedingungen. Dies eignet sich für Aktionen, die unter Bedingungen ausgeführt werden sollen, die von den anderen Methoden nicht behandelt werden.
 
|}
 
|}
  
Zeile 22: Zeile 22:
 
! Ereignis ||  Kurzbeschreibung
 
! Ereignis ||  Kurzbeschreibung
 
|-
 
|-
| [[API1:Sieht(Obst)|Sieht(Obst)]] || Tritt ein, wenn eine Ameise einen Apfel sehen kann.
+
| [[API1:Sieht(Obst)|Sieht(Obst)]] || Sobald eine Ameise innerhalb ihres Sichtradius einen Apfel erspäht wird diese Methode aufgerufen. Als Parameter kommt das betroffene Stück Obst.
 
|-
 
|-
| [[API1:Sieht(Zucker)|Sieht(Zucker)]] || Tritt ein, wenn die Ameise Zucker sieht.
+
| [[API1:Sieht(Zucker)|Sieht(Zucker)]] || Sobald eine Ameise innerhalb ihres Sichtradius einen Zuckerhügel erspäht wird diese Methode aufgerufen. Als Parameter kommt der betroffene Zuckerghügel.
 
|-
 
|-
| [[API1:ZielErreicht(Obst)|ZielErreicht(Obst)]] || Wird aufgerufen, wenn die Ameise bei einem angesteuerten Apfel angekommen ist.
+
| [[API1:ZielErreicht(Obst)|ZielErreicht(Obst)]] || Hat die Ameise ein Stück Obst als Ziel festgelegt, wird diese Methode aufgerufen, sobald die Ameise ihr Ziel erreicht hat. Ab jetzt ist die Ameise nahe genug um mit dem Ziel zu interagieren.
 
|-
 
|-
| [[API1:ZielErreicht(Zucker)|ZielErreicht(Zucker)]] || Wird aufgerufen, wenn die Ameise einen angesteuerten Zuckerhügel erreicht hat.
+
| [[API1:ZielErreicht(Zucker)|ZielErreicht(Zucker)]] || Hat die Ameise eine Zuckerhügel als Ziel festgelegt, wird diese Methode aufgerufen, sobald die Ameise ihr Ziel erreicht hat. Ab jetzt ist die Ameise nahe genug um mit dem Ziel zu interagieren.
 
|}
 
|}
  
Zeile 37: Zeile 37:
 
! Ereignis ||  Kurzbeschreibung
 
! Ereignis ||  Kurzbeschreibung
 
|-
 
|-
| [[API1:RiechtFreund(Markierung)|RiechtFreund(Markierung)]] || Tritt ein, wenn eine Ameise die Duftmarke einer Ameise des eigenen Volkes wahrnimmt.
+
| [[API1:RiechtFreund(Markierung)|RiechtFreund(Markierung)]] || Markierungen, die von anderen Ameisen platziert werden, können von befreundeten Ameisen gewittert werden. Diese Methode wird aufgerufen, wenn eine Ameise zum ersten Mal eine befreundete Markierung riecht.
 
|-
 
|-
| [[API1:SiehtFreund(Ameise)|SiehtFreund(Ameise)]] || Die Ameise erspäht eine Ameise des eigenen Volkes.
+
| [[API1:SiehtFreund(Ameise)|SiehtFreund(Ameise)]] || So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Ameise aus dem eigenen Volk, so wird diese Methode aufgerufen.
 
|-
 
|-
| [[API1:SiehtVerbündeten(Ameise)|SiehtVerbündeten(Ameise)]] || Eine Ameise eines befreundeten Ameisenvolkes tritt in den Sichtbereich.
+
| [[API1:SiehtVerbündeten(Ameise)|SiehtVerbündeten(Ameise)]] || So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Ameise aus einem befreundeten Volk (Völker im selben Team), so wird diese Methode aufgerufen.
 
|}
 
|}
  
Zeile 50: Zeile 50:
 
! Ereignis ||  Kurzbeschreibung
 
! Ereignis ||  Kurzbeschreibung
 
|-
 
|-
| [[API1:SiehtFeind(Ameise)|SiehtFeind(Ameise)]] || Tritt ein, wenn die Ameise eine befeindete Ameise erspäht.
+
| [[API1:SiehtFeind(Ameise)|SiehtFeind(Ameise)]] || So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Ameise aus einem feindlichen Volk, so wird diese Methode aufgerufen.
 
|-
 
|-
| [[API1:SiehtFeind(Wanze)|SiehtFeind(Wanze)]] || Die Ameise sieht eine Wanze.
+
| [[API1:SiehtFeind(Wanze)|SiehtFeind(Wanze)]] || So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Wanze, so wird diese Methode aufgerufen.
 
|-
 
|-
| [[API1:WirdAngegriffen(Ameise)|WirdAngegriffen(Ameise)]] || Die Ameise wird von einer gegnerischen Ameise angegriffen.
+
| [[API1:WirdAngegriffen(Ameise)|WirdAngegriffen(Ameise)]] || Es kann vorkommen, dass feindliche Lebewesen eine Ameise aktiv angreifen. Sollte eine feindliche Ameise angreifen, wird diese Methode hier aufgerufen und die Ameise kann entscheiden, wie sie darauf reagieren möchte.
 
|-
 
|-
| [[API1:WirdAngegriffen(Wanze)|WirdAngegriffen(Wanze)]] || Die Ameise wird von einer Wanze angegriffen.
+
| [[API1:WirdAngegriffen(Wanze)|WirdAngegriffen(Wanze)]] || Es kann vorkommen, dass feindliche Lebewesen eine Ameise aktiv angreifen. Sollte eine Wanze angreifen, wird diese Methode hier aufgerufen und die Ameise kann entscheiden, wie sie darauf reagieren möchte.
 
|}
 
|}
  
Zeile 65: Zeile 65:
 
! Ereignis ||  Kurzbeschreibung
 
! Ereignis ||  Kurzbeschreibung
 
|-
 
|-
| [[API1:BestimmeKaste|BestimmeKaste]] || Es tritt ein, sobald eine neue Ameise geboren wird und erlaubt die Festlegung einer Kaste für die neu geborene Ameise.
+
| [[API1:BestimmeKaste|BestimmeKaste]] || Jedes mal, wenn eine neue Ameise geboren wird, muss ihre Berufsgruppe bestimmt werden. Das kannst du mit Hilfe dieses Rückgabewertes dieser Methode steuern.
 
|}
 
|}

Aktuelle Version vom 18. Mai 2015, 16:52 Uhr

Ereignisse stellen verschiedene Auslöser im Leben einer einzelnen Ameise dar. Sie erlauben es Code zu hinterlegen, mit dem auf diese Ereignisse reagiert werden kann. Ein Ereignis könnte zum Beispiel "Sieht Zucker" sein. Darauf könnte die Ameise dann mit dem Befehl "Gehe zu Zucker" reagieren.

Fortbewegung

Um die Ameise grundsätzlich in Bewegung zu setzen, braucht es Ereignisse, die ohne Zusammenhang zur Umgebung auftreten.

Ereignis Kurzbeschreibung
Wartet Wenn die Ameise keinerlei Aufträge hat, wartet sie auf neue Aufgaben. Um dir das mitzuteilen, wird diese Methode hier aufgerufen.
WirdMüde Erreicht eine Ameise ein drittel ihrer Laufreichweite, wird diese Methode aufgerufen.
IstGestorben Wenn eine Ameise stirbt, wird diese Methode aufgerufen. Man erfährt dadurch, wie die Ameise gestorben ist. Die Ameise kann zu diesem Zeitpunkt aber keinerlei Aktion mehr ausführen.
Tick Diese Methode wird in jeder Simulationsrunde aufgerufen - ungeachtet von zusätzlichen Bedingungen. Dies eignet sich für Aktionen, die unter Bedingungen ausgeführt werden sollen, die von den anderen Methoden nicht behandelt werden.

Nahrung

Ereignisse, die im Zusammenhang mit Nahrungsmitteln eintreffen. Einerseits beim Erspähen von Dingen, andererseits beim Erreichen dieser.

Ereignis Kurzbeschreibung
Sieht(Obst) Sobald eine Ameise innerhalb ihres Sichtradius einen Apfel erspäht wird diese Methode aufgerufen. Als Parameter kommt das betroffene Stück Obst.
Sieht(Zucker) Sobald eine Ameise innerhalb ihres Sichtradius einen Zuckerhügel erspäht wird diese Methode aufgerufen. Als Parameter kommt der betroffene Zuckerghügel.
ZielErreicht(Obst) Hat die Ameise ein Stück Obst als Ziel festgelegt, wird diese Methode aufgerufen, sobald die Ameise ihr Ziel erreicht hat. Ab jetzt ist die Ameise nahe genug um mit dem Ziel zu interagieren.
ZielErreicht(Zucker) Hat die Ameise eine Zuckerhügel als Ziel festgelegt, wird diese Methode aufgerufen, sobald die Ameise ihr Ziel erreicht hat. Ab jetzt ist die Ameise nahe genug um mit dem Ziel zu interagieren.

Kommunikation

Diese Ereignisse behandeln Situationen, die mit der Interaktion mit anderen Ameisen zu tun haben.

Ereignis Kurzbeschreibung
RiechtFreund(Markierung) Markierungen, die von anderen Ameisen platziert werden, können von befreundeten Ameisen gewittert werden. Diese Methode wird aufgerufen, wenn eine Ameise zum ersten Mal eine befreundete Markierung riecht.
SiehtFreund(Ameise) So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Ameise aus dem eigenen Volk, so wird diese Methode aufgerufen.
SiehtVerbündeten(Ameise) So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Ameise aus einem befreundeten Volk (Völker im selben Team), so wird diese Methode aufgerufen.

Kampf

Leider muss manchmal auch gekämpft werden. Diese Ereignisse treffen ein, wenn Feinde erspäht werden oder die Ameise in einen Kampf verwickelt wird.

Ereignis Kurzbeschreibung
SiehtFeind(Ameise) So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Ameise aus einem feindlichen Volk, so wird diese Methode aufgerufen.
SiehtFeind(Wanze) So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Wanze, so wird diese Methode aufgerufen.
WirdAngegriffen(Ameise) Es kann vorkommen, dass feindliche Lebewesen eine Ameise aktiv angreifen. Sollte eine feindliche Ameise angreifen, wird diese Methode hier aufgerufen und die Ameise kann entscheiden, wie sie darauf reagieren möchte.
WirdAngegriffen(Wanze) Es kann vorkommen, dass feindliche Lebewesen eine Ameise aktiv angreifen. Sollte eine Wanze angreifen, wird diese Methode hier aufgerufen und die Ameise kann entscheiden, wie sie darauf reagieren möchte.

Kasten

Der Bereich der Kasten betrifft Methoden, die zur Auswahl und Steuerung der Kasten dienen.

Ereignis Kurzbeschreibung
BestimmeKaste Jedes mal, wenn eine neue Ameise geboren wird, muss ihre Berufsgruppe bestimmt werden. Das kannst du mit Hilfe dieses Rückgabewertes dieser Methode steuern.