*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

LuauExecutionSessionTask

A LuauExecutionSessionTask ("งาน" สำหรับสั้น) ดำเนินการตามสคริปต์ Luau ที่กำหนดในบริบทของเวอร์ชันเฉพาะของสถานที่

ในภารกิจการจำลองฟิสิกส์จะไม่ทำงาน เซิร์ฟเวอร์และสคริปท์ท้องถิ่นภายในสถานที่ก็ไม่ทำงานโดยอัตโนมัติ

สคริปต์อาจเข้าถึงและอัปเดตโมเดลข้อมูลของสถานที่รวมถึงการเรียกใช้สคริปต์โมดูลใดๆอย่างไรก็ตาม การเปลี่ยนแปลงรูปแบบข้อมูลเป็นท้องถิ่นสำหรับงานและไม่สามารถเก็บไว้ได้

สคริปต์ยังสามารถเรียกใช้ API เครื่องยนต์ที่อ่านและ/หรือแก้ไขข้อมูลที่เก็บไว้ในคลาวด์ เช่น สำหรับ DataStoresใช้ความระมัดระวังเมื่อใช้ API เหล่านี้

สคริปต์สามารถมีขนาดได้ถึง 4MB และทำงานได้นานถึง 5 นาที สคริปต์ที่ทำงานนานกว่าขีดจํากัดเวลาจะสิ้นสุดด้วยข้อผิดพลาด

สคริปต์จะถูกดำเนินการตามที่เป็นและไม่จำเป็นต้องถูกห่อหุ้มในฟังก์ชัน

สคริปต์สามารถส่งค่ากลับ (โดยใช้คีย์วาร์ด Luau return)ค่ากลับจะถูกเขียนเป็น JSON และสามารถดึงได้ด้วย API Get LuauExecutionSessionTask หลังจากทําภารกิจสําเร็จขนาดรวมของค่าการ返回หลังการเขียนโดยตรงของ JSON ไม่ควรเกิน 4 MBหากขีดจํากัดถูกเกิน ภารกิจจะสิ้นสุดลงด้วยความผิดพลาด

หากสคริปต์เกิดข้อผิดพลาดที่ไม่สามารถจัดการได้ การดําเนินการจะสิ้นสุดลง ข้อมูลข้อผิดพลาดสามารถดึงได้ด้วย API GetLuauExecutionSessionTask

การออกมาตรฐาน (สร้างโดยฟังก์ชัน Luau print ) สามารถดึงได้ด้วยวิธี ListLuauExecutionSessionTaskLogs หลังจากทําภารกิจสําเร็จมีการเก็บบันทึกสูงสุด 450 KB เท่านั้นหากปริมาณล็อกเกินขีดจำกัดแล้วล็อกที่เก่ากว่าจะถูกทิ้ง

ข้อมูลเกี่ยวกับงานจะถูกเก็บไว้เป็นเวลา 24 ชั่วโมงหลังจากเสร็จสิ้นงาน

สามารถสร้างภารกิจไม่สมบูรณ์สูงสุดสิบรายการต่อสถานที่ได้ การพยายามสร้างภารกิจเพิ่มเติมในขณะที่สิบรายการแรกยังไม่สมบูรณ์จะส่งผลให้เกิดการตอบสนอง 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

คุณลักษณะ

pathstring

เส้นทางทรัพยากรของเซสชันการดําเนินการ luau ที่ทํา

รูปแบบ:

  • 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
เอาต์พุตเท่านั้น

เวลาที่งานนี้ถูกสร้างขึ้น. สตริงนี้มีรูปแบบประทับเวลา

updateTimestring
เอาต์พุตเท่านั้น

เวลาที่สถานะของงานนี้เปลี่ยนล่าสุด. สตริงนี้มีรูปแบบประทับเวลา

userstring
เอาต์พุตเท่านั้น

ผู้ใช้ที่สร้างคีย์ API ที่ใช้สร้างภารกิจนี้.

stateEnum<string>
เอาต์พุตเท่านั้น

สถานะของงาน ดูรายการเลขอัตราสถานะสำหรับข้อมูลเกี่ยวกับแต่ละค่าที่เป็นไปได้

มูลค่าที่เป็นไปได้:

| ค่า | คำอธิบาย | | --- | --- | | STATE_UNSPECIFIED | UNSPECIFIED | | QUEUED | ภารกิจกำลังรอการประมวลผล| | การประมวลผล | งานถูกเลือกขึ้นเพื่อประมวลผลแล้ว| | ยกเลิก | ภารกิจถูกหยุดโดยผู้ใช้| | สําเร็จ | ภารกิจได้รับการประมวลผลเสร็จแล้วฟิลด์ออกมีเอาต์พุต| | ล้มเหลว | งานล้มเหลวฟิลด์ข้อผิดพลาดมีรายละเอียดเกี่ยวกับข้อผิดพลาด |. ค่าที่เป็นไปได้:

scriptstring
ไม่สามารถเปลี่ยนแปลงได้

สคริปต์ที่จะถูกดำเนินการเป็นส่วนหนึ่งของภารกิจนี้

ตัวอย่าง:

local x = 3

local y = 4

return x + y

```.
timeoutstring
ไม่สามารถเปลี่ยนแปลงได้

จำกัดระยะเวลาที่สคริปต์สามารถทำงานได้

ภารกิจล้มเหลวหากสคริปต์ไม่สําเร็จภายในระยะเวลาที่กําหนด

ค่าเริ่มต้นคือ 5 นาที.

หนึ่งในรายการต่อไปนี้สำหรับresult:

errorobject

ปรากฏเมื่อการดําเนินการภารกิจล้มเหลว มีรายละเอียดเกี่ยวกับข้อผิดพลาดที่ทําให้เกิดความล้มเหลว.

outputobject

ปรากฏเมื่อการดําเนินการตามภารกิจประสบความสําเร็จ มีเนื้อหาของการดําเนินการออก.

URL หลัก
https://apis.roblox.com
แหล่งข้อมูล 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

สร้างภารกิจ แต่ไม่รอให้ภารกิจสําเร็จ

เพื่อตรวจสอบว่างานสําเร็จแล้วหรือไม่ โทรไปที่เมธอด GetLuauExecutionSessionTask และตรวจสอบฟิลด์ state ของทรัพยากรที่ส่งคืน

ความจำกัด:

  • การโทร 5 ครั้งต่อนาทีต่อเจ้าของคีย์ API
  • 45 สายต่อนาทีต่อที่อยู่ IP
ขอบเขต
universe.place.luau-execution-session:write
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

ID ของจักรวาล.

place_idstring
จำเป็นต้องมี

รหัสสถานที่.

เนื้อหาคำขอLuauExecutionSessionTask
การตอบกลับLuauExecutionSessionTask
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"

}'
การตอบกลับ
{

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

  }

}