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 thùng chứa cho mã có thể được chia an toàn thành luồng riêng của nó bằng cách sử dụng task.desynchronize() .Nó cũng nên chứa các ví dụ được sử dụng bởi các kịch bản của nó.

Để tìm hiểu thêm về việc sử dụng nhiều diễn viên để tối ưu hóa hiệu hiệu lựccủa kịch bản, xem Luau song song.

Tóm Tắt

Thuộc Tính

Thuộc Tính kế thừa từ Model
  • LevelOfDetail:Enum.ModelLevelOfDetail
    Bảo Mật Plugin
    Đọc Song Song

    Đặt cấp độ chi tiết trên mô hình cho các trải nghiệm có bật phát trực tiếp cơ sở dữ liệu.

  • ModelStreamingMode:Enum.ModelStreamingMode
    Đọc Song Song

    Kiểm soát hành vi phát trực tiếp mô hình trên Models khi bật phát trực tiếp instancia.

  • PrimaryPart:BasePart
    Đọc Song Song

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

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

    Tính năng chỉ dành cho biên tập viên được sử dụng để mở rộng mô hình xung quanh trục của nó. Việc đặt tính năng này sẽ di chuyển quy mô như thể Model/ScaleTo đã được gọi trên nó.

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

    Xác định nơi mà trục của một Model mà không có không có một bộ Model.PrimaryPart nằm.

Thuộc Tính kế thừa từ PVInstance
  • Origin:CFrame
    Không Sao Chép
    Không Thể Viết Kịch Bản
    Đọc Song Song
  • Pivot Offset:CFrame
    Không Sao Chép
    Không Thể Viết Kịch Bản
    Đọc Song Song
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Phương Pháp

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

    Đặt mô hình này là vĩnh viễn cho người chơi được chỉ định.Model.ModelStreamingMode phải được đặt thành PersistentPerPlayer để hành vi được thay đổi là kết quả của việc thêm.

  • GetBoundingBox():Tuple

    Trả về một mô tả về một khối lượng chứa tất cả các phần của một mô hình.

  • GetExtentsSize():Vector3

    Trả về kích thước của hộp gắn kết nhỏ nhất chứa tất cả các BaseParts trong Model, cùng với Model.PrimaryPart nếu nó được cài đặt.

  • GetPersistentPlayers():Instances

    Trả lại tất cả các đối tượng Player được vật phẩm mô hình này lưu trữ.Hành vi thay đổi tùy thuộc vào việc phương pháp này được gọi từ một Script hoặc một LocalScript .

  • GetScale():number

    Trả về thước đo chính thống của mô hình, mặc định là 1 cho các mô hình được tạo mới và sẽ thay đổi khi nó được thu nhỏ qua Model/ScaleTo .

  • MoveTo(position : Vector3):()

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

  • RemovePersistentPlayer(playerInstance : Player):()

    Làm cho mô hình này không còn lưu trữ cho người chơi được chỉ định.Model.ModelStreamingMode phải được đặt thành PersistentPerPlayer để hành vi được thay đổi là kết quả của việc loại bỏ.

  • ScaleTo(newScaleFactor : number):()

    Đặt 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 Instances con cháu sao cho có yếu tố thước đo tương đối với kích thước và vị trí ban đầu của chúng khi yếu tố thước đo là 1.

  • TranslateBy(delta : Vector3):()

    Thay đổi một Model bởi độ trừ Vector3 cho được, giữ nguyên hướng của mô hình.Nếu một BasePart hoặc Terrain đã tồn tại ở vị trí mới thì Model sẽ chồng lên đối tượng đã nói.

Phương Pháp kế thừa từ PVInstance
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Thuộc Tính

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Phương Pháp

BindToMessage

RBXScriptConnection
Ghi Song Song

Phương pháp này được sử dụng để gắn một cuộc gọi lại Luau vào một tin nhắn với chủ đề được định.Khi một tin nhắn được gửi (sử dụng SendMessage() ) đến chủ đề được chỉ định, cuộc gọi trả lại được cung cấp sẽ được gọi trong bối cảnh thực thi serial.

Nhiều cuộc gọi trả lại Luau có thể được gắn vào một diễn viên duy nhất và thậm chí cả một chủ đề tin nhắn duy nhất.

Lưu ý: Chỉ các kịch bản là con cháu của một Actor có thể gắn kết với các tin nhắn của nó.

local actor = script:GetActor()



-- In ra một tin nhắn khi tin nhắn chào được gửi đến Actor

-- 脚本 này là con cháu 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 tin nhắn.

Giá Trị Mặc Định: ""
function: function
Giá Trị Mặc Định: ""

Lợi Nhuận

RBXScriptConnection

Đối tượng kết nối này có thể được sử dụng để ngắt kết nối cuộc gọi trả lời Luau từ việc nhận tin nhắn.

BindToMessageParallel

RBXScriptConnection
Ghi Song Song

Phương pháp này được sử dụng để gắn một cuộc gọi lại Luau vào một tin nhắn với chủ đề được định.Khi một tin nhắn được gửi (sử dụng SendMessage() ) đến chủ đề được chỉ định, cuộc gọi trả lại được cung cấp sẽ được gọi trong bối cảnh thực thi song song **.

Nhiều cuộc gọi trả lại Luau có thể được gắn vào một diễn viên duy nhất và thậm chí cả một chủ đề tin nhắn duy nhất.

Lưu ý: Chỉ các kịch bản là con cháu của một Actor có thể gắn kết với các tin nhắn của nó.

local actor = script:GetActor()



-- In ra một tin nhắn khi tin nhắn chào được gửi đến Actor

-- 脚本 này là con cháu 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 tin nhắn.

Giá Trị Mặc Định: ""
function: function
Giá Trị Mặc Định: ""

Lợi Nhuận

RBXScriptConnection

Đối tượng kết nối này có thể được sử dụng để ngắt kết nối cuộc gọi trả lời Luau từ việc nhận tin nhắn.

SendMessage

()
Ghi Song Song

Gửi một tin nhắn cho một Nhân vật. Các tin nhắn được gửi theo cách không đồng bộ, vì vậy người gửi sẽ không bị kẹt hoặc chia sẻ khi gọi phương pháp SendMessage().

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

Xem BindToMessage() để có chi tiết về việc nhận một tin nhắn được gửi bằng SendMessage() .

-- Giả sử `actor` là một biến địa phương tham chiếu đến một ví ví dụ / trường hợpActor

actor:SendMessage("Greeting", "Hello World")

Tham Số

topic: string

Chủ đề được sử dụng để xác định tin nhắn được khoản

Giá Trị Mặc Định: ""
message: Tuple

Nội dung của tin nhắn để gửi cho Actor.

Giá Trị Mặc Định: ""

Lợi Nhuận

()
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Sự Kiện

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object