Roblox zapewnia kilka unikalnych wbudowanych funkcji i zmiennych w swoim
osadzeniu Luau. Te znajdują się tylko w Roblox i nie są dostarczane domyślnie z
Luau ani Lua.

Planowanie funkcji, która ma być wykonywana po upływie `delayTime`
sekund, bez zawieszania aktualnego wątku. Ta funkcja pozwala na równoległe
wykonywanie wielu wątków Luau z tej samej stosu. Opóźnienie ma minimalny czas
długości 29 milisekund, ale ten minimum może być wyższe w zależności od
docelowej liczby klatek na sekundę i różnych warunków ograniczania. Jeśli
parametr `delayTime` nie jest określony, użyta zostanie minimalna długość.

delay

delayTime

Ilość czasu, przez który ta funkcja będzie w kolejce przed jej
wykonaniem.

callback

Funkcja, która będzie wykonywana po upływie `delayTime` sekund.

Planowanie funkcji, która ma zostać wywołana po następnej Heartbeat, gdy
upłynie podany czas (w sekundach), z ograniczeniem.

Zwraca przestarzałą klasę `DebuggerManager`, która działa jako interfejs
dla funkcji debuggera Luau Roblox.

Ta funkcja nie jest rozpoznawana przez narzędzie analizy Luau i wywoła
ostrzeżenie o niezdefiniowanej globalnej.

DebuggerManager

Odnosi się do przestarzałej klasy `DebuggerManager`, która działa jako
interfejs dla funkcji debuggera Luau.

Zwraca, ile czasu upłynęło od momentu uruchomienia obecnej instancji
Roblox. W Roblox Studio ten czas zaczyna się liczyć od momentu uruchomienia
Roblox Studio, a nie tylko podczas otwierania miejsca.

elapsedTime

Czas, w sekundach, od momentu uruchomienia bieżącej instancji Roblox.


Zwraca ilość czasu w sekundach, przez które obecna instancja Roblox
jest uruchamiana.

Zwraca `Class.PluginManager`, który jest przestarzałym singletonem, który
wcześniej był wymagany do tworzenia pluginów. Nadal ma pewne zastosowania,
gdyż może być potrzebny do tworzenia obiektu `Class.Plugin` z
[Command Bar](/studio/ui-overview#command-bar) Studio.

PluginManager

Odnosi się do `Class.PluginManager`, przestarzałego singletona, który
wcześniej był wymagany do tworzenia pluginów.

Wyświetla `Obecna tożsamość to [ID]` w wyjściu, gdzie [ID] odpowiada
poziomowi ekspozycji bezpieczeństwa bieżącego wątku.

printidentity

prefix

Niestandardowy ciąg do wydrukowania przed numerem tożsamości; jeśli pominięty,
domyślnie "Bieżąca tożsamość to".


Wyświetla "Obecna tożsamość to X", gdzie X odpowiada poziomowi
ekspozycji bezpieczeństwa obecnego wątku.

Zwraca obiekt `Class.GlobalSettings`, który można wykorzystać do dostępu do
obiektów ustawień wykorzystywanych w menu ustawień Roblox Studio.

settings

Singleton GlobalSettings używany do uzyskiwania dostępu do obiektów ustawień Roblox Studio.


Zwraca obiekt `Class.GlobalSettings`, który można wykorzystać do
dostępu do obiektów ustawień konfiguracyjnych zachowania Roblox Studio.

Uruchamia określoną funkcję zwrotną w osobnym wątku, bez wstrzymywania bieżącego wątku.

Funkcja zostanie wykonana następnym razem, gdy Harmonogram Zadań Roblox uruchomi cykl aktualizacji. To opóźnienie zajmie co najmniej 29 milisekund, ale może trwać dłużej, w zależności od docelowej liczby klatek na sekundę i różnych warunków ograniczających.

Funkcja zwrotna jest wywoływana z dwoma argumentami:

1. Pierwszym jest ilość czasu, która upłynęła od momentu wywołania spawn do momentu wywołania funkcji.
2. Drugim jest równoważne elapsedTime() lub mniej więcej jak długo silnik działa.

spawn

Natychmiastowo wywołuje funkcję za pośrednictwem harmonogramu silnika, z
ograniczeniem.

Zwraca usługę `Class.Stats`. Preferowane jest, aby deweloperzy używali
`Class.ServiceProvider:GetService()`, aby uzyskać to zamiast tego.

stats

Zwraca, ile czasu upłynęło w sekundach od epoki Unix na
aktualnym komputerze lokalnym. Epoka Unix jest reprezentowana przez
00:00:00 1 stycznia 1970.

`tick()` nie jest oficjalnie przestarzały, ale ma wiele problemów. Może
być niepoprawne o maksymalnie jedną sekundę i zwracać niespójne wyniki w
różnych strefach czasowych i systemach operacyjnych. Użyj `Library.os.time()`,
`Library.os.clock()`, lub `Global.RobloxGlobals.time()` zamiast tego. Zastanów się
również nad `Datatype.DateTime.UnixTimestamp` oraz
`Datatype.DateTime.UnixTimestampMillis`.

tick

Czas, w sekundach, od epoki Unix (1 stycznia 1970)
zgodnie z lokalnym zegarem urządzenia.


Zwraca ilość czasu w sekundach od epoki Unix zgodnie z czasem
tego urządzenia.

Zwraca ilość czasu, w sekundach, która upłynęła od momentu rozpoczęcia
uruchamiania obecnej instancji gry. Jeśli obecna instancja gry nie
jest uruchomiana, to będzie `0`.

Jeśli `Class.Workspace.AuthorityMode` jest `Enum.AuthorityMode.Server`, ta
wartość jest synchronizowana między klientem a serwerem.

time

Czas, w sekundach, od momentu uruchomienia bieżącej instancji gry.


Zwraca ilość czasu w sekundach, która upłynęła od momentu rozpoczęcia
uruchamiania obecnej instancji gry.

Zwraca typ wskazanego obiektu jako ciąg. Ta funkcja jest
dokładniejsza niż wbudowana funkcja `type` Luau, ponieważ nie
oznacza typów specyficznych dla Roblox jako `userdata`.

typeof

object

Typ Luau, którego typ będzie sprawdzany.

Reprezentacja typu obiektu w postaci ciągu, w tym
typy specyficzne dla Roblox, takie jak "Vector3" lub "CFrame".


Zwraca typ danego obiektu jako ciąg, wspierając również
typy specyficzne dla Roblox (np. Vector3).

Zwraca obiekt `Class.UserSettings`, który służy do odczytu
informacji z ustawień menu gry aktualnego użytkownika.

UserSettings

Zwraca obiekt UserSettings, który służy do odczytu informacji z
ustawień menu gry aktualnego użytkownika.

Zwraca aktualną wersję Roblox w postaci ciągu. Liczby całkowite w
ciągu wersji są oddzielone kropkami, a każda liczba przedstawia
następujące, w kolejności:

- Pokolenie - Aktualne pokolenie aplikacji, która
  hostuje klienta.
- Wersja - Aktualna wersja wydania Roblox.
- Poprawka - Aktualny numer poprawki dla tej wersji Roblox.
- Commit - ID ostatniego wewnętrznego commitu, który został zaakceptowany
  do tej wersji klienta.

version

Ciąg wersji oddzielony kropkami w formacie
"generation.version.patch.commit".


Zwraca aktualną wersję Roblox w postaci ciągu, która zawiera
pokolenie, wersję, poprawkę i commit.

Wstrzymuje aktualny wątek, aż upłynie określona ilość sekund.

Opóźnienie ma minimalny czas długości 29 milisekund, ale to
minimum może być wyższe w zależności od docelowej liczby klatek na
sekwencję i różnych warunków ograniczania. Jeśli parametr `seconds`
nie jest określony, użyta zostanie minimalna długość. Ta funkcja zwraca:

- Rzeczywisty czas wstrzymania (w sekundach).
- Całkowity czas od momentu inicjalizacji oprogramowania (w sekundach).

wait

seconds

Określa, jak długo wątek powinien być wstrzymany.

Rzeczywisty czas oczekiwania, w sekundach.


Całkowity czas, który upłynął od momentu uruchomienia silnika, w sekundach.


Wstrzymuje aktualny wątek, aż upłynie określona ilość czasu w sekundach,
z ograniczeniem.

Zachowuje się identycznie jak funkcja print Luau, z wyjątkiem że
wyjście jest stylizowane jako ostrzeżenie, z żółtym tekstem i
znacznikiem czasu. Ta funkcja akceptuje dowolną liczbę argumentów,
i podejmie próbę ich przekształcenia w ciągi, które będą następnie
połączone ze spacjami między nimi.

warn

params

Ta funkcja akceptuje dowolną liczbę argumentów i podejmie próbę
ich przekształcenia w ciągi, które będą następnie połączone
spacjami między nimi.

Zachowuje się podobnie jak print, z wyjątkiem bardziej wyraźnego
formatowania (żółty); przeznaczone do komunikatów opisujących
potencjalne problemy.

Przestarzała funkcja, aby obejść starą ograniczenie harmonogramu
`Global.LuaGlobals.pcall()`; nie powinna być używana do nowej pracy
(użyj `Global.LuaGlobals.pcall()` zamiast tego).

ypcall

Funkcja, która ma być wywoływana w trybie chronionym.

args

Dodatkowe argumenty do przekazania do funkcji.


Czy funkcja została wykonana pomyślnie bez zgłaszania błędu.


Wartości zwracane przez funkcję w przypadku sukcesu lub komunikat o błędzie w
przypadku niepowodzenia.


Przestarzała funkcja, aby obejść starą ograniczenie harmonogramu
`Global.LuaGlobals.pcall()`.

Roblox globals

Odniesienie do typu danych Enums, który przechowuje wszystkie dostępne
enumy, które można używać w Robloxie.

Enum

Odniesienie do `Class.DataModel`, który jest instancją korzenia rodzic/dziecko
hierarchii Roblox.

game

Odnosi się do singletona DataModel, którego instancją korzeń hierarchii
danej.

Demonstruje globalną zmienną `plugin`.


Odwołanie do obiektu `Class.Plugin`, który reprezentuje wtyczkę uruchamianą z tego `Class.Script`. To odwołanie istnieje tylko w kontekście, w którym skrypt jest wykonywany jako wtyczka i nie jest przekazywane do `Class.ModuleScript|ModuleScripts` w ramach wtyczki. Aby użyć tego odwołania w `Class.ModuleScript`, musisz je jawnie przekazać.

plugin

Odnosi się do singletona Plugin, gdy kod jest uruchamiany w kontekście
pluginu Studio.

Tabela, która jest współdzielona między wszystkimi skryptami, które
współdzielą ten sam poziom kontekstu wykonania. To pełni dokładnie tę samą
funkcję co `_G`.

shared

Tabela współdzielona między cały kod uruchamiany na tym samym poziomie
kontekstu wykonania.

Odniesienie do obiektu skryptu, który wykonuje kod, który piszesz. Może
być to albo `Class.Script`, `Class.LocalScript`, albo `Class.ModuleScript`.
Ta zmienna nie jest dostępna podczas wykonywania kodu z paska poleceń
Roblox Studio.

script

Odniesienie do obiektu LuaSourceContainer (Skrypt, Skrypt Lokalny, lub
ModuleScript), który wykonuje ten kod.

Odniesienie do usługi `Class.Workspace`, która zawiera wszystkie fizyczne
elementy świata Roblox.

workspace

Odniesienie do usługi Workspace, która zawiera wszystkie fizyczne
elementy miejsca.

Wbudowane funkcje i stałe unikalne dla Roblox.

/reference/engine/globals/RobloxGlobals.yaml

Luau

{any}

Korzeń hierarchii rodzic-dziecko w Robloxie. Jego bezpośrednimi dziećmi są usługi,  takie jak `Class.Workspace` i `Class.Lighting`, które działają jako podstawowe  komponenty gry Roblox.

Class

DataModel

Punkt dostępu do wszystkich `Datatype.Enum|Enums`.

Data Type

Enums

GlobalSettings

Klasa bazowa dla wszystkich obiektów, które zawierają kod Luau.

LuaSourceContainer

Główny obiekt odpowiedzialny za tworzenie niestandardowych widgetów Studio, pasków narzędzi, przycisków i innych elementów interfejsu użytkownika wtyczek.

Plugin

Przestarzały singleton, który wcześniej był wymagany do tworzenia wtyczek.

Obiekt, który wykonuje połączone funkcje po określonym wystąpieniu.

RBXScriptSignal

Stats

Tuple

Obiekt singleton, który zawiera podstawowe ustawienia użytkownika, które utrzymują się we wszystkich grach na Robloxie.

Variant

`Workspace` przechowuje obiekty 3D, które są renderowane w świecie 3D. Obiekty, które nie pochodzą z niego, nie będą renderowane ani fizycznie oddziaływać ze światem.

Workspace

Typ danych mający wartość prawdziwą lub fałszywą.

boolean

Funkcje to bloki kodu, które mogą być wykonywane wielokrotnie na żądanie.

function

Liczba zmiennoprzecinkowa podwójnej precyzji.

number

Sekwencja znaków, takich jak litery, cyfry i symbole.

string

Projekty

Awatar

Zasoby

Przykłady i projekty

Interfejs API silnika

Otwarty interfejs API

Studio

Analityka

Platforma

Samouczki

Programy dla twórców

Edukacyjne

Edukacja

Uwierzytelnianie za pomocą klucza interfejsu API.

Jest to metoda asynchroniczna, która zwraca deskryptor „Operation”, odpowiadający bieżącemu stanowi operacji. Zawiera punkt końcowy, który można wybrać przy użyciu funkcji poll, aby otrzymać rzeczywistą odpowiedź i nadające się do użycia metadane. Więcej informacji na temat operacji długotrwałych zawiera [dokumentacja]({longRunningOperationsLink}).
            
W poniższych sekcjach opisano odpowiedzi i obiekty w postaci metadanych, które zostają podane po ukończeniu operacji.

Punkty końcowe beta są gotowe do użytku publicznego. Zmiany wywołujące przerwy są możliwe, ale rzadkie.

Te strony dokumentacji Open Cloud zostaną usunięte 31 marca 2026 r. Wtedy nastąpi automatyczne przekierowanie do nowej dokumentacji Open Cloud. {linkStart}Dowiedz się więcej{linkEnd}

Te stare strony dotyczące Open Cloud zostaną usunięte, a użytkownicy zostaną przekierowani 31 marca 2026 r. {linkStart}Dowiedz się więcej{linkEnd}

Eksperymentalne punkty końcowe są gotowe do publicznego użycia, ale mogą czasami ulegać zmianom powodującym niezgodność w miarę finalizowania kontraktu API.

Ten punkt końcowy można wywołać w ramach interfejsu użytkownika za pośrednictwem usługi {httpServiceLinkStart}HttpService{httpServiceLinkEnd} przy użyciu klucza interfejsu API.

To pole może być skonfigurowane podczas tworzenia zasobu, ale może nie być modyfikowane przez kolejne żądania.

Te pola mogą być skonfigurowane podczas tworzenia zasobu, ale nie mogą być modyfikowane przez kolejne żądania.

To pole może być podane w żądaniach, ale nigdy nie będzie uwzględniane w odpowiedziach.

Starsza metoda uwierzytelniania. Zawsze wybieraj klucz interfejsu API lub OAuth 2.0, jeśli są dostępne.

Na klucz API: żądanie {maxInPeriod} co {periodInSeconds} s na adres IP

Nie wymaga uwierzytelnienia do wywołania. Zazwyczaj ma znacznie obniżone limity żądań. Zawsze używaj klucza interfejsu API lub protokołu OAuth 2.0, jeśli są dostępne.

Dla każdego grupowania należy podać tylko jedno z następujących pól w schemacie, pozostałe można wykluczyć.

W każdej chwili możesz ponownie ją włączyć. {linkStart}Prześlij opinię.{linkEnd}

Wyświetlasz starą dokumentację. {linkStart}Prześlij opinię.{linkEnd}

W każdej chwili możesz zrezygnować z tej opcji i powrócić do stron ze starą dokumentacją. {linkStart}Prześlij opinię.{linkEnd}

Wyświetlasz zaktualizowaną dokumentację. {linkStart}Prześlij opinię.{linkEnd}

To pole może być skonfigurowane do użycia w odpowiedziach, ale będzie ignorowane w żądaniach.

Uwaga: limity częstotliwości wysyłania żądań mogą być niższe w okresach dużego ruchu. Niektóre punkty końcowe mają dodatkowe limity częstotliwości wysyłania żądań. [Więcej informacji o limitach częstotliwości wysyłania żądań]({link}).

Liczba żądań na dzień dla wszystkich kluczy interfejsu API na użytkownika lub grupę: {limit}

Liczba żądań na godzinę dla wszystkich kluczy interfejsu API na użytkownika lub grupę: {limit}

Liczba żądań na minutę dla wszystkich kluczy interfejsu API na użytkownika lub grupę: {limit}

Liczba żądań na sekundę dla wszystkich kluczy interfejsu API na użytkownika lub grupę: {limit}

Liczba żądań na minutę na każdego właściciela klucza interfejsu API: {limit}

Liczba żądań na dzień na każdego użytkownika aplikacji: {limit}

Liczba żądań na godzinę na każdego użytkownika aplikacji: {limit}

Liczba żądań na minutę na każdego użytkownika aplikacji: {limit} 

Liczba żądań na sekundę na każdego użytkownika aplikacji: {limit}

Liczba żądań na sekundę na każdego właściciela klucza interfejsu API: {limit}

Zakresy służą do kontroli uprawnień, które przysługują Twoim poświadczeniom. Twoje poświadczenia mogą uzyskiwać dostęp wyłącznie do punktów końcowych, które są obsługiwane przez wybrane przez Ciebie zakresy.

Stabilne punkty końcowe są gotowe do użycia w środowisku produkcyjnym i niemal nigdy nie przechodzą zmian, które mogłyby spowodować niezgodność w trakcie ich działania.

Ten cel pozwala Ci ograniczyć dostęp Twojego klucza do wybranych {requiredParts}

Ten cel pozwala Ci ograniczyć dostęp Twojego klucza do wybranych {requiredParts} i {optionalParts}

Typy celów służą do ograniczania zasobów, do których masz uprawnienia zgodnie ze swoimi danymi dostępu. Działania mogą być podejmowane wyłącznie na wybranych zasobach, nawet jeżeli Twoje konto ma uprawnienia do dodatkowych zasobów. Niektóre zakresy nie mają wskazanych typów celów. W takich przypadkach działania mogą być podejmowane na wszystkich odpowiednich zasobach.

W przypadku kluczy API należących do użytkownika nie trzeba wybierać części najwyższego poziomu uniwersum. W takim przypadku klucz API będzie miał dostęp do wszystkich Twoich środowisk należących do użytkownika i środowisk należących do grupy, do których masz odpowiednie uprawnienia grupowe.

Funkcja „Wypróbuj” nie jest jeszcze obsługiwana w odniesieniu do punktów końcowych wymagających klucza API lub uwierzytelniania OAuth 2.0

Ze względów bezpieczeństwa uwierzytelnianie za pomocą plików cookie jest wyłączone w przypadku operacji o wysokim ryzyku.

Punkty końcowe o krytycznym poziomie ryzyka są niezwykle wrażliwe, dlatego funkcja „Wypróbuj” jest wyłączona ze względów bezpieczeństwa

Uwaga: nagłówki uwierzytelniające nie są uwzględnione w tym przykładzie kodu. Aby to polecenie działało, może być konieczne dodanie nagłówka uwierzytelniającego.

Jest to punkt końcowy o wysokim poziomie ryzyka, który może modyfikować lub usuwać dane krytyczne. Podczas testowania należy zachować szczególną ostrożność.

Ten punkt końcowy API został sklasyfikowany jako WYSOKIE RYZYKO i może mieć wpływ na opublikowane dane lub konta użytkowników.

Uwierzytelnione żądania do interfejsów API wysokiego ryzyka mogą wprowadzać zmiany, których nie da się cofnąć. Przed kontynuowaniem dokładnie sprawdź parametry swojego żądania.

Zaloguj się, aby użyć uwierzytelniania za pomocą plików cookie

Jest to punkt końcowy o niskim poziomie ryzyka, który pobiera dane. Na ogół można go bezpiecznie testować.

Jest to punkt końcowy o średnim poziomie ryzyka, który modyfikuje dane. Testuj ostrożnie przy użyciu kont o niekrytycznym znaczeniu, ponieważ zmiany mogą być trwałe.

Aby zapewnić bezpieczeństwo konta, nigdy nie wklejaj tutaj tekstu z innych źródeł ani nigdzie nie wysyłaj informacji z tej strony.

Za chwilę przetestujesz aktywne punkty końcowe interfejsu API przy użyciu rzeczywistych danych logowania do konta.

Przejdź dalej tylko wtedy, gdy rozumiesz konsekwencje wywołań interfejsu API, które zamierzasz wykonać. Przed rozpoczęciem testów dokładnie zapoznaj się z dokumentacją interfejsu API.

Wywołania interfejsu API będą wykonywane przy użyciu Twojej uwierzytelnionej sesji.

Są to rzeczywiste wywołania interfejsu API, które mogą mieć wpływ na Twoje konto lub dane.

Obowiązują limity w zakresie częstotliwości wykonywania wywołań i inne ograniczenia dotyczące interfejsu API.

Niektóre operacje mogą powodować modyfikację lub usunięcie danych.

Ten punkt końcowy został zastąpiony przez następując polecane punkty końcowe:

Aby wywołać ten punkt końcowy, wymagane są następujące zakresy. Aby uzyskać więcej
informacji na temat generowania odpowiednich kluczy, zobacz [Zarządzaj kluczami API]({apiKeyReferenceDocLink}).

Aby uzyskać więcej informacji na temat generowania kluczy, zobacz [Zarządzaj kluczami API]({apiKeyReferenceDocLink}).

Następujące punkty końcowe są dostępne za pośrednictwem ścieżek odnoszących się do podstawowego adresu URL.

Ten ciąg jest sformatowany jako [FieldMask](/cloud/reference/types#fieldmask).

Wartość JSON może być typu „null”, „boolean”, „string”, „number”, „array” lub „object”.

Do umożliwienia aplikacji OAuth 2.0 użycia tego punktu końcowego wymagane są następujące zakresy. Więcej informacji na temat rejestrowania aplikacji OAuth 2.0 można znaleźć w obszarze [Rejestracja i omówienie aplikacji]({oauth2ReferenceDocLink}).

Aby uzyskać więcej informacji na temat rejestracji aplikacji OAuth 2.0, zobacz [Rejestracja i weryfikacja aplikacji]({oauth2ReferenceDocLink}).

Następujące obiekty opisują ładunki, które są przyjmowane lub zwracane. Więcej informacji na temat tego, kiedy te obiekty są w użyciu, można znaleźć w poszczególnych punktach końcowych.

Podsumowanie