LuauExecutionSessionTask
Một LuauExecutionSessionTask ("nhiệm vụ" cho ngắn) thực hiện một kịch bản Luau nhất định trong bối cảnh của một phiên bản cụ thể của một địa điểm.
Trong một nhiệm vụ, mô phỏng vật lý không chạy. Cả máy chủ và các kịch bản địa phương bên trong nơi cũng không tự động chạy.
Tập lệnh có thể truy cập và cập nhật mô hình dữ liệu của địa điểm, bao gồm khởi tạo bất kỳ kịch bản module nào.Tuy nhiên, thay đổi mô hình dữ liệu là địa phương cho nhiệm vụ và không thể được lưu trữ.
Tập lệnh cũng có thể gọi các API động cơ đọc và/hoặc chỉnh sửa dữ liệu được lưu trong đám mây, chẳng hạn như những cái cho DataStores.Lưu ý khi sử dụng các API này.
Các kịch bản có thể lên tới 4 MB về kích cỡ và chạy trong vòng tối đa 5 phút. Các kịch bản chạy lâu hơn giới hạn thời gian kết thúc với một lỗi.
Các kịch bản được thực hiện như là và không cần phải được bọc trong một chức năng.
Các tập lệnh có thể trả về giá trị (sử dụng từ khóa Luau return).Giá trị trả lại được serialize thành JSON và có thể được lấy lại với API Get LuauExecutionSessionTask sau khi hoàn thành nhiệm vụ.Tổng kích thước của các giá trị trả lại sau serialization JSON không được vượt quá 4 MB.Nếu giới hạn bị vượt quá, nhiệm vụ kết thúc với một lỗi.
Nếu kịch bản gây ra một lỗi chưa xử lý, nhiệm vụ kết thúc. Thông tin lỗi có thể được lấy lại bằng API GetLuauExecutionSessionTask.
Output tiêu chuẩn (được tạo bởi chức năng Luau print ) có thể được truy xuất với phương pháp ListLuauExecutionSessionTaskLogs sau khi hoàn thành nhiệm vụ.Tối đa 450 KB các bản ghi được giữ lại.Nếu số lượng ghi nhận vượt quá giới hạn, các ghi nhận cũ hơn sẽ bị loại bỏ.
Thông tin về một nhiệm vụ được giữ lại trong 24 giờ sau khi hoàn thành nhiệm vụ.
Tối đa mười nhiệm vụ chưa hoàn thành được phép tại mỗi địa điểm. Cố gắng tạo thêm nhiệm vụ trong khi mười đầu tiên chưa hoàn thành dẫn đến kết quả 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
Thuộc Tính
Con đường tài nguyên của nhiệm vụ thực thi luau.
Định dạng:
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}.
Thời gian khi nhiệm vụ này được tạo. Chuỗi này được định dạng là Dấu thời gian.
Thời gian khi tình trạng của nhiệm vụ này lần cuối thay đổi. Chuỗi này được định dạng là Dấu thời gian.
Người dùng đã tạo chìa khóa API được sử dụng để tạo nhiệm vụ này.
Tình trạng của nhiệm vụ. Xem danh sách trạng thái để có thông tin về mỗi giá trị có thể.
Các giá trị có thể:
| Giá trị | Mô tả | | --- | --- | | STATE_UNSPECIFIED | UNSPECIFIED | | QUEUED | Nhiệm vụ đang chờ xử lý.| | XỬ LÝ | Nhiệm vụ đã được lấy lên để xử lý.| | BỊ HUỶ | Nhiệm vụ đã bị ngừng bởi người dùng.| | HOÀN THÀNH | Nhiệm vụ đã hoàn thành xử lý.Trường xuất ra chứa output.| | THẤT BẠI | Nhiệm vụ thất bại.Trường lỗi có chứa chi tiết về lỗi. |. Giá trị có thể:
Tập lệnh để chạy làm phần của nhiệm vụ này.
Ví dụ:
local x = 3
local y = 4
return x + y
```.
Giới hạn thời gian chạy của kịch bản.
Nhiệm vụ thất bại nếu kịch bản không hoàn thành trong thời gian quy định.
Mặc định là 5 phút.
Hiện diện khi thực hiện nhiệm vụ thất bại. Bao gồm chi tiết về lỗi gây ra thất bại.
Hiện diện khi thực hiện nhiệm vụ thành công. Bao gồm output của thực hiện.