Actor

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Un Actor es un contenedor para el código que se puede dividir con seguridad en sus propios hilos usando task.desynchronize() . También debe contener las instancias usadas por sus scripts.

Para aprender más sobre el uso de múltiples actores para optimizar el ejecucióndel script, see Luau Paralelo .

Resumo

Propriedades

Propriedades herdados de Model
  • Establece el nivel de detalle en el modelo para las experiencias con transmisión de instancia habilitada.

  • Controla el comportamiento de streaming del modelo en Models cuando se habilita el streaming de instancia.

  • Ler Parallel

    La parte principal de Model , o nil si no se establecerexplícitamente.

  • Não replicado
    Não scriptável
    Ler Parallel

    Propiedad de Editor únicamente usada para escalar el modelo alrededor de su eje. Al configurar esta propiedad, se moverá la escala como si se hubiera llamado a Model/ScaleTo .

  • Não replicado
    Ler Parallel

    Determina dónde se encuentra el eje de un Model que no tiene Class.Model.PrimaryPart establecido.

Propriedades herdados de PVInstance

Métodos

Métodos herdados de Model
  • AddPersistentPlayer(playerInstance : Player):void

    Establece este modelo para ser persistente para el jugador especificado. Model.ModelStreamingMode debe establecerse en PersistentPerPlayer para que el comportamiento se cambie como resultado de la adición.

  • Restaura una descripción de un volumen que contiene todas las partes de un Modelo.

  • Restablece el tamaño de la caja de contorno más pequeña que contiene todos los BaseParts en el Model, alineado con el Model.PrimaryPart si se establecer.

  • Devuelve todos los objetos Player que son persistentes para este objeto de modelo. El comportamiento varía según sea que se llame a este método desde un Script o un LocalScript .

  • Devuelve la escala de canon del aplicación de modelado, que se establece por defecto en 1 para los modelos recién creados y cambiará a medida que se escala a través de Model/ScaleTo .

  • MoveTo(position : Vector3):void

    Mueve el PrimaryPart a la posición especificada. Si no se ha especificado una parte primaria, se utilizará la parte raíz del modelo.

  • RemovePersistentPlayer(playerInstance : Player):void

    Este modelo ya no es persistente para el jugador especificado. Model.ModelStreamingMode debe establecerse en PersistentPerPlayer para que el comportamiento cambie como resultado de la eliminación.

  • ScaleTo(newScaleFactor : number):void

    Establece el factor de escala del aplicación de modelado, ajustando el tamaño y la ubicación de todas las instancias descendientes para que tengan ese factor de escala en relación con sus tamaños y ubicaciones iniciales cuando el factor de escala era 1.

  • TranslateBy(delta : Vector3):void

    Sin objetodisponible.

Métodos herdados de PVInstance

Propriedades

Métodos

BindToMessage

Escrever Parallel

Este método se usa para vincular un llamado de Luau a un mensaje con el tema especificado. Cuando se envía un mensaje (usando SendMessage() ) al tema especificado, se llamará en un contexto de ejecución serial.

Múltiples llamadas de Luau pueden vincularse a un solo actor e incluso a un tema de mensaje.

Nota: Solo los scripts que son descendientes de un Actor pueden vincularse a sus mensajes.


local actor = script:GetActor()
-- Imprimir un mensaje cuando se envía un mensaje de saludo al Actor
-- este script es un descendiente de.
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parâmetros

topic: string

El tema se usa para identificar el tipo de mensaje.

function: function

Devolução

Este objeto de conexión se puede usar para desconectar el mensaje de llamada de Luau.

BindToMessageParallel

Escrever Parallel

Este método se usa para vincular un llamado de Luau a un mensaje con el tema especificado. Cuando se envía un mensaje (usando SendMessage() ) al tema especificado, se llamará en un contexto de ejecución paralelo.

Múltiples llamadas de Luau pueden vincularse a un solo actor e incluso a un tema de mensaje.

Nota: Solo los scripts que son descendientes de un Actor pueden vincularse a sus mensajes.


local actor = script:GetActor()
-- Imprimir un mensaje cuando se envía un mensaje de saludo al Actor
-- este script es un descendiente de.
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parâmetros

topic: string

El tema se usa para identificar el tipo de mensaje.

function: function

Devolução

Este objeto de conexión se puede usar para desconectar el mensaje de llamada de Luau.

SendMessage

void
Escrever Parallel

Envía un mensaje a un Actor. Los mensajes se envían asincronamente, por lo que el remitente no bloqueará o se rendirá cuando se llame el método SendMessage() .

Dado que un solo Actor puede recibir diferentes tipos de mensajes, se utiliza un parámetro topic para distinguir entre diferentes tipos de mensajes.

Vea BindToMessage() para obtener detalles sobre la recepción de un mensaje enviado usando SendMessage() .


-- Suponga que `actor` es una variable local que se refiere a una instancia de Actor
actor:SendMessage("Greeting", "Hello World")

Parâmetros

topic: string

El tema se usa para identificar el mensaje que se adpo

message: Tuple

El contenido del mensaje para enviar al Actor.


Devolução

void

Eventos