Javascript Funktionen

Javascript Funktionen erweitern die Möglichkeiten eines adaptor:ex games um die komplette Palette der Skript Programmiersprache Javascript. Einige Funktionen sind bereits in der adaptor:ex server Installation enthalten.

Du kannst auch eigene Funktionen erstellen und in dein Game einbinden. Sieh dir dazu das Kapitel functions im Abschnitt Development an, um zu erfahren, wie du deine eigenen Funktionen schreiben und hinzufügen kannst.

Funktionen ausführen

Du kannst Funktionen sowohl in der eigenständigen Function action, als auch in allen Formularfeldern die Variablen als Eingabe erlauben, einsetzen.

Die Function action

Mit der logic Function action kannst du Funktionen aufrufen, ihren return Wert nutzen und next states auslösen. Hier findest du mehr über die action heraus: Function

Funktionen als Variablen

Gib den Funktionsnamen, eingefasst in zwei eckige Klammern ([[ und ]]), mit einem vorangestellten functions in einer action Einstellung an, die Variablen als Eingabe erlaubt.

Der Funktionsname wird durch je eine geöffnete und geschlossene Klammer () ergänzt. Hier können auch Argumente, getrennt durch ein Komma (,) angegeben werden, um sie der Funktion zu übergeben.

Beispiel für eine Funktion als Variable:

[[functions.test("hallo","welt")]]

Innerhalb der Funktion werden "hallo" und "welt" als array übergeben:

function test(args, {session, game}) {
  session.log("1. " + args[0]) // 1. hallo
  session.log("2. " args[1]) // 2. welt
}

Der return Wert der Funktion wird an der Stelle Eingesetzt an der die Funktion eingesetzt ist.

Du findest alle Funktionen deines Games auch in der VARIABLES TOOLBAR und kannst sie von dort in die jeweilige action ziehen.

Suche nach "functions" und dragge und droppe die Funktion in das Action Form Field

Beispiel

Verwende die oben erstellte Function "playerCount" in einer Switch action.

Funktion als Variable in der switch action

Ist die Anzahl der Items in der player Collection größer als 10, geht es weiter im next state Party. Sonst geht es weiter mit NetflixAndChill

Eingebettete Funktionen

Die adaptor:ex Installation liefert einige Funktionen aus, die du direkt verwenden kannst.

Verwende sie wie in Funktionen ausführen beschrieben.

Diese Seite ist leider nicht in deutscher Übersetzung verfügbar. Melde dich bei uns, wenn du Fragen zu diesem Thema hast.

test

Return arguments the way they came in. Use it to find out how functions work.

Returns: array - the arguments that came in

Arguments - Can be anything

Example

[[functions.test("some value", 3)]]

will return the following array: ["some value", 3]

Assign the test function return value to a variable with Set variable and log the two array entries with Log Message.

Set action with test function Log action with test function return value

The Log will show: First Argument was some text. Second Argument was 3.

random

Get a random Integer value. Provide maximum only to get a number between 0 (inclusive) and max. Provide min and max argument to get a number between min (inclusive) and max (inclusive)

When used with Function Action, if you provide no arguments but one or more next states, random will randomly output to one of the next outlets with an even chance for each.

Returns: integer | next state - A random integer value or, if applicable, triggers one of the specified next states randomly.

Arguments

#	Type	Name	Description
0	`integer`	Min/Max	With two arguments this is the minimum value. With one argument only, this is the maximum value with a minimum of 0
1	`integer`	Max	Maximum value

Inline Example

[[functions.random(5, 10)]]

Outputs an integer number between 5 and 10.

Use it as timeout value in the Timeout Action and wait for an uncertain amount of time.

Timeout action with random timeout range between 5 and 10 seconds

Function Action Example

Add a Function Action to the stage and click on Settings. Deselect arguments and select the next option.

Use next in function action

Add two or more Next State entries.

Add Next states o random function

When run, the action will randomly select one of the given Next States and trigger it.

Live Editor View with Random function triggers

dateTimeOffset

Get the date that lies a certain amount of time past or future of some other date.

The original Date is in ISO Time Format. You can use "now" to set it to the current date and time.

The offset argument is formatted "HH:MM:SS" for example: "1:00" add 1 minute or "-23:30:00" subtract 23 and half an hour.

Returns: date string - A date that lies a certain amount of time before or after the original date.

Arguments

#	Type	Name	Description
0	`date string`	Original Date	The Date that is to be added or subtracted from
1	`time string`	Time Offset	The amount of time to add or subtract from the original date

Examples

[[functions.dateTimeOffset("2023-06-22T12:00","15:00")]]

Outputs the date value 2023-06-22T12:15 which is 15 minutes after 2023/06/22 12 o`clock.

[[functions.dateTimeOffset("2023-12-24T12:00","-48:30:00")]]

Outputs the date value 2023-12-22T11:30 which is 2 days and 30 minutes before 2023/06/22 12 o`clock.

[[functions.dateTimeOffset("now","30")]]

Outputs the date and time value 30 seconds from the current date and time.

dateTimeFormat

Convert an ISO Formatted Date and Time string into another kind of date and or time format string.

Uses the common javascript Intl.DateTimeFormat to convert date and time.

You can pass an open amount of any of the formatting options Intl.DateTimeFormat allows. Define options as a two part string separated by a whitespace. The parameter value comes first, the parameter name comes second, e.g. "short weekday". Each option is provided as separate argument.

Pass a locale indicator as last argument to set the date and or time locale. E.g. "de-DE" for german or "en-GB" for British english locale.

Returns: string - A formatted date and or time.

Arguments

#	Type	Name	Description
0	`date string`	Date	The ISO Date that is to be formatted. Use `"now"` to provide the current Date and Time.
1 - n	`string`	Options	Add one or more formatting options. Make sure the locale option is the last function argument.

Examples

[[functions.dateTimeFormat("2023-06-22","short date","en-US")]]

Becomes 06/22/23.

[[functions.dateTimeFormat("2023-06-22T17:35:12.345","weekday","hour","minute","1 secondDigits","de")]]

Becomes Donnerstag, 17:35:12,3.

[[functions.dateTimeFormat("now","long month","fr")]]

Will become the current month in french language, e.g. during March that would be mars.

atIndex

Get the value of an element in an array or string at a specific index position.

Returns: The value at given index

Arguments

#	Type	Name	Description
0	`array`	Array	The Array or String where to find element at index
1	`number`	Index	The index number

Examples

string
```
[[functions.atIndex("Thundercloud",3)]]
```
Returns the 4th character in Thundercloud and that would be n.
array

Create an array using the Set Variable action.

Set Variable

{
  "variable": "inventory",S
  "value": "[\"rope\",\"bottle\",\"pen\"]",
  "multiple": true
}

Set action with array value

Use the array as first argument in your atIndex function to get the respective element.

Log Message

{
  "level": "info",
  "message": "Second Item in your inventory is [[functions.atIndex(inventory,1)]]"
}

Log action with atIndex function

length

Get the number of elements inside an array or the number of characters in a string.

Returns number - The number of characters or elements

Arguments

#	Type	Name	Description
0	`array`	Array	The Array or String to get the length from

Examples

string
```
[[functions.length("Thundercloud")]]
```
Returns 12
array
```
[[functions.length(inventory)]]
```
Returns 3 given the inventory array defined in the atIndex example.