一個 Actor 是可以使用 task.desynchronize() 安全分割為自己線程的代碼容器。它也應包含使用其腳本的實例。
要了解更多關於使用多個演員來最佳化腳本履約的信息,請參閱並行 Luau。
概要
屬性
屬性 繼承自 Model為啟用實例傳輸的體驗設置模型的細節程度。
在啟用實例傳輸時,控制模型傳輸行為在 Models 上。
Model 的主要部分,或 nil 如果未明確設設定。
僅用於編輯器的屬性,用於擴展模型周圍的旋轉點。設置此屬性會將比例移至如果 Model/ScaleTo 被呼叫在它上面。
決定哪裡是 不具有設置的 軸心所在的地方。
方法
將 Luau 回呼绑定到指定主題的訊息。
將 Luau 回呼绑定到指定主題的訊息。
向演員發送消息。
將此模型設為指定玩家的持久模型。Model.ModelStreamingMode必須設為 永久每個玩家 以便行為在添加後發生變更。
返回包含模型所有部分的卷的說明。
返回包含所有 BaseParts 在 Model 中最小綁定箱的尺寸,並與 Model.PrimaryPart 一起對齊,如果已設定。
返回此模型對象持有的所有 Player 對象。行為取決於此方法是否從 Script 或 LocalScript 中呼叫。
返回模型的正常比例,預設為新建模型的 1,並且在通過 Model/ScaleTo 縮放時會變更。
將 PrimaryPart 移動到指定位置。如果未指定主要零件,將使用模型的根部分。
使此模型對指定玩家不再持久。Model.ModelStreamingMode必須設為 永久每個玩家 以便在移除後變更行為。
設置模型的縮放因子,調整所有子模塊的大小和位置,使其具有與初始大小和位置相關的縮放因子,當縮放因子為 1 時。
以給定的 Model 偏移值移動 Vector3 ,保留模型的方向。如果另一個 BasePart 或 Terrain 已在新位置存在,那麼 Model 將覆蓋該對物件。
獲得 PVInstance 的軸心。
將 以及所有其子孫 轉換為指定的 位置,使旋轉點現在位於指定的 位置。
屬性
方法
BindToMessage
這個方法用於將 Luau 回呼綁定到指定主題的訊息。當傳送訊息 (使用 SendMessage() ) 到指定主題時,提供的回呼將在 串行執行上下文 中被呼叫。
多個 Luau 回呼可以綁定到單一演員甚至單一訊息主題。
注意:只有屬於演員的子孫的腳本才能綁定到其訊息。
local actor = script:GetActor()
-- 當歡迎訊息傳送給演員時,列印一則訊息
-- 這個腳本是一個後裔。
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)
參數
返回
此連線對象可用於將 Luau 回呼從接收訊息中斷。
BindToMessageParallel
這個方法用於將 Luau 回呼綁定到指定主題的訊息。當傳送訊息 (使用 ) 到指定主題時,提供的回呼將在並行執行上下文中呼叫。
多個 Luau 回呼可以綁定到單一演員甚至單一訊息主題。
注意:只有屬於演員的子孫的腳本才能綁定到其訊息。
local actor = script:GetActor()
-- 當歡迎訊息傳送給演員時,列印一則訊息
-- 這個腳本是一個後裔。
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)
參數
返回
此連線對象可用於將 Luau 回呼從接收訊息中斷。
SendMessage
向演員發送消息。消息以異步方式傳送,因此發送者在呼叫 SendMessage() 方法時不會阻塞或交換。
單個演員可能會收到不同類型的訊息,因此使用 topic 參數來區分不同類型的訊息。
請參閱 BindToMessage() 收到使用 SendMessage() 傳送的訊息的詳情。
-- 假設 `actor` 是指向一個 Actor 實個體、實例的本地變量actor:SendMessage("Greeting", "Hello World")