Actor
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
An Actor jest kontenerem dla kodu, który można bezpiecznie podzielić na własny wątek za pomocą task.desynchronize().Powinien również zawierać instancje używane przez jego skrypty.
Aby dowiedzieć się więcej o wykorzystaniu wielu aktorów do optymalizacji wykonywanieskryptu, zobacz Paralelne Luau.
Podsumowanie
Właściwości
Właściwości odziedziczeni z: ModelUstawia poziom szczegółowości na modelu dla doświadczeń z włączonym strumieniem instancji.
Kontroluje zachowanie przesyłania modelu na Models gdy włączono przesyłanie instancji.
Główna część Model lub nil jeśli nie jest wyraźnie ustawiać.
Własność tylko dla edytora używana do skalowania modelu wokół jego osi. Ustawienie tej właściwości przeniesie skalę tak, jakby Model/ScaleTo została wezwana na niej.
Określa, gdzie znajduje się osiować punkt obrotowy , który nie ma ustawionego zestawu.
Metody
Wiąże powrót Luau z wiadomością z określonym tematem.
Wiąże powrót Luau z wiadomością z określonym tematem.
Wysyła wiadomość do aktora.
Ustawia ten model, aby był trwały dla określonego gracza.Model.ModelStreamingMode musi zostać ustawione na PersistentPerPlayer , aby zachowanie zostało zmienione w wyniku dodania.
Zwraca opis woluminu, który zawiera wszystkie części modelu.
Zwraca rozmiar najmniejszego pudełka ograniczającego, które zawiera wszystkie BaseParts w Model, zgodnie z Model.PrimaryPart, jeśli jest ustawiać.
Zwraca wszystkie obiekty Player , które ten obiekt modelowy jest trwały dla.Zachowanie różni się w zależności od tego, czy metoda ta jest wywoływana z Script lub LocalScript.
Zwraca kanoniczną skalę modelu, która domyślnie wynosi 1 dla nowo utworzonych modeli i zmieni się, gdy zostanie skalowana za pomocą Model/ScaleTo.
Przesuwa PrimaryPart do określonej pozycji. Jeśli nie zaznaczono głównej części, zostanie użyta część korzenna modelu.
Sprawia, że ten model nie jest już trwały dla określonego gracza.Model.ModelStreamingMode musi zostać ustawione na PersistentPerPlayer , aby zachowanie zostało zmienione w wyniku usunięcia.
Ustawia czynnik skali modelu, dostosowując rozmiar i lokalizację wszystkich potomnych instancji tak, aby miały ten czynnik skali w stosunku do ich początkowych rozmiarów i lokalizacji, gdy czynnik skali wynosił 1.
Przesuwa Model przez podany odległość Vector3, zachowując orientację modelu.Jeśli istnieje już inny BasePart lub Terrain w nowej pozycji, wtedy Model pokryje powiedziany obiekt.
Otrzymuje pivot z PVInstance .
Przekształca PVInstance wraz z całym jego potomkiem PVInstances tak, że osie zostaną teraz umieszczone w określonym CFrame .
Właściwości
Metody
BindToMessage
Ta metoda jest używana do wiązania powrotu Luau do wiadomości z określonym tematem.Gdy wiadomość zostanie wysłana (za pomocą SendMessage()) do określonego tematu, wezwany zostanie powyższy zaproponowany callback w kontekście wykonania serialnego.
Wiele powrotów Luau może być przypisane do jednego aktora i nawet do jednego tematu wiadomości.
Uwaga: Tylko skrypty, które są potomkami aktora, mogą wiązać się z jego wiadomościami.
local actor = script:GetActor()
-- Wydrukuj wiadomość, gdy wysłana zostanie wiadomość powitalna do aktora
-- ten skrypt jest potomkiem.
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)
Parametry
Temat używany do identyfikacji rodzaju wiadomość.
Zwroty
Ten obiekt połączenia może być użyty do odłączenia powrotu wezwania Luau od otrzymywania wiadomości.
BindToMessageParallel
Ta metoda jest używana do wiązania powrotu Luau do wiadomości z określonym tematem.Gdy wiadomość zostanie wysłana (za pomocą SendMessage()) do określonego tematu, wezwany zostanie dostarczony powrót w kontekście wykonania równoległego równoległego.
Wiele powrotów Luau może być przypisane do jednego aktora i nawet do jednego tematu wiadomości.
Uwaga: Tylko skrypty, które są potomkami aktora, mogą wiązać się z jego wiadomościami.
local actor = script:GetActor()
-- Wydrukuj wiadomość, gdy wysłana zostanie wiadomość powitalna do aktora
-- ten skrypt jest potomkiem.
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)
Parametry
Temat używany do identyfikacji rodzaju wiadomość.
Zwroty
Ten obiekt połączenia może być użyty do odłączenia powrotu wezwania Luau od otrzymywania wiadomości.
SendMessage
Wysyła wiadomość do aktora. Wiadomości są wysyłane asynchronicznie, więc nadawca nie zablokuje lub nie odda, gdy wezwie metodę SendMessage().
Ponieważ pojedynczy aktor może otrzymywać różne rodzaje wiadomości, używany jest parametr topic, aby odróżnić różne rodzaje wiadomości.
Zobacz BindToMessage() dla szczegółów dotyczących otrzymywania wiadomości wysłanej za pomocą SendMessage() .
Parametry
Temat używany do identyfikacji wysyłanej wiadomości.
Treść wiadomości do wysłania do aktora.