*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

LuauExecutionSessionTask

A LuauExecutionSessionTask (" tugas" untuk singkat ) mengeksekusi skrip Luau tertentu dalam konteks versi tertentu dari tempat.

Dalam sebuah tugas, simulasi fisika tidak berjalan. Server dan skrip lokal di dalam tempat juga tidak secara otomatis berjalan.

Skrip dapat mengakses dan memperbarui model data tempat, termasuk memanggil skrip modul apa pun.Namun, perubahan model data lokal ke tugas dan tidak dapat disimpan.

Skrip juga dapat memanggil API mesin yang membaca dan/atau memodifikasi data yang disimpan di cloud, seperti yang untuk DataStores.Berhati-hatilah saat menggunakan API ini.

Skrip dapat berukuran hingga 4 MB dan berjalan selama hingga 5 menit. Skrip yang berjalan lebih lama dari batas waktu berakhir dengan kesalahan.

Skrip dieksekusi apa adanya dan tidak perlu dibungkus dalam fungsi.

Skrip dapat mengembalikan nilai (menggunakan kata kunci Luau return).Nilai return diserialisasi ke JSON dan dapat diambil dengan API Get LuauExecutionSessionTask setelah tugas selesai.Ukuran total nilai balasan setelah serialisasi JSON tidak boleh melebihi 4 MB.Jika batasnya dilampaui, tugas berakhir dengan kesalahan.

Jika skrip menyebabkan kesalahan yang tidak ditangani, tugas berakhir. Informasi kesalahan dapat diambil dengan API GetLuauExecutionSessionTask.

Output standar (yang dihasilkan oleh fungsi Luau print ) dapat diambil dengan metode ListLuauExecutionSessionTaskLogs setelah tugas selesai.Maksimal 450 KB log dipertahankan.Jika jumlah log melebihi batas, log yang lebih tua dibuang.

Informasi tentang tugas disimpan selama 24 jam setelah tugas selesai.

Paling banyak sepuluh tugas tidak lengkap diizinkan per tempat. Mencoba untuk membuat lebih banyak tugas saat sepuluh pertama tidak lengkap menghasilkan respons HTTP 429.

  • JALUR RESOURCE
  • /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

Atribut

pathstring

Jalur sumber daya dari tugas sesi eksekusi luau.

Format:

  • 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
Hanya Output

Waktu ketika tugas ini dibuat. String ini diformat sebagai Timestamp.

updateTimestring
Hanya Output

Waktu ketika status tugas ini terakhir berubah. String ini diformat sebagai Timestamp.

userstring
Hanya Output

Pengguna yang membuat kunci API yang digunakan untuk membuat tugas ini.

stateEnum<string>
Hanya Output

Status tugas. Lihat daftar negara untuk informasi tentang setiap nilai yang mungkin.

Nilai yang mungkin:

| Nilai | Deskripsi | | --- | --- | | STATE_UNSPECIFIED | TIDAK SPESIFIK | | QUEUED | Tugas menunggu untuk diproses.| | PROSES | Tugas telah diambil untuk diproses.| | DIBATALKAN | Tugas telah dihentikan oleh pengguna.| | SELESAI | Tugas telah selesai diproses.Bidang output berisi output.| | GAGAL | Tugas gagal.Bidang kesalahan berisi rincian tentang kesalahan. |. Nilai yang mungkin:

scriptstring
Immutable

Skrip yang akan dijalankan sebagai bagian dari tugas ini.

Sebagai contoh:

local x = 3

local y = 4

return x + y

```.
timeoutstring
Immutable

Batas untuk berapa lama skrip dapat dijalankan.

Tugas gagal jika skrip tidak selesai dalam waktu yang ditentukan.

Default ke 5 menit.

Salah satu dari yang berikut untuk result:

errorobject

Hadir saat eksekusi tugas gagal. Berisi rincian tentang kesalahan yang menyebabkan kegagalan.

outputobject

Hadir saat eksekusi tugas berhasil. Berisi output dari eksekusi.

Base URL
https://apis.roblox.com
Resource 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

Membuat tugas tetapi tidak menunggu tugas selesai.

Untuk memeriksa apakah tugas telah selesai, panggil metode GetLuauExecutionSessionTask dan periksa bidang state dari sumber yang dikembalikan.

Kutipan:

  • 5 panggilan per menit per pemilik kunci API
  • 45 panggilan per menit per alamat IP
Cakupan
universe.place.luau-execution-session:write
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

place_idstring
Diperlukan

ID tempat.

Request BodyLuauExecutionSessionTask
ResponsLuauExecutionSessionTask
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"

}'
Respons
{

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

  }

}