Rykastowanie

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Na najprostszej płaszczyźnie, rykastowanie to akt wysyłania niewidocznej wiązki z punktu Vector3 w określonym kierunku z zdefiniowaną długością. Po rykastowaniu możesz wykryć, czy wiązka trafia w BasePart lub komórkę Terrain.

Lasery są wystrzeliwane przez unoszące się kule, a rykastowanie określa, czy laser trafia w platformę. Platformy dotknięte przez lasery są tymczasowo niszczone.

Możesz rykastować wiązkę za pomocą metody WorldRoot:Raycast() (Workspace:Raycast()) z pochodzenia Vector3 w kierunku Vector3.

Podstawowe Rykastowanie

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)

Podczas rykastowania, parametr kierunku powinien obejmować pożądaną długość wiązki. Na przykład, jeśli wartość kierunku wynosi 10, powstała wiązka również będzie miała długość 10. Maksymalna długość wynosi 15,000 jednostek.

Gdy to możliwe, możesz obliczyć nieznany wektor kierunkowy (rayDirection) używając znanego pochodzenia i przeznaczenia. Jest to użyteczne, gdy rykastujesz wiązkę między dwoma punktami, które mogą się zmieniać, takimi jak od jednego gracza do drugiego.

Pochodzenie plus wektor kierunkowy wskazują przeznaczenie wiązki:

$\text{rayOrigin} + \text{rayDirection} = \text{rayDestination}$
Odejmij $\text{rayOrigin}$ od obu stron równania:

$\text{rayOrigin} + \text{rayDirection} - \text{rayOrigin} = \text{rayDestination} - \text{rayOrigin}$
Kierunek wiązki to przeznaczenie minus pochodzenie:

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

Opcje filtru

WorldRoot:Raycast() akceptuje opcjonalny obiekt RaycastParams, który informuje rykastowanie, aby selektywnie uwzględniało lub wykluczało określone BaseParts, ignorowało materiał Woda dla Terrain, lub używało grupy kolizji collision group.

Klucz	Opis
FilterDescendantsInstances	Array obiektów, których potomków używa się do filtrowania kandydatów do rykastowania.
FilterType	Enum Enum.RaycastFilterType, który określa, jak tablica FilterDescendantsInstances jest używana w operacji rykastowania. Exclude — Każda BasePart jest brana pod uwagę z wyjątkiem tych, które są potomkami obiektów w tablicy. Include — Tylko BaseParts, które są potomkami obiektów w tablicy, są brane pod uwagę.
IgnoreWater	Boolean, który określa, czy materiał Woda jest brany pod uwagę podczas rykastowania przeciwko Terrain.
CollisionGroup	Stringowa nazwa grupy kolizji collision group używanej w operacji rykastowania.

Filtracja Rykastowania

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)

Wykrywanie trafienia

Jeśli operacja rykastowania trafia w kwalifikującą się BasePart lub komórkę Terrain, zwracany jest obiekt RaycastResult zawierający wyniki. Aby sprawdzić trafienie, upewnij się, że wynik nie jest nil i wykorzystaj następujące właściwości w razie potrzeby.

Właściwość	Opis
Instance	Obiekt BasePart lub komórka Terrain, z którą wiązka się przecięła.
Position	Pozycja Vector3 punktu przecięcia między wiązką a Instance.
Distance	Odległość między pochodzeniem wiązki a punktem przecięcia.
Material	Material Enum.Material obiektu BasePart lub Terrain w punkcie przecięcia.
Normal	Vector3 normalnego wektora przeciętej powierzchni.

Gdy używane jest w miejscu z włączonym streamingiem instancji, klient może nie mieć załadowanych odległych BaseParts, więc rykastowanie może nie wykryć trafienia. Dodatkowo, niskodetalowe "imposter" Terrain i Models generowane przez system streamingowy są czysto wizualne i nie są uznawane za cele rykastowania.

Możesz wyłączyć wykrywanie trafienia dla dowolnego BasePart, ustawiając jego właściwość BasePart.CanQuery na false.

Wykrywanie Trafienia Rykastowania

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("Instancja:", raycastResult.Instance)
	print("Pozycja:", raycastResult.Position)
	print("Odległość:", raycastResult.Distance)
	print("Materiał:", raycastResult.Material)
	print("Normalna:", raycastResult.Normal)
else
	warn("Brak wyniku rykastowania!")
end

Polski