*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

LuauExecutionSessionTask

Bir LuauExecutionSessionTask ("görev" kısaca) belirli bir dünyaözel bir sürümünün konteksinde belirli bir Luau senaryosunu yürütür.

Bir görevde, fizik simülasyonu çalışmaz. Yer içindeki sunucu ve yerel kodlar otomatik olarak çalışmaz.

Komut dosyası, herhangi bir modül kodunu çağırmak dahil olmak üzere dünyaveri modeline erişebilir ve güncelleyebilir.Ancak, veri modeli değişiklikleri görev için yereldir ve sürdürülemez.

Senaryo ayrıca bulutta depolanan verileri okuyan ve/veya değiştiren bulut API'lerini de çağırabilir, örneğin DataStores için.Bu API'leri kullanırken dikkatli olun.

Kodlar boyutuna göre 4 MB'ye kadar olabilir ve 5 dakika boyunca çalışabilir. Süre sınırından daha uzun süre çalışan kodlar bir hata ile sona erer.

Kodlar olduğu gibi çalıştırılır ve bir işlev içine sarılmaları gerekmez.

Scriptler değerleri döndürebilir (Luau return anahtar kelimesini kullanarak).Geri dönüş değerleri JSON'a serilir ve görev tamamlandıktan sonra Get LuauExecutionSessionTask ile alınabilir.JSON serialize'dan sonra dönüş değerlerinin toplam boyutu 4 MB'yi aşmamalıdır.Sınır aşılırsa, görev bir hata ile sona erer.

Eğer senaryo ele alınmayan bir hata yükseltirse, görev sona erer. Hata bilgisi GetLuauExecutionSessionTask ile alınabilir.

Standart çıkış (Luau print fonksiyonu tarafından üretilmiş) görev tamamlandıktan sonra ListLuauExecutionSessionTaskLogs yöntemi ile alınabilir.Maksimum 450 KB'lik günlük tutulur.Günlük miktarı sınırı aşarsa, daha eski günlükler atılır.

Bir görev hakkındaki bilgiler, görev tamamlandıktan sonra 24 saat saklanır.

En fazla on tamamlanmamış görev dünyabaşına izin verilir. İlk on tamamlanmamış görevler sırasında daha fazla görev oluşturmaya çalışmak, bir HTTP 429 yanıtında bozulur.

  • KAYNAK YOLLARI
  • /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

Nitelikler

pathstring

luau yürütme oturumu görevinin kaynak yolu.

Formlar:

  • 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
Yalnızca Çıkış

Bu görevin oluştuğu zaman. Bu dizi Timestamp olarak biçimlendirilmiş.

updateTimestring
Yalnızca Çıkış

Bu görevin son durumunun değiştiği zaman. Bu dizi Timestamp olarak biçimlendirilmiş.

userstring
Yalnızca Çıkış

Bu görev oluşturmak için kullanılan API anahtarını oluşturan kullanıcı.

stateEnum<string>
Yalnızca Çıkış

Görevin durumu. Her olası değer hakkında bilgi için Durum sayısına bakın.

Olası değerler:

| Değer | Açıklama | | --- | --- | | STATE_UNSPECIFIED | UNSPECIFIED | | QUEUED | Görev işlenmeyi bekliyor.| | İŞLEME | Görev işlenmek üzere seçildi.| | İPTAL EDİLDİ | Görev, kullanıcı tarafından durduruldu.| | COMPLETE | Görev işleme bitirdi.Çıktı alanı çıktıyı içerir.| | BAŞARISIZ | Görev başarısız oldu.Hata alanı hata ile ilgili ayrıntılar içerir. |. Olası değerler:

scriptstring
Sabit

Bu görevin bir parçası olarak çalıştırılacak kod.

Örneğin:

local x = 3

local y = 4

return x + y

```.
timeoutstring
Sabit

Senaryonun ne kadar süre çalışabileceğine sınır koyun.

Senaryo belirtilen sürede tamamlanmazsa görev başarısız olur.

Varsayılan 5 dakikaya.

result için şunlardan biri:

errorobject

Görev yürütümü başarısız olduğunda mevcuttur. Başarısızlığa neden olan hata hakkında ayrıntılar içerir.

outputobject

Görev yürütmesi başarılı olduğunda mevcuttur. Çıktıyı içerir.

Taban URL
https://apis.roblox.com
LuauExecutionSessionTask Kaynağı
{

  "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

Bir görev oluşturur, ancak görevin tamamlanmasını beklemez.

Bir görevin tamamlandığını kontrol etmek için, GetLuauExecutionSessionTask yöntemini çağırın ve döndürülen kaynağın state alanını kontrol edin.

Kotalar:

  • API anahtar sahibi başına dakika başına 5 çağrı
  • IP adresi başına dakika-45 çağrı
Kapsamlar
universe.place.luau-execution-session:write
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

place_idstring
Gerekli

Yer kimliği.

Talep GövdesiLuauExecutionSessionTask
YanıtLuauExecutionSessionTask
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"

}'
Yanıt
{

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

  }

}