*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

LuauExecutionSessionTask

Ein A LuauExecutionSessionTask ("Aufgabe" für kurze Zeit) führt ein bestimmtes Luau-Skript im Kontext einer bestimmten Version eines Ortes aus.

In einer Aufgabe wird keine Physiksimulation ausführen. Server- und lokale Skripte innerhalb des Ortes ausführenauch nicht automatisch.

Das Skript kann auf das Datenmodell des Ortes zugreifen und es aktualisieren, einschließlich der Ausführung von Modulskripten.Datenmodelländerungen sind jedoch lokal auf die Aufgabe beschränkt und können nicht persistent gemacht werden.

Das Skript kann auch Engine-APIs aufrufen, die Daten lesen und/oder modifizieren, die in der Cloud gespeichert sind, wie z. B. die für Datenspeicher.Üben Sie Vorsicht, wenn Sie diese APIs verwenden.

Skripte können bis zu 4 MB groß sein und bis zu 5 Minuten laufen. Skripte, die länger als die Zeit限制 laufen, enden mit einem Fehler.

Skripte werden unverändert ausgeführt und müssen nicht in einer Funktion verpackt werden.

Skripte können Werte zurückgeben (mit dem Luau-return-Schlüsselwort).Rückgabewerte werden in JSON serisiert und können mit der Get LuauExecutionSessionTask API abgerufen werden, nachdem die Aufgabe abgeschlossen ist.Die Gesamtgröße der Rückgabewerte nach JSON-Serzialisierung darf nicht 4 MB überschreiten.Wenn das Limit überschritten wird, endet die Aufgabe mit einem Fehler.

Wenn das Skript einen nicht behandelten Fehler erzeugt, endet die Aufgabe. Die Fehlerinformationen können mit der GetLuauExecutionSessionTask abgerufen werden.

Standardausgabe (generiert von der Luau-print-Funktion) kann mit der Methode ListLuauExecutionSessionTaskLogs nach Beendigung der Aufgabe abgerufen werden.Es werden maximal 450 KB Logs gespeichert.Wenn die Menge an Protokollen das Limit überschreitet, werden ältere Protokolle verworfen.

Informationen zu einer Aufgabe werden für 24 Stunden nach Abschluss der Aufgabe gespeichert.

Es sind höchstens zehn unvollständige Aufgaben pro Ort erlaubt. Wenn du versuchst, mehr Aufgaben zu erstellen, während die ersten zehn unvollständig sind, ergibt sich eine HTTP-Antwort 429.

  • RESSOURCEN-PFADE
  • /cloud/v2/universes/{universe_id}/places/{place_id}/luau-execution-session-tasks
  • /cloud/v2/universes/{universe_id}/places/{place_id}/versions/{version_id}/luau-execution-session-tasks
  • /cloud/v2/universes/{universe_id}/places/{place_id}/versions/{version_id}/luau-execution-sessions/{luau_execution_session_id}/tasks

Attribute

pathstring

Der Ressourcenpfad der luau-Ausführungs session Aufgabe.

Formen:

  • universes/{universe_id}/places/{place_id}/luau-execution-session-tasks/{luau_execution_session_task_id}
  • universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-session-tasks/{luau_execution_session_task_id}
  • universes/{universe_id}/places/{place_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}
  • universes/{universe_id}/places/{place_id}/versions/{place_version_id}/luau-execution-sessions/{luau_execution_session_id}/tasks/{luau_execution_session_task_id}.
createTimestring
Nur Ausgabe

Zeit, in der diese Aufgabe erstellt wurde. Dieser String ist als Zeitstempel formatiert.

updateTimestring
Nur Ausgabe

Zeit, zu der der Zustand dieser Aufgabe zum letzten Mal geändert wurde. Dieser String ist als Zeitstempel formatiert.

userstring
Nur Ausgabe

Der Benutzer, der den API-Schlüssel erstellt hat, der verwendet wurde, um diese Aufgabe zu erstellen.

stateEnum<string>
Nur Ausgabe

Der Zustand der Aufgabe. Siehe die Zustands enum für Informationen über jeden möglichen Wert.

Mögliche Werte:

| Wert | Beschreibung | | --- | --- | | STATE_UNSPECIFIED | UNSPEZIFIZIERT | | QUEUED | Die Aufgabe wartet darauf, verarbeitet zu werden.| | VERARBEITUNG | Die Aufgabe wurde zum Bearbeiten abgeholt.| | ABGEBROCHEN | Die Aufgabe wurde vom Benutzer gestoppt.| | ABGESCHLOSSEN | Die Aufgabe ist fertig verarbeitet.Das Ausgabefeld enthält die Ausgabe.| | FEHLGESCHLAGEN | Die Aufgabe ist fehlgeschlagen.Das Fehlerfeld enthält Details zum Fehler. |. Mögliche Werte:

scriptstring
Unveränderlich

Das Skript, das als Teil dieser Aufgabe ausgeführt werden soll.

Zum Beispiel:

local x = 3

local y = 4

return x + y

```.
timeoutstring
Unveränderlich

Limit für die Dauer, für die das Skript ausführenwerden kann.

Die Aufgabe scheitert, wenn das Skript nicht innerhalb der angegebenen Dauer abgeschlossen wird.

Standard sind 5 Minuten.

Eins der folgenden für result:

errorobject

Präsentiert, wenn die Aufgabenausführung fehlschlägt. Enthält Details über den Fehler, der zur Fehlfunktion geführt hat.

outputobject

Präsent, wenn die Aufgabenausführung erfolgreich ist. Enthält die Ausgabe der Ausführung.

Basis-URL
https://apis.roblox.com
Die LuauExecutionSessionTask-Ressource
{

  "path": "universes/123/places/123/luau-execution-session-tasks/123e4567-e89b-12d3-a456-426655440000",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "user": "string",

  "state": "STATE_UNSPECIFIED",

  "script": "string",

  "timeout": "3s",

  "error": {

    "code": "ERROR_CODE_UNSPECIFIED",

    "message": "string"

  }

}

LuauExecutionSessionTask

Create Luau Execution Session Task
Beta

POST /cloud/v2/universes/{universe_id}/places/{place_id}/luau-execution-session-tasks

Erstellt eine Aufgabe, wartet aber nicht, bis die Aufgabe abgeschlossen ist.

Um zu überprüfen, ob eine Aufgabe abgeschlossen ist, rufen Sie die GetLuauExecutionSessionTask-Methode auf und inspizieren Sie das Feld state der zurückgegebenen Ressource.

Zuweisungen:

  • 5 Anrufe pro Minute für jeden Eigentümer
  • 45 Anrufe pro Minute pro IP-Adresse
Bereiche
universe.place.luau-execution-session:write
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

place_idstring
Erforderlich

Die Platz-ID.

Text anfordernLuauExecutionSessionTask
RückmeldungLuauExecutionSessionTask
POST /cloud/v2/universes/{universe_id}/places/{place_id}/luau-execution-session-tasks
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/places/{place_id}/luau-execution-session-tasks' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "script": "string",

  "timeout": "3s"

}'
Rückmeldung
{

  "path": "universes/123/places/123/luau-execution-session-tasks/123e4567-e89b-12d3-a456-426655440000",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "user": "string",

  "state": "STATE_UNSPECIFIED",

  "script": "string",

  "timeout": "3s",

  "error": {

    "code": "ERROR_CODE_UNSPECIFIED",

    "message": "string"

  }

}