OverlapParams

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.

Loại dữ liệu lưu các tham số để sử dụng với các chức năng truy vấn biên giới , và .Thuộc tính OverlapParams.FilterDescendantsInstances lưu một mảng các đối tượng để sử dụng như là một danh sách bao gồm hoặc loại trừ dựa trên danh sách OverlapParams.FilterType enum, và thuộc tính OverlapParams.CollisionGroup có thể xác định một nhóm va chạm cho hoạt động truy vấn biên giới.

Không giống như hầu hết các loại dữ liệu trong Luau, bạn có thể thay đổi tất cả các thành viên của OverlapParams mà không cần tạo một đối tượng mới, cho phép bạn tái sử dụng cùng một đối tượng lặp lại nhiều lần.

Tóm Tắt

Người Tạo

Thuộc Tính

Phương Pháp

Người Tạo

new

Trả về một đối tượng trống OverlapParams .Không giống như các công trình kiểu dữ liệu khác, công trình này không có bất kỳ tham số nào, do đó bạn nên đặt các thuộc tính của nó phù hợp.

Thuộc Tính

FilterDescendantsInstances

Array

Một loạt các đối tượng mà con cháu của chúng được sử dụng trong việc lọc ứng viên.

FilterType

Enum.RaycastFilterType

Xác định cách mảng OverlapParams.FilterDescendantsInstances được sử dụng, tùy thuộc vào Enum.RaycastFilterType được cung cấp. Mặc định là Enum.RaycastFilterType.Exclude .

MaxParts

number

Số lượng tối đa các bộ phận được trả lại bởi truy vấn. Giá trị mặc định của zero ( 0 ) đại diện cho không có giới hạn.

CollisionGroup

string

Xác định một nhóm va chạm cho hoạt động.Các phần trong nhóm va chạm được đặt thành không va chạm với nhóm này sẽ bị bỏ qua.Nếu thuộc tính này bị bỏ qua, hoạt động cho rằng nhóm va chạm mặc định Default .

RespectCanCollide

boolean

Tính chất này, nếu true , làm cho hoạt động truy vấn biên giới sử dụng giá trị BasePart.CanCollide của một phần bị chồng lấp vì lợi ích của giá trị BasePart.CanQuery của nó khi xác định xem phần đó có được bao gồm trong mảng kết quả truy vấn không gian không.

BruteForceAllSlow

boolean

Khi bật, truy vấn sẽ bỏ qua tất cả các đặc tính va chạm phần và thực hiện kiểm tra bằng lực lượng thô lỗ trên mỗi phần.Điều này sẽ ảnh hưởng tiêu cực đến hiệu suất và không nên được sử dụng trong các trải nghiệm trực tiếp.

Phương Pháp

AddToFilter

()
Ghi Song Song

Vì hiệu quả và đơn giản, phương pháp này là cách ưa thích để thêm các ví dụ vào bộ lọc.Nó có lợi thế bổ sung là nó cho phép FilterDescendantsInstances được cập nhật từ một ngữ cảnh song song.

Tham Số

instances: Instance | Array

Một ví dụ hoặc một mảng chứa các ví dụ để thêm.

Lợi Nhuận

()