Actor

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

一个 Actor 是可以使用 task.desynchronize() 安全分割为自己线程的代码容器。它还应包含使用其脚本的实例。

了解有关使用多个参与者优化脚本性能的更多信息,请参阅并行 Luau

概要

属性

继承自Model属性继承自PVInstance属性

方法

继承自Model方法继承自PVInstance方法
  • 写入并联

    获取 PVInstance 的枢轴。

  • PivotTo(targetCFrame : CFrame):()

    将 以及所有其子孙 转换为位于指定 的位置,使旋转点现在位于指定的 。

属性

方法

BindToMessage

写入并联

这个方法用于将 Luau 回调绑定到指定主题的消息。当消息发送到指定的主题时(使用 ),提供的回调将在 串行执行上下文中调用。

多个 Luau 回调可以绑定到单个演员甚至单个消息主题。

注意:只有演员的子脚本才能绑定到其消息。


local actor = script:GetActor()
-- 当欢迎消息发送到演员时打印出一条消息
-- 该脚本是后裔。
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)

参数

topic: string

用于识别消信息类型的主题。

默认值:""
function: function
默认值:""

返回

这个连接对象可以用来解除 Luau 回调接收消息的连接。

BindToMessageParallel

写入并联

这个方法用于将 Luau 回调绑定到指定主题的消息。当消息发送到指定的主题时(使用 ),提供的回调将在并行执行上下文中调用。

多个 Luau 回调可以绑定到单个演员甚至单个消息主题。

注意:只有演员的子脚本才能绑定到其消息。


local actor = script:GetActor()
-- 当欢迎消息发送到演员时打印出一条消息
-- 该脚本是后裔。
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)

参数

topic: string

用于识别消信息类型的主题。

默认值:""
function: function
默认值:""

返回

这个连接对象可以用来解除 Luau 回调接收消息的连接。

SendMessage

()
写入并联

向演员发送消息。消息以异步方式发送,因此发送者在调用 SendMessage() 方法时不会阻塞或释放。

由于单个 actor 可以接收不同类型的消息,因此使用 topic 参数来区分不同类型的消息。

BindToMessage() 收到使用 SendMessage() 发送的消息的详细信息。


-- 假设 `actor` 是指向 Actor 实例的本地变量
actor:SendMessage("Greeting", "Hello World")

参数

topic: string

用于识别发送的消息的主题。

默认值:""
message: Tuple

要发送给演员的消息的内容。

默认值:""

返回

()

活动