*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

LuauExecutionSessionTask

A LuauExecutionSessionTask ("작업" 약식)는 특정 플레이스장소 컨텍스트에서 지정된 Luau 스크립트를 실행합니다.

태스크에서 물리 시뮬레이션이 실행되지 않습니다. 장소 내의 서버와 로컬 스크립트도 자동으로 실행되지 않습니다.

스크립트는 모듈 스크립트를 호출하여 장소의 데이터 모델에 액세스하고 업데이트할 수 있습니다.그러나 데이터 모델 변경은 태스크에 로컬이고 영구화할 수 없습니다.

스크립트는 데이터 저장소와 같이 클라우드에 저장된 데이터를 읽고 수정하는 엔진 API를 호출할 수도 있습니다.이러한 API를 사용할 때 주의를 기울이십시오.

스크립트 크기는 최대 4MB까지이고 제한 시간보다 오래 실행될 수 있습니다. 제한 시간보다 오래 실행되는 스크립트는 오류로 종료됩니다.

스크립트는 그대로 실행되며 함수에 싸일 필요가 없습니다.

스크립트는 Luau 키워드(return)를 사용하여 값을 반환할 수 있습니다.반환 값은 JSON으로 직렬화되어 작업이 완료된 후 Get LuauExecutionSessionTask를 사용하여 검색할 수 있습니다.JSON 직렬화 후의 반환 값의 전체 크기는 4MB를 초과해서는 안됩니다.한도가 초과되면 태스크가 오류로 종료됩니다.

스크립트가 처리되지 않은 오류를 발생시키면 태스크가 종료됩니다. 오류 정보는 GetLuauExecutionSessionTask로 검색할 수 있습니다.

표준 출력(Luau print 함수에서 생성됨)은 작업이 완료된 후 ListLuauExecutionSessionTaskLogs 메서드로 검색할 수 있습니다.최대 450KB의 로그가 유지됩니다.로그 수가 한도를 초과하면 이전 로그가 삭제됩니다.

태스크 완료 후 24시간 동안 태스크에 대한 정보가 유지됩니다.

플레이스최대 10개의 미완료 태스크가 허용됩니다. 처음 10개가 미완료 상태로 남아 있으면 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

루au 실행 세션 태스크의 리소스 경로.

형식:

  • 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
출력 전용

이 작업이 생성된 시간. 이 문자열은 Timestamp 형식으로 지정됩니다.

updateTimestring
출력 전용

이 태스크의 상태가 마지막으로 변경된 시간. 이 문자열은 Timestamp 형식으로 지정됩니다.

userstring
출력 전용

이 태스크를 만드는 데 사용된 API 키를 만든 사용자.

stateEnum<string>
출력 전용

태스크의 상태. 각 가능한 값에 대한 정보는 상태 열거형을 참조하십시오.

가능한 값:

| 값 | 설명 | | --- | --- | | STATE_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
베타

POST /cloud/v2/universes/{universe_id}/places/{place_id}/luau-execution-session-tasks

작업을 만들지만 작업이 완료될 때까지 기다리지 않습니다.

태스크가 완료되었는지 확인하려면 GetLuauExecutionSessionTask 메서드를 호출하고 반환된 리소스의 state 필드를 검사하십시오.

할당량:

  • API 키 소유자당 분당 5개 통화
  • IP 주소당 분당 45개 통화
범위
universe.place.luau-execution-session:write
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

place_idstring
필수

장소 ID.

요청 본문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"

  }

}