LuauExecutionSessionTask
Un LuauExecutionSessionTask ("tarea" para abreviar) ejecuta un guión Luau dado en el contexto de una versión específica de un lugar.
En una tarea, la simulación de física no se ejecutar. Los scripts del servidor y locales dentro del lugar tampoco se ejecutarautomáticamente.
El script puede acceder y actualizar el modelo de datos del lugar, incluyendo la invocación de cualquier script de módulo.Sin embargo, los cambios de modelo de datos son locales a la tarea y no se pueden persistir.
El script también puede invocar API de motor que leen y/o modifican los datos almacenados en la nube, como las de almacenes de datos.Tenga precaución al usar estas API.
Los scripts pueden tener hasta 4 MB de tamaño y ejecutarse durante hasta 5 minutos. Los scripts que se ejecutan más allá del límite de tiempo terminan con un error.
Los scripts se ejecutan tal como son y no necesitan ser envueltos en una función.
Los scripts pueden devolver valores (usando la palabra clave Luau return).Los valores de devolución se serializan a JSON y se pueden recuperar con la API Get LuauExecutionSessionTask después de que la tarea se complete.El tamaño total de los valores de devolución después de la serialización JSON no debe exceder 4 MB.Si se supera el límite, la tarea termina con un error.
Si el script levanta un error no manejado, la tarea termina. La información del error se puede recuperar con la API GetLuauExecutionSessionTask.
La salida estándar (generada por la función Luau print ) se puede recuperar con el método ListLuauExecutionSessionTaskLogs después de que la tarea se complete.Se retiene un máximo de 450 KB de registros.Si la cantidad de registros supera el límite, se descartan los registros más antiguos.
La información sobre una tarea se retiene durante 24 horas después de la finalización de la tarea.
Se permiten un máximo de diez tareas incompletas por lugar. Intentar crear más tareas mientras las primeras diez son incompletas resulta en una respuesta HTTP 429.
- /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
Atributos
El camino de recursos de la tarea de ejecución de luau.
Formatos:
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}.
Tiempo en que se creó esta tarea. Esta cadena está formateada como Timestamp.
Tiempo cuando el estado de esta tarea última vez cambió. Esta cadena está formateada como Timestamp.
El usuario que creó la clave de API que se utilizó para crear esta tarea.
El estado de la tarea. Vea el estado enum para obtener información sobre cada valor posible.
Posibles valores:
| Valor | Descripción | | --- | --- | | ESTADO_NO_ESPECIFICADO | NO ESPECIFICADO | | QUEUED | La tarea está pendiente de ser procesada.| | PROCESAMIENTO | La tarea se ha recogido para su procesamiento.| | CANCELADO | La tarea ha sido detenida por el usuario.| | COMPLETO | La tarea ha terminado de procesarse.El campo de salida contiene la Salida.| | FALLADO | La tarea falló.El campo de error contiene detalles sobre el error. |. Valores posibles:
El script para ejecutarse como parte de esta tarea.
Por ejemplo:
local x = 3
local y = 4
return x + y
```.
Límite de cuánto tiempo puede ejecutarse el script.
La tarea falla si el script no se completa dentro del tiempo especificado.
Por defecto, 5 minutos.
Presente cuando la ejecución de la tarea falla. Contiene detalles sobre el error que causó el fallo.
Presente cuando la ejecución de la tarea tiene éxito. Contiene la salida de la ejecución.