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 código que se puede dividir de forma segura en su propio hilo usando task.desynchronize().También debe contener las instancias utilizadas por sus scripts.

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

Resumen

Propiedades

Propiedades heredados de Model
  • Seguridad del plugin
    Leer paralelo

    Establece el nivel de detalle en el modelo para experiencias con transmisión de instancias habilitada.

  • Controla el comportamiento de transmisión de modelos en Models.

  • Leer paralelo

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

  • No replicado
    No programable
    Leer paralelo

    Propiedad solo del editor utilizada para escalar el modelo alrededor de su pivote. Establecer esta propiedad moverá la escala como si se llamara Model/ScaleTo a ella.

  • No replicado
    Leer paralelo

    Determina dónde se encuentra el eje de un que no tenga un conjunto establecido.

Propiedades heredados de PVInstance

Métodos

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

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

  • Devuelve una descripción de un volumen que contiene todas las partes de un modelo.

  • Devuelve el tamaño de la caja de contención más pequeña que contiene todo el BaseParts en el Model, alineada con el Model.PrimaryPart si se establecer.

  • Devuelve todos los objetos Player que este objeto de modelo es persistente para.El comportamiento varía según si este método se llama desde un Script o un LocalScript.

  • Devuelve la escala canónica 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):()

    Mueve el PrimaryPart a la posición dada. Si no se ha especificado una parte principal, se usará la parte raíz del modelo.

  • RemovePersistentPlayer(playerInstance : Player):()

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

  • ScaleTo(newScaleFactor : number):()

    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):()

    Cambia un Model por el desplazamiento dado Vector3, preservando la orientación del aplicación de modelado.Si otro BasePart o Terrain ya existe en la nueva posición, entonces el Model se superpondrá al objeto dicho.

Métodos heredados de PVInstance

Propiedades

Métodos

BindToMessage

Escribir paralelo

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

Múltiples llamadas de devolución de Luau pueden estar vinculadas a un solo actor e incluso a un solo 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 utilizado para identificar el tipo de mensaje.

Valor predeterminado: ""
function: function
Valor predeterminado: ""

Devuelve

Este objeto de conexión se puede usar para desconectar la llamada de devolución de Luau de recibir mensajes.

BindToMessageParallel

Escribir paralelo

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

Múltiples llamadas de devolución de Luau pueden estar vinculadas a un solo actor e incluso a un solo 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 utilizado para identificar el tipo de mensaje.

Valor predeterminado: ""
function: function
Valor predeterminado: ""

Devuelve

Este objeto de conexión se puede usar para desconectar la llamada de devolución de Luau de recibir mensajes.

SendMessage

()
Escribir paralelo

Envía un mensaje a un actor. Los mensajes se envían de forma asincrónica, por lo que el remitente no bloqueará o cederá cuando llame al método SendMessage().

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

Vea BindToMessage() para 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 utilizado para identificar el mensaje que se adpo

Valor predeterminado: ""
message: Tuple

El contenido del mensaje para enviar al actor.

Valor predeterminado: ""

Devuelve

()

Eventos