Actor

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

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 .

Resumen

Propiedades

Propiedades heredados 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.

  • Leer paralelo

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

  • No replicado
    No programable
    Leer paralelo

    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 .

  • No replicado
    Leer paralelo

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

Propiedades heredados de PVInstance

Métodos

Métodos heredados 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 heredados de PVInstance

Propiedades

Métodos

BindToMessage

Escribir paralelo

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

Devuelve

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

BindToMessageParallel

Escribir paralelo

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

Devuelve

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

SendMessage

void
Escribir paralelo

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.


Devuelve

void

Eventos