Actor

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Ein Actor ist ein Container für Code, der sicher in seinem eigenen Thread aufgeteilt werden kann, mit task.desynchronize(). Es sollte auch die Instanzen enthalten, die von seinen Skripten verwendet werden.

Um mehr darüber zu erfahren, wie mehrere Akteure zur Optimierung der Erfüllungbeitragen, siehe Parallel Luau.

Zusammenfassung

Eigenschaften

Eigenschaften von Model übernommen
  • Plugin-Sicherheit
    Parallel lesen

    Setzt die Detaillierungsstufe auf dem Modell für Erlebnisse mit eingeschaltetem Instanz- Streaming.

  • Steuert das Modell- Streaming-Verhalten auf Models, wenn das Instanz- Streaming aktiviert ist.

  • Parallel lesen

    Der Hauptteil des Model , oder nil wenn nicht explizit festlegen.

  • Nicht repliziert
    Nicht skriptfähig
    Parallel lesen

    Editor-only-Eigenschaft, die verwendet wird, um das Modell um seine Achse zu skalieren. Wenn Sie diese Eigenschaft einstellen, bewegt sich die Skala, als ob Model/ScaleTo auf sie aufgerufen wurde.

  • Nicht repliziert
    Parallel lesen

    Bestimmt, wo sich der Pivot eines Model , der nicht hat, befindet.

Eigenschaften von PVInstance übernommen

Methoden

Methoden von Model übernommen
  • AddPersistentPlayer(playerInstance : Player):void

    Setzt dieses Modell so ein, dass es für den angegebenen Spieler:indauerhaft ist. Model.ModelStreamingMode muss so eingestellt sein, dass PersistentPerPlayer für das Verhalten als Ergebnis der Zugabe geändert wird.

  • Bietet eine Beschreibung eines Volumes, das alle Teile eines Modells enthält.

  • Gibt die Größe der kleinsten Kernkiste zurück, die alle BaseParts in der Model enthält, mit dem Alignment auf die Model.PrimaryPart , wenn es festlegenist.

  • Rückgibt alle Player -Objekte, für die dieses Modell-Objekt persistent ist. Das Verhalten variiert basierend darauf, ob diese Methode aus einem Script oder einem LocalScript aufgerufen wird.

  • Gibt die Skalierung des Modells zurück, die standardmäßig 1 für neu erstellte Modelle beträgt und sich ändern wird, wenn sie über Model/ScaleTo skaliert wird.

  • MoveTo(position : Vector3):void

    Bewegt den PrimaryPart an die angegebene Position. Wenn eine Primärteil nicht angegeben wurde, wird die Wurzelteil des Modells verwendet.

  • RemovePersistentPlayer(playerInstance : Player):void

    Macht dieses Modell für bestimmten Spieler:innicht mehr persistent. Model.ModelStreamingMode muss auf PersistentPerPlayer eingestellt sein, damit das Verhalten als Ergebnis der Entfernung geändert wird.

  • ScaleTo(newScaleFactor : number):void

    Setzt den Skalierungsfaktor des Modells, um die Größe und den Standort aller Nachkommen zuzuschneiden, damit sie diesen Skalierungsfaktor in Relation zu ihren ursprünglichen Größen und Standorten haben, wenn der Skalierungsfaktor 1 war.

  • TranslateBy(delta : Vector3):void

    Verschiebt ein Model durch den angegebenen Vector3 Versatz, wobei die Orientierung des Modells erhalten bleibt. Wenn ein weiterer BasePart oder 2>Class.Terrain2> bereits in der neuen Position existiert, wird das 5>Class.Model5> mit dem überschriebenen 8>Class.Model8> kollidieren.

Methoden von PVInstance übernommen

Eigenschaften

Methoden

BindToMessage

Parallel schreiben

Diese Methode wird verwendet, um einen Luau-Callback an eine Nachricht mit dem angegebenen Thema zu binden. Wenn eine Nachricht gesendet wird (mit SendMessage() ) an das angegebene Thema, wird der angegebene Rückruf in einem seriellen Ausführungs-Kontext aufgerufen.

Mehrere Luau-Callbacks können an einen einzelnen Akteur und sogar an ein einzelnes Nachrichtenthema gebunden sein.

Beachte: Nur die Skripte, die Nachkommen eines Akteurs sind, können auf seine Nachrichten gebunden werden.


local actor = script:GetActor()
-- Drucke eine Nachricht, wenn eine Grußbotschaft an den Akteur gesendet wird
-- dieses skript ist ein nachkommen von.
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parameter

topic: string

Das Thema wird verwendet, um die Art der Nachricht zu identifizieren.

function: function

Rückgaben

Dieses Verbindungsobjekt kann verwendet werden, um die Luau-Rückruf von der Erhaltung von Nachrichten zu trennen.

BindToMessageParallel

Parallel schreiben

Diese Methode wird verwendet, um einen Luau-Callback an eine Nachricht mit dem angegebenen Thema zu binden. Wenn eine Nachricht gesendet wird (mit SendMessage() ) an das angegebene Thema, wird der angegebene Rückruf in einem parallelen Ausführungs-Kontext aufgerufen.

Mehrere Luau-Callbacks können an einen einzelnen Akteur und sogar an ein einzelnes Nachrichtenthema gebunden sein.

Beachte: Nur die Skripte, die Nachkommen eines Akteurs sind, können auf seine Nachrichten gebunden werden.


local actor = script:GetActor()
-- Drucke eine Nachricht, wenn eine Grußbotschaft an den Akteur gesendet wird
-- dieses skript ist ein nachkommen von.
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parameter

topic: string

Das Thema wird verwendet, um die Art der Nachricht zu identifizieren.

function: function

Rückgaben

Dieses Verbindungsobjekt kann verwendet werden, um die Luau-Rückruf von der Erhaltung von Nachrichten zu trennen.

SendMessage

void
Parallel schreiben

Sendet eine Nachricht an einen Akteur. Nachrichten werden asynchron gesendet, sodass der Sender nicht blockiert oder geschaltet herunter, wenn die SendMessage() Methode aufgerufen wird.

Da ein einzelner Actor verschiedene Arten von Nachrichten erhalten kann, wird ein topic-Parameter verwendet, um zwischen verschiedenen Arten von Nachrichten zu unterscheiden.

Siehe BindToMessage() für Details darüber, wie ein Nachricht mit SendMessage() angenommen wird.


-- Nehmen Sie `Actor` an, eine lokale Variable, die auf eine Actor-Instanz verweist
actor:SendMessage("Greeting", "Hello World")

Parameter

topic: string

Der verwendete Thema, um die Nachricht zu identifizieren, die gesendet wird.

message: Tuple

Die Inhalte der Nachricht an den Akteur.


Rückgaben

void

Ereignisse