Actor

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Un Actor è un container per il codice che può essere diviso in sicurezza nel proprio thread utilizzando task.desynchronize().Dovrebbe anche contenere le istanze utilizzate dai suoi script.

Per saperne di più sull'utilizzo di più attori per ottimizzare le Prestazionedello script, vedi Parallel Luau.

Sommario

Proprietà

Proprietà provenienti da Model
  • Sicurezza Plugin
    Lettura Parallela

    Imposta il livello di dettaglio sul modello per le esperienze con streaming di istanza abilitato.

  • Controlla il comportamento di streaming del modello su Models quando l' streaming delle istanze è abilitato.

  • Lettura Parallela

    La parte principale del Model , o nil se non esplicitamente Impostare.

  • Non Replicato
    Non programmabile
    Lettura Parallela

    Proprietà utilizzata solo dall'editor per ridimensionare il modello attorno al suo asse. Impostare questa proprietà sposterà la scala come se Model/ScaleTo fosse stata chiamata su di essa.

  • Non Replicato
    Lettura Parallela

    Determina dove si trova il punto di rotazione di un che non ha un set è situato.

Proprietà provenienti da PVInstance

Metodi

Metodi provenienti da Model
  • AddPersistentPlayer(playerInstance : Player):()

    Imposta questo modello per essere persistente per il Giocatorespecificato.Model.ModelStreamingMode deve essere impostato su PersistentPerPlayer perché il comportamento venga modificato come risultato dell'aggiunta.

  • Restituisce una descrizione di un volume che contiene tutte le parti di un modello.

  • Restituisce la dimensione della più piccola scatola di confine che contiene tutto il BaseParts in Model, allineata con la Model.PrimaryPart se è Impostare.

  • Restituisce tutti gli oggetti Player che questo oggetto modello è persistente per.Il comportamento varia a seconda se questo metodo viene chiamato da un Script o da un LocalScript.

  • Restituisce la scala canonica del modello, che predefinisce 1 per i modelli appena creati e cambierà come viene scala tramite Model/ScaleTo .

  • MoveTo(position : Vector3):()

    Sposta il PrimaryPart a la posizione data. Se una parte primaria non è stata specificata, verrà utilizzata la parte radice del modello.

  • RemovePersistentPlayer(playerInstance : Player):()

    Rende questo modello non più persistente per il Giocatorespecificato.Model.ModelStreamingMode deve essere impostato su PersistentPerPlayer perché il comportamento venga modificato come risultato della rimozione.

  • ScaleTo(newScaleFactor : number):()

    Imposta il fattore di ridimensionamento del modello, regolando la dimensione e la posizione di tutte le istanze discendenti in modo che abbiano quel fattore di ridimensionamento rispetto alle loro dimensioni iniziali e alla posizione quando il fattore di ridimensionamento era 1.

  • TranslateBy(delta : Vector3):()

    Sposta un Model con lo Dislocamentodato Vector3 , preservando l'orientamento del modello.Se un altro BasePart o Terrain esiste già nella nuova posizione allora il Model sovrapporrà l'oggetto dichiarato.

Metodi provenienti da PVInstance

Proprietà

Metodi

BindToMessage

Scrivi Parallelo

Questo metodo viene utilizzato per associare una richiamata Luau a un messaggio con l'argomento specificato.Quando viene inviato un messaggio (utilizzando SendMessage() ) al topic specificato verrà chiamato in un contesto di esecuzione seriale seriale.

Può essere legato a più richiami Luau a un singolo attore e persino a un singolo argomento di messaggio.

Nota: solo gli script che sono discendenti di un Attore possono legarsi ai suoi messaggi.


local actor = script:GetActor()
-- Stampa un messaggio quando viene inviato un messaggio di saluto all'Attore
-- questo script è un discendente di.
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parametri

topic: string

L'argomento utilizzato per identificare il tipo di Messaggio.

Valore predefinito: ""
function: function
Valore predefinito: ""

Restituzioni

Questo oggetto di connessione può essere utilizzato per disconnettere la richiamata Luau dalla ricezione di messaggi.

BindToMessageParallel

Scrivi Parallelo

Questo metodo viene utilizzato per associare una richiamata Luau a un messaggio con l'argomento specificato.Quando viene inviato un messaggio (utilizzando SendMessage() ) al topic specificato verrà chiamato in un contesto di esecuzione parallela parallel.

Può essere legato a più richiami Luau a un singolo attore e persino a un singolo argomento di messaggio.

Nota: solo gli script che sono discendenti di un Attore possono legarsi ai suoi messaggi.


local actor = script:GetActor()
-- Stampa un messaggio quando viene inviato un messaggio di saluto all'Attore
-- questo script è un discendente di.
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parametri

topic: string

L'argomento utilizzato per identificare il tipo di Messaggio.

Valore predefinito: ""
function: function
Valore predefinito: ""

Restituzioni

Questo oggetto di connessione può essere utilizzato per disconnettere la richiamata Luau dalla ricezione di messaggi.

SendMessage

()
Scrivi Parallelo

Invia un messaggio a un attore. I messaggi vengono inviati in modo asincronico, quindi il mittente non bloccherà o cederà quando chiamerà il metodo SendMessage().

Poiché un singolo attore può ricevere diversi tipi di messaggi, un parametro topic viene utilizzato per distinguere tra diversi tipi di messaggi.

Vedi BindToMessage() per i dettagli sulla ricezione di un messaggio inviato utilizzando SendMessage() .


-- Supponiamo che `actor` sia una variabile locale che si riferisce a un'esempioActor
actor:SendMessage("Greeting", "Hello World")

Parametri

topic: string

L'argomento utilizzato per identificare il messaggio in Sentenza

Valore predefinito: ""
message: Tuple

Il contenuto del messaggio da inviare all'Attore.

Valore predefinito: ""

Restituzioni

()

Eventi