*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

LuauExecutionSessionTask

Un LuauExecutionSessionTask ("task" per breve) esegue uno script Luau dato nel contesto di una versione specifica di un Posto.

In un compito, la simulazione fisica non viene Eseguire. Anche gli script del server e locali all'interno del luogo non vengono Eseguireautomaticamente.

Lo script può accedere e aggiornare il modello di dati del Posto, incluso l'invocazione di qualsiasi script del modulo.Tuttavia, i cambiamenti del modello di dati sono locali alla task e non possono essere persistiti.

Lo script può anche invocare le API del motore che leggono e/o modificano i dati memorizzati nel cloud, come quelle per i DataStore.Esercitare cautela quando si utilizzano queste API.

Gli script possono essere fino a 4 MB di dimensione e funzionare fino a 5 minuti. Gli script che funzionano più a lungo del limite di tempo terminano con un errore.

Gli script vengono eseguiti così com'è e non hanno bisogno di essere avvolti in una funzione.

Gli script possono restituire valori (utilizzando la parola chiave Luau return).I valori di restituzione vengono serializzati in JSON e possono essere recuperati con l'API Get LuauExecutionSessionTask dopo che la task è completata.La dimensione totale dei valori di restituzione dopo la serializzazione JSON non deve superare 4 MB.Se il limite viene superato, il compito termina con un errore.

Se lo script solleva un errore non gestito, la task termina. Le informazioni sull'errore possono essere recuperate con l'API GetLuauExecutionSessionTask.

L'output standard (generato dalla funzione Luau print ) può essere recuperato con il metodo ListLuauExecutionSessionTaskLogs dopo che la task è completata.Un massimo di 450 KB di log viene conservato.Se la quantità di log supera il limite, i log più vecchi vengono scartati.

Le informazioni su un compito vengono mantenute per 24 ore dopo la conclusione del compito.

Al massimo dieci compiti incompiuti sono consentiti per Posto. Tentare di creare più compiti mentre i primi dieci sono risultati incompiuti in una risposta HTTP 429.

  • PERCORSI RISORSE
  • /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

Attributi

pathstring

Il percorso delle risorse della sessione di esecuzione luau.

Formati:

  • 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
Solo output

Tempo in cui è stata creata questa attività. Questa stringa è formattata come Timestamp.

updateTimestring
Solo output

Tempo in cui lo stato di questa attività è stato cambiato per l'ultima volta. Questa stringa è formattata come Timestamp.

userstring
Solo output

L'utente che ha creato la chiave API che è stata utilizzata per creare questo compito.

stateEnum<string>
Solo output

Lo stato della task. Vedi l'Enumero di Stato per informazioni su ogni possibile valore.

Valori possibili:

| Valore | Descrizione | | --- | --- | | STATO_NON SPECIFICATO | NON SPECIFICATO | | QUEUED | La task è in attesa di essere elaborata.| | PROCESSAMENTO | La task è stata presa in carico per il processamento.| | CANCELLATO | La task è stata interrotta dall'utente.| | COMPLETO | La task è stata completata.Il campo di uscita contiene l'Output.| | FALLITO | La task è fallita.Il campo errore contiene dettagli sull'errore. |. Valori possibili:

scriptstring
Immutabile

Lo script da eseguire come parte di questo compito.

Ad esempio:


local x = 3
local y = 4
return x + y
```.
timeoutstring
Immutabile

Limite per quanto tempo lo script può essere Eseguire.

Il compito fallisce se lo script non si completa entro la durata specificata.

Predefinito a 5 minuti.

Uno dei seguenti per result:

errorobject

Presente quando l'esecuzione del compito fallisce. Contiene dettagli sull'errore che ha causato il fallimento.

outputobject

Presente quando l'esecuzione del compito ha successo. Contiene l'output dell'esecuzione.

URL di base

https://apis.roblox.com
Risorsa LuauExecutionSessionTask

{
"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

Crea un compito ma non attende che il compito sia completato.

Per controllare se un compito è stato completato, chiama il metodo GetLuauExecutionSessionTask e ispeziona il campo state della risorsa restituita.

Quotazioni:

  • 5 chiamate al minuto per il proprietario della chiave API
  • 45 chiamate al minuto per indirizzo IP
Campi
universe.place.luau-execution-session:write
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

place_idstring
Necessario

L'ID del luogo.

Corpo della richiestaLuauExecutionSessionTask
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"
}'
Risposta

{
"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"
}
}