Chiếu tia

Ở cấp độ cơ bản nhất, chiếu tia là hành động gửi ra một tia vô hình từ một điểm Vector3 theo một hướng cụ thể với một chiều dài xác định. Khi tia đã được phát, bạn có thể phát hiện xem tia có va chạm với một BasePart hoặc ô Terrain hay không.

Bạn có thể phát một tia với phương thức WorldRoot:Raycast() (Workspace:Raycast()) từ một nguồn Vector3 theo một hướng Vector3.

Chiếu tia cơ bản
local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.new(0, 0, 0)
local rayDirection = Vector3.new(0, -100, 0)

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

Khi có thể, bạn có thể tính toán một vector hướng không xác định (rayDirection) sử dụng một nguồn và đích đã biết. Điều này rất hữu ích khi phát một tia giữa hai điểm có thể thay đổi, chẳng hạn như từ một nhân vật người chơi sang nhân vật khác.

1. Nguồn cộng với một vector hướng chỉ ra đích của tia:

   $\text{rayOrigin} + \text{rayDirection} = \text{rayDestination}$

2. Trừ $\text{rayOrigin}$ từ cả hai phía của phương trình:

   $\text{rayOrigin} + \text{rayDirection} - \text{rayOrigin} = \text{rayDestination} - \text{rayOrigin}$

3. Hướng của tia bằng đích trừ nguồn:

   $\text{rayDirection} = \text{rayDestination} - \text{rayOrigin}$

local Workspace = game:GetService("Workspace")

local rayOrigin = Workspace.TestOrigin.Position
local rayDestination = Workspace.TestDestination.Position

local rayDirection = rayDestination - rayOrigin

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

Tùy chọn lọc

WorldRoot:Raycast() chấp nhận một đối tượng tùy chọn RaycastParams cho biết raycast có chọn lọc bao gồm hoặc loại trừ các BaseParts nhất định, bỏ qua vật liệu Nước cho Terrain, hoặc sử dụng một nhóm va chạm.

Lọc chiếu tia
local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.zero
local rayDirection = Vector3.new(0, -100, 0)

local raycastParams = RaycastParams.new()
raycastParams.FilterDescendantsInstances = {script.Parent}
raycastParams.FilterType = Enum.RaycastFilterType.Exclude
raycastParams.IgnoreWater = true

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection, raycastParams)

Phát hiện va chạm

Nếu hoạt động chiếu tia va chạm với một BasePart hoặc ô Terrain đủ điều kiện, một đối tượng RaycastResult sẽ được trả về chứa các kết quả. Để kiểm tra một va chạm, xác nhận rằng kết quả không phải là nil và sử dụng các thuộc tính sau khi cần.

Phát hiện va chạm của chiếu tia
local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.zero
local rayDirection = Vector3.new(0, -100, 0)

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

if raycastResult then
	print("Instance:", raycastResult.Instance)
	print("Position:", raycastResult.Position)
	print("Distance:", raycastResult.Distance)
	print("Material:", raycastResult.Material)
	print("Normal:", raycastResult.Normal)
else
	warn("Không có kết quả chiếu tia!")
end