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アドレスにつき {maxInPeriod} 回のリクエストが {periodInSeconds} 秒ごとに送信されます

このフィールドは応答に設定できますが、リクエストでは無視されます。

このエンドポイントを呼び出すには以下のAPIキー権限が必要です。適切なキーの生成方法についての情報は、 [API キーの管理]({apiKeyReferenceDocLink}) をごらんください。

次のエンドポイントは、ベースのURLに相対するパスで使用できます。

この文字列は [Timestamp](/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に新しいバージョンのバーチャル空間を公開するアクセス権限が与えられます。

バーチャル空間の情報を読む能力を付与。

バーチャル空間の情報を編集する能力を付与。

バーチャル空間内でのユーザー制限を表示できます。

バーチャル空間内でのユーザー制限が編集できるようになります。

ユーザーがプレミアム会員がどうかと認証済みかどうかを読み取る権限を付与。

これでユーザーのSNSアカウントを表示できるようになります。

これはシングルサインオン機能を有効化

これにより、あなたのプロフィール情報を読む権限が与えられます

デフォルト値: {defaultValueStart}{defaultValueEnd}

配列は順番に並べてある値のリストです。配列はデータの集まりを保存するのに便利です。

キーと値のペアのセットで、キーは任意の番号、文字列、またはオブジェクトにできます。

{tuples} のような数値のリスト。

この関数は可能であればすぐに返しますが、値を返すまで呼び出したスレッドを返すことができます。

Robloxは現在、 {nameStart}名前{nameEnd} への対応と管理をしていません。

Robloxは現在、 この演算への対応と管理をしていません。

このメンバーはオブジェクトブラウザに表示されず、広く使用されることを意図していません。

このメンバーはコマンドバーからしかアクセスできません。スクリプトからこのメンバーにアクセスしようとするとエラーが発生します。

この関数は、それを呼び出したLuaスレッドを一時停止できません。

スクリプト内でこのメンバーにアクセスしようとするとエラーが発生します。Roblox Studio のプロパティ ウィンドウからこのメンバーにアクセスできる可能性があります。

このメンバーはRoblox Studioのオブジェクトブラウザには表示されません。

Instance.new コンストラクタを使用してこのクラスのインスタンスを作成できません。

Robloxは、このメンバーをサーバーとクライアント間の境界を超えて複製しません。

Luaコードはこのメンバーにアクセスできません。Roblox Studioのプロパティウィンドウから値を変更できるかもしれません。

このオブジェクトのレプリケーション動作は、所有しているプレイヤーによって異なります。

このメンバーはコマンドバーとプラグインからしかアクセスできません。スクリプトからこのメンバーにアクセスしようとするとエラーが発生します。

このメンバーは読み取り専用です。このメンバーに書き込みを試みるとエラーが発生します。

このプロパティは読み取り専用で、同期されていないスレッドでも安全に読み取りできます。書き込みを試みるとエラーが発生します。

このメンバーは CoreScript でしかアクセスできません。

Roblox CoreScripts のみがこのメンバーにアクセスでき、Players は使用できません。

複数のスレッドから安全にこのプロパティの読み取りと書き込みができます。

このクラスはトップレベルのシングルトンです。GetService 関数でこのクラスのインスタンスを回収します。

複数のスレッドがこのプロパティに書き込める可能性があるため、同期されていないスレッドから読み取るのは安全ではありません。

この関数は、結果を返すまで呼び出した Lua スレッドを一時停止します。他のスクリプトを中断することはありません。

包括的なガイドとコードサンプル、資料、チュートリアルを使ってRobloxで業績を上げるコンテンツを制作する方法を学びましょう。


{pageTitle} | {SiteName}

題名

持ち物リストに追加できません

{title} のコードサンプルが持ち物リストに追加されました。

バージョン {versionNumber} には、一般的なパフォーマンスの改善とバグ修正が含まれています。具体的な改善やバグの状況については、他のリリースノートをご確認ください。

私的な情報や個人情報を入れないでください。最大 {maxDescriptionLength} 文字まで。

詳細には最低 {minDescriptionLength} 語句が必要です。

Roblox Studio バージョン {versionNumber} のリリースノート

メンテナンス中のため、大変ご不便をおかけいたしますが、しばらくの間ご利用いただけません。

「続ける」をクリックすると、 {redirectLinkStart}{redirectLinkEnd} に飛びます

このサイトは、Robloxが所有や管理をしているものではありません。違う利用規約やプライバシーポリシーがあるかもしれません。

task

概要

関数

関数

spawn

パラメータ

戻り値

defer

パラメータ

戻り値

delay

パラメータ

戻り値

desynchronize

戻り値

synchronize

戻り値

wait

パラメータ

戻り値

cancel

パラメータ

戻り値