การเรย์แคสต์

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

ที่ระดับพื้นฐานที่สุด, การเรย์แคสต์ คือการส่งออกเรย์ที่มองไม่เห็นจากจุด Vector3 ในทิศทางเฉพาะด้วยความยาวที่กำหนด เมื่อได้ทำการเรย์แล้ว, คุณสามารถตรวจสอบได้ว่าเรย์ชนกับ BasePart หรือ Terrain เซลล์หรือไม่

เลเซอร์ถูกยิงโดยลูกบอลลอย และการเรย์แคสต์จะกำหนดว่าเลเซอร์ชนกับแพลตฟอร์มหรือไม่ แพลตฟอร์มที่ถูกเลเซอร์สัมผัสจะถูกทำลายชั่วคราว

คุณสามารถเรย์แคสต์ด้วยวิธี WorldRoot:Raycast() (Workspace:Raycast()) จากต้นกำเนิด Vector3 ในทิศทาง Vector3

การเรย์แคสต์พื้นฐาน

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)

เมื่อทำการเรย์แคสต์, พารามิเตอร์ทิศทางควรรวมความยาวที่ต้องการของเรย์ด้วย ตัวอย่างเช่น, หากขนาดของทิศทางคือ 10, เรย์ที่ได้จะมีความยาว 10 เช่นกัน ความยาวสูงสุดคือ 15,000 สตัด

เมื่อจำเป็น, คุณสามารถคำนวณเวกเตอร์ทิศทางที่ไม่รู้จัก (rayDirection) โดยใช้ ต้นกำเนิด และ จุดหมาย ที่ทราบไว้ สิ่งนี้มีประโยชน์เมื่อเรย์แคสต์ระหว่างสองจุดที่อาจเปลี่ยนแปลงได้, เช่นจากตัวละครผู้เล่นคนหนึ่งไปยังอีกคนหนึ่ง

ต้นกำเนิดบวกเวกเตอร์ทิศทางจะบ่งบอกจุดหมายของเรย์:

$\text{rayOrigin} + \text{rayDirection} = \text{rayDestination}$
หัก $\text{rayOrigin}$ ออกจากทั้งสองข้างของสมการ:

$\text{rayOrigin} + \text{rayDirection} - \text{rayOrigin} = \text{rayDestination} - \text{rayOrigin}$
ทิศทางของเรย์เท่ากับจุดหมายลบต้นกำเนิด:

$\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)

ตัวเลือกการกรอง

WorldRoot:Raycast() ยอมรับวัตถุ RaycastParams ที่ไม่บังคับซึ่งบอกให้การเรย์แคสต์รวมหรือยกเว้น BaseParts บางอย่าง, ข้ามวัสดุ น้ำ สำหรับ Terrain หรือใช้ กลุ่มการชน.

กุญแจ	คำอธิบาย
FilterDescendantsInstances	Array ของวัตถุที่ทายทอดใช้ในการกรองผู้เข้าร่วมการเรย์แคสต์.
FilterType	การตั้งค่าของ Enum.RaycastFilterType ที่กำหนดวิธีการใช้งานอาเรย์ FilterDescendantsInstances ในการทำงานของการเรย์แคสต์. Exclude — ทุก BasePart จะถูกพิจารณา ยกเว้น วัตถุที่เป็นทายทอดของอาเรย์. Include — จะพิจารณาเฉพาะ BaseParts ที่เป็นทายทอดของอาเรย์.
IgnoreWater	Boolean ที่กำหนดว่าวัสดุ น้ำ จะถูกพิจารณาเมื่อรีย์แคสต์กับ Terrain หรือไม่.
CollisionGroup	ชื่อ String ของ กลุ่มการชน ที่ใช้สำหรับการทำงานการเรย์แคสต์.

การกรองการเรย์แคสต์

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)

การตรวจจับการชน

หากการทำงานการเรย์แคสต์ชนกับ BasePart หรือ Terrain เซลล์ที่มีคุณสมบัติ ค่าของ RaycastResult จะถูกส่งคืนซึ่งมีผลลัพธ์อยู่ เพื่อทดสอบการชน, ยืนยันว่าผลลัพธ์ไม่ใช่ nil และใช้คุณสมบัติต่อไปนี้ตามต้องการ

คุณสมบัติ	คำอธิบาย
Instance	BasePart หรือ Terrain เซลล์ที่เรย์ตัดข้าม
Position	ตำแหน่ง Vector3 ของจุดตัดระหว่างเรย์และ Instance
Distance	ระยะทางระหว่างจุดเริ่มต้นของเรย์และจุดตัด
Material	วัสดุ Enum.Material ของ BasePart หรือ Terrain ณ จุดตัด
Normal	Vector3 ของเวกเตอร์ปกติของด้านที่ตัดข้าม

เมื่อใช้ในที่ที่เปิดใช้งาน การสตรีมอินสแตนซ์, คลิปอาจไม่สตรีม BaseParts ที่อยู่ไกล ดังนั้นการเรย์แคสต์อาจไม่ตรวจพบการชน นอกจากนี้, "ภาพลวงตา" Terrain และ Models ที่มีรายละเอียดต่ำที่สร้างโดยระบบสตรีมจะเป็นเพียงการแสดงผลและไม่สามารถใช้เป็นเป้าหมายการเรย์แคสต์ได้

คุณสามารถยกเว้น BasePart ออกจากการตรวจจับการชนได้โดยการตั้งค่าคุณสมบัติ BasePart.CanQuery เป็น false

การตรวจจับการชนของเรย์แคสต์

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("อินสแตนซ์:", raycastResult.Instance)
	print("ตำแหน่ง:", raycastResult.Position)
	print("ระยะทาง:", raycastResult.Distance)
	print("วัสดุ:", raycastResult.Material)
	print("ปกติ:", raycastResult.Normal)
else
	warn("ไม่มีผลลัพธ์การเรย์แคสต์!")
end

ภาษาไทย