Accepts a function or a thread (as returned by coroutine.create) and
calls/resumes it immediately through the engine's scheduler. Arguments
after the first are sent to the function/thread. This function does not
return any value, even if the provided function returns one immediately.

This function is based on the fastSpawn pattern rather than being a
replacement for the deprecated global `spawn` function. It is recommended
that this function be used in place of fastSpawn.

If the calling script is currently running in a serial execution phase,
then the spawned function or thread is resumed in the current serial
execution phase. If the calling script is currently running in a parallel
execution phase, then the spawned function or thread is resumed in the
current parallel execution phase. For more information, see
[Parallel Luau](/scripting/multithreading).


task.spawn

functionOrThread

A function or a thread returned by coroutine.create.


Arguments to send to the function or thread.


Calls/resumes a function/coroutine immediately through the engine
scheduler.


Accepts a function or a thread (as returned by coroutine.create) and
defers it until the next
[resumption cycle](https://devforum.roblox.com/t/1240569), at which point
it is resumed with the engine's scheduler like with
`Library.task.spawn()`. Arguments after the first are sent to the
function/thread. This function does not return any value, even if the
provided function returns one immediately.

This function should be used when a similar behavior to
`Library.task.spawn()` is desirable, but the thread does not need to run
immediately.

If the calling script is currently running in a serial execution phase,
then the deferred function or thread is resumed in a serial execution
phase. If the calling script is currently running in a parallel execution
phase, then the deferred function or thread is resumed in a parallel
execution phase. For more information, see
[Parallel Luau](/scripting/multithreading).


task.defer

Calls/resumes a function/coroutine on the next resumption cycle.


Accepts a function or a thread (as returned by coroutine.create) and
schedules it to be called/resumed on the next
`Class.RunService.Heartbeat|Heartbeat` after the given amount of time in
seconds has elapsed. Arguments after the second are sent to the
function/thread.

This function differs from the deprecated global `delay` function in that
**no throttling occurs**: on the very same Heartbeat step in which enough
time has passed, the function is guaranteed to be called/resumed.
Providing a duration of zero (0) will guarantee that the function is
called on the very next Heartbeat.

You can calculate the actual time passed by calling `Library.os.clock()`
upon scheduling and in the scheduled function.

If the calling script is currently running in a serial execution phase,
then the delayed function or thread is resumed in a serial execution
phase. If the calling script is currently running in a parallel execution
phase, then the delayed function or thread is resumed in a parallel
execution phase. For more information, see
[Parallel Luau](/scripting/multithreading).


task.delay

duration

The minimum number of seconds that must pass before the
function/thread is called/resumed.


Arguments to be passed to the function/thread when it is due to be
called/resumed.


Schedules a function/coroutine to be called/resumed on the next Heartbeat
after the given duration (in seconds) has passed, without throttling.


If the calling script is currently running in a serial execution phase,
`desynchronize` suspends the script and the script will be resumed in the
next parallel execution phase. If the calling script is currently running
in a parallel execution phase, `desynchronize` returns immediately and has
no effect.

Only scripts which are descendants of an Actor may call this method. If a
script outside of an Actor calls this method, an error will be raised.
ModuleScript's may also call `desynchronize` as long as the instantiation
of the module calling it was required by a script that is a descendant of
an Actor.

For more information, see
[Parallel Luau](/scripting/multithreading).


task.desynchronize

Causes the following code to be run in parallel.


If the calling script is currently running in a parallel execution phase,
`synchronize` suspends the script and the script will be resumed in the
next serial execution phase. If the calling script is currently running in
a serial execution phase, `synchronize` returns immediately and has no
effect.

Only scripts which are descendants of an Actor may call this method. If a
script outside of an Actor calls this method, an error will be raised.
ModuleScript's may also call `synchronize` as long as the instantiation of
the module calling it was required by a script that is a descendant of an
Actor.

For more information, see
[Parallel Luau](/scripting/multithreading).


task.synchronize

Causes the following code to be run in serial.


Yields the current thread until the given duration (in seconds) has
elapsed, then resumes the thread on the next
`Class.RunService.Heartbeat|Heartbeat` step. The actual amount of time
elapsed is returned.

If no duration is given, it will default to zero (0). This means the
thread resumes on the very next step, which is equivalent in behavior to
`RunService.Heartbeat:Wait()`

Unlike the deprecated global `wait`, this function **does not throttle**
and guarantees the resumption of the thread on the first Heartbeat that
occurs when it is due. This function also only returns the elapsed time
and nothing else.

If the calling script is currently running in a serial execution phase,
then the script is resumed in a serial execution phase. If the calling
script is currently running in a parallel execution phase, then the script
is resumed in a parallel execution phase. For more information, see
[Parallel Luau](/scripting/multithreading).


task.wait

The amount of time in seconds that should elapse before the current
thread is resumed.


Yields the current thread until the next Heartbeat in which the given
duration (in seconds) has passed, without throttling.


Cancels a thread and closes it, preventing it from being resumed manually
or by the task scheduler.

This function can be used with other members of the task library that
return a thread to cancel them before they are resumed. For example:

```lua
local thread = task.delay(5, function ()
  print("Hello world!")
end)

task.cancel(thread)
```

Note: Threads may be in a state where it is impossible to cancel them. For
example, the currently executing thread and threads that have resumed
another coroutine may not be cancelled. If this is the case, a lua error
will be generated.

However, code should not rely on specific thread states or conditions
causing `Library.task.cancel()` to fail. It is possible that future
updates will eliminate these constraints and allow threads in these states
to be successfully cancelled.


task.cancel

thread

Cancels a thread, preventing it from being resumed.


task

Allows for functions and threads to be coordinated with the Task Scheduler.


An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

Variant

Functions are blocks of code that can execute multiple times on command.

Luau

function

A double-precision floating-point number.

number

A function that executes alongside the main thread.

Library

coroutine

void

개요

가이드

튜토리얼

참조

리소스

아트

디자인

엔진

Avatar

클라우드

이 필드는 리소스를 생성할 때 설정될 수 있지만 후속 요청에 의해 수정될 수는 없습니다.

이 필드는 요청에 제공될 수 있지만 응답에는 포함되지 않습니다.

각 API 키별: IP 주소당 {periodInSeconds}초마다 {maxInPeriod} 요청

이 필드는 요청에서 무시됩니다.

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한
자세한 내용은 [API 키 관리]({apiKeyReferenceDocLink})에서 확인하세요.

다음 끝점은 기준 URL과 관련된 경로에서 사용할 수 있습니다.

이 문자열은 [FieldMask](/cloud/reference/types#fieldmask) 형식으로 지정됩니다.

JSON 값은 `null`, `boolean`, `string`, `number`, `array`, `object`일 수 있습니다.

OAuth 2.0 애플리케이션에서 이 엔드포인트를 사용하려면 다음 범위가 필요합니다. OAuth 2.0 애플리케이션 등록 방법에 대한 자세한 내용은 [앱 등록 및 심사]({oauth2ReferenceDocLink})에서 확인하세요.

다음 개체는 수락되거나 반환되는 페이로드를 설명합니다. 이러한 개체가 사용되는 시기에 대한 자세한 정보는 각 개별 끝점을 참고하세요.

이 문자열은 [Timestamp](/cloud/reference/types#timestamp) 형식으로 지정됩니다.

이를 통해 애셋에 대한 정보를 볼 수 있습니다.

이를 통해 애셋을 Roblox에 업로드하고 업데이트할 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 볼 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 수정할 수 있습니다.

이를 통해 그룹에 대한 정보를 볼 수 있습니다.

이제 계정에 대한 그룹 가입 요청을 관리할 수 있습니다.

이를 통해 인벤토리에 대한 정보를 볼 수 있습니다.

사용자를 대신해 메시지를 게시할 수 있는 권한이 부여됩니다.

이를 통해 체험에서 사용자에게 알림을 보낼 수 있습니다

이를 통해 체험과 관련된 시크릿을 나열할 수 있습니다.

이를 통해 체험과 관련된 시크릿을 생성하고 업데이트할 수 있습니다.

플레이스 정보를 읽을 수 있는 권한을 부여합니다.

플레이스 정보를 편집할 수 있는 권한을 부여합니다.

이 작업은 새로운 버전의 체험을 Roblox에 게시할 수 있는 권한을 부여합니다.

체험 정보를 읽을 수 있는 권한을 부여합니다.

체험 정보를 편집할 수 있는 권한을 부여합니다.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

사용자의 Premium 및 인증 상태를 읽을 수 있는 권한을 부여합니다.

이를 통해 사용자의 소셜 계정을 볼 수 있습니다.

이 작업은 싱글 사인온 기능을 활성화합니다

프로필 정보를 읽을 수 있는 액세스 권한을 부여합니다

기본값: {defaultValueStart}{defaultValueEnd}

배열은 순서가 지정된 값 목록입니다. 배열은 데이터 컬렉션을 저장하는 데 유용합니다.

키-값 쌍 집합으로, 이때 키는 숫자, 문자열 또는 개체일 수 있습니다.

{tuples}(와)과 마찬가지로, 값의 목록입니다.

이 함수는 가능한 경우 즉시 반환하지만, 값을 반환할 수 있을 때까지 호출한 스레드를 일시 중단할 수 있습니다.

{nameStart}이름{nameEnd}(은)는 더 이상 Roblox에서 지원하거나 유지 관리하지 않습니다.

이 수학 연산은 더 이상 Roblox에서 지원하거나 유지 관리하지 않습니다.

이 멤버는 개체 브라우저에 표시되지 않으며 널리 사용하기 위한 것이 아닙니다.

이 멤버는 명령 모음을 통해서만 액세스할 수 있습니다. 스크립트에서 이 멤버에 액세스하려고 하면 오류가 발생합니다.

이 함수는 호출한 Lua 스레드를 일시 중지할 수 없습니다.

스크립트에서 이 멤버에 액세스하려고 하면 오류가 발생합니다. Roblox Studio의 속성 창에서 이 멤버에 액세스가 가능할 수 있습니다.

이 멤버는 Roblox Studio의 개체 브라우저에 표시되지 않습니다.

Instance.new 생성자로 이 클래스의 인스턴스를 만들 수 없습니다.

Roblox는 서버-클라이언트 경계를 넘어 이 멤버를 복제하지 않습니다.

Lua 코드는 이 멤버에 액세스할 수 없습니다. Roblox Studio의 속성 창에서 값의 변경이 가능할 수 있습니다.

이 개체의 복제 동작은 개체를 소유한 플레이어에 따라 다릅니다.

이 멤버는 명령 모음 및 플러그인을 통해서만 액세스할 수 있습니다. 스크립트에서 이 멤버에 액세스하려고 하면 오류가 발생합니다.

이 멤버는 읽기 전용입니다. 이 멤버에 쓰려고 하면 오류가 발생합니다.

이 속성은 읽기 전용이며 동기화되지 않은 스레드에서 안전하게 읽을 수 있습니다. 쓰기를 시도하면 오류가 발생합니다.

이 멤버는 CoreScript에서만 액세스할 수 있습니다.

Roblox CoreScript만 이 멤버에 액세스할 수 있으며, Players는 이를 사용할 수 없습니다.

여러 스레드에서 이 속성에 안전하게 읽고 쓸 수 있습니다.

이 클래스는 최상위 Singleton입니다. GetService 함수를 사용해 이 클래스의 인스턴스를 가져옵니다.

여러 스레드가 이 속성에 쓸 수 있으므로, 동기화되지 않은 스레드에서 읽는 것은 안전하지 않습니다.

이 함수는 결과를 반환할 때까지 호출한 Lua 스레드를 일시 중지합니다. 다른 스크립트를 방해하지 않습니다.

종합 가이드, 코드 샘플, 참조, 튜토리얼을 통해 Roblox에서 성공적인 콘텐츠를 만드는 방법에 대해 알아보세요.


{pageTitle} | {SiteName}

제목

인벤토리에 추가할 수 없습니다

코드 샘플 {title}(이)가 인벤토리에 추가되었습니다.

버전 {versionNumber}에는 일반적인 성능 개선 및 버그 수정이 포함되어 있습니다. 특정 개선 사항 및 버그에 대한 상태는 다른 릴리스 정보를 통해 확인하세요.

개인정보는 포함하지 마세요. 최대 {maxDescriptionLength} 단어까지 가능합니다.

설명에는 최소 {minDescriptionLength}단어를 입력해야 합니다.

Roblox Studio 버전 {versionNumber}의 릴리스 정보

더욱 멋진 Roblox 세상이 될 수 있도록 점검을 진행하고 있습니다. 양해해 주셔서 감사합니다.

'계속'을 클릭하면 {redirectLinkStart}{redirectLinkEnd}(으)로 이동하게 됩니다

본 사이트는 Roblox에서 소유 및 운영하지 않습니다. 약관 및 개인정보 처리방침이 다를 수 있습니다.

task

요약

함수

함수

spawn

매개 변수

반환

defer

매개 변수

반환

delay

매개 변수

반환

desynchronize

반환

synchronize

반환

wait

매개 변수

반환

cancel

매개 변수

반환