Actor

Hiển Thị Bản Đã Lỗi Thời

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Một Actor là một container cho mã có thể được chia thành các sub-tid của riêng nó bằng cách sử dụng task.desynchronize() . Nó cũng nên chứa các instace được sử dụng bởi các script của nó.

Để tìm hiểu thêm về việc sử dụng nhiều Actor để tối ưu hiệu hiệu lựcscript, xem Luau song song .

Tóm Tắt

Thuộc Tính

Thuộc Tính kế thừa từ Model
  • Đặt cấp độ chi tiết trên mô hình cho các trải nghiệm có hỗ trợ dòng chảy trên tài nguyên.

  • Xác định hành vi phát sóng mô hình trên Models khi mô hình phát sóng được bật.

  • Đọc Song Song

    Phần chính của Model , hoặc nil nếu không được cài đặtmột cách rõ ràng.

  • Không Sao Chép
    Không Thể Viết Kịch Bản
    Đọc Song Song

    Đối tượng chỉnh sửa được sử dụng để thay đổi kích thước mô hình xung quanh cầu nối của nó. Việc cài đặt đối tượng này sẽ di chuyển kích thước như thể Model/ScaleTo đã được gọi trên nó.

  • Không Sao Chép
    Đọc Song Song

    Xác định vị trí pivot của một Model có pivot không có set Model.PrimaryPart được đặt.

Thuộc Tính kế thừa từ PVInstance
  • Không Sao Chép
    Không Thể Viết Kịch Bản
    Đọc Song Song
  • Không Sao Chép
    Không Thể Viết Kịch Bản
    Đọc Song Song

Phương Pháp

Phương Pháp kế thừa từ Model
  • AddPersistentPlayer(playerInstance : Player):void

    Đặt mô hình này để trở nên bền vững cho người chơi được chỉ định. Model.ModelStreamingMode phải được đặt để PersistentPerPlayer để hành động được thay đổi khi kết hợp với nhau.

  • Trả lại một mô tả của một khối lượng có chứa tất cả các bộ phận của một Mô hình.

  • Trả lại kích thước của chiếc hộp giới hạn nhỏ nhất mà chứa tất cả các BaseParts trong Model, bên cạnh với Model.PrimaryPart nếu nó được cài đặt.

  • Điều tra tất cả các Player đối tượng mà đối tượng này được duy trì cho. Hành vi biến đổi dựa trênWhether this method is called from a Script or a LocalScript .

  • Trả lại kích thước tham chiếu của mô hình, mặc định là 1 cho những mô hình mới tạo và sẽ thay đổi khi nó được thiết lập thông qua Model/ScaleTo .

  • MoveTo(position : Vector3):void

    Di chuyển PrimaryPart đến vị trí đã định. Nếu một phần chính chưa được xác định, phần chính của model sẽ được sử dụng.

  • RemovePersistentPlayer(playerInstance : Player):void

    Làm cho mô hình này không còn bền vững cho người chơi được chỉ định. Model.ModelStreamingMode phải được cài đặt thành PersistentPerPlayer để hành động này được thay đổi khi kết thúc.

  • ScaleTo(newScaleFactor : number):void

    Điều chỉnh yếu tố thước đo của mô hình, điều chỉnh kích thước và vị trí của tất cả các Instance con cháu của mô hình để có được yếu tố thước đo tương ứng với kích thước và vị trí ban đầu của mô hình khi yếu tố thước đo được 1.

  • TranslateBy(delta : Vector3):void

    Đổi một Model bằng cách đưa ra một Vector3 Offset, giữ gìn hướng của mô hình. Nếu một BasePart hoặc 1> Class.Terrain1> đã tồn tại ở vị trí mới thì

Phương Pháp kế thừa từ PVInstance

Thuộc Tính

Phương Pháp

BindToMessage

Ghi Song Song

Phương thức này được sử dụng để liên kết một hành động gọi điện thoại Luau với một tin nhắn với chủ đề được xác định. Khi một tin nhắn được gửi (sử dụng SendMessage() ) đến chủ đề được cung cấp, hành động này sẽ

Nhiều hồi gọi Luau có thể được kết nối với một singin người dùng duy nhất và thậm chí là một chủ đề thông điệp duy nhất.

Ghi chú: Chỉ các script là con của một Actor mới có thể kết nối với các thông điệp của nó.


local actor = script:GetActor()
-- In một thông điệp khi một thông điệp chào mừng được gửi cho Actor
-- chủ đề này là một con của.
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Tham Số

topic: string

Chủ đề được sử dụng để xác định loại thông tin nhắn.

function: function

Lợi Nhuận

Đối tượng kết nối này có thể được sử dụng để kết nối lại Luau callback khi nhận các thông điệp.

BindToMessageParallel

Ghi Song Song

Phương thức này được sử dụng để liên kết một hành động gọi điện thoại Luau với một tin nhắn với chủ đề được xác định. Khi một tin nhắn được gửi (sử dụng SendMessage() ) đến chủ đề được cung cấp, hành động gọi đi

Nhiều hồi gọi Luau có thể được kết nối với một singin người dùng duy nhất và thậm chí là một chủ đề thông điệp duy nhất.

Ghi chú: Chỉ các script là con của một Actor mới có thể kết nối với các thông điệp của nó.


local actor = script:GetActor()
-- In một thông điệp khi một thông điệp chào mừng được gửi cho Actor
-- chủ đề này là một con của.
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Tham Số

topic: string

Chủ đề được sử dụng để xác định loại thông tin nhắn.

function: function

Lợi Nhuận

Đối tượng kết nối này có thể được sử dụng để kết nối lại Luau callback khi nhận các thông điệp.

SendMessage

void
Ghi Song Song

Gửi một thông điện cho một Actor. Tin nhắn được gửi theo cách asynchronous, vì vậy người gửi sẽ không bị chặn hoặc tạo ra khi gọi phương thức SendMessage() .

Vì một Actor có thể nhận các loại tin nhắn khác nhau, một top parameter được sử dụng để phân biệt giữa các loại tin nhắn khác nhau.

Xem BindToMessage() để biết chi tiết về cách nhận một tin nhắn được gửi bằng cách sử dụng SendMessage() .


-- Đoán `actor` là biến địa phương đến một ví dụ / trường hợpActor
actor:SendMessage("Greeting", "Hello World")

Tham Số

topic: string

Chủ đề được sử dụng để xác định thông điệp đang được khoản

message: Tuple

Nội dung của thông điệp để gửi cho Actor.


Lợi Nhuận

void

Sự Kiện