Lancer de rayons

A son niveau le plus basique, le lancer de rayons est l'acte d'envoyer un rayon invisible à partir d'un point Vector3 spécifique dans une direction définie avec une longueur définie.Une fois lancé, vous pouvez détecter si le rayon frappe une cellule BasePart ou Terrain .

Les lasers sont tirés par des orbes flottants, et le lancer de rayons détermine si un laser frappe une plate-forme.Les plateformes touchées par les lasers sont temporairement détruites.

Vous pouvez lancer un rayon avec la méthode WorldRoot:Raycast() ( Workspace:Raycast() ) à partir d'une origine Vector3 en direction Vector3.

Lancer de rayon basique
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)

Lors du lancement d'un rayon, le paramètre de direction doit inclure la longueur souhaitée du rayon.Par instance, si la magnitude de la direction est de 10, le rayon résultant aura également une longueur de 10.La longueur maximale est de 15 000 studs.

Lorsque cela est applicable, vous pouvez calculer un vecteur directionnel inconnu ( ) en utilisant une origine connue et une destination .Cela est utile lors du lancement d'un rayon entre deux points qui peuvent changer, comme d'un personnage joueur à un autre.

L'origine plus un vecteur directionnel indique la destination du rayon :

origine de rayon + direction de rayon = destination de rayon
Soustraire rayOrigin des deux côtés de l'équation :

rayOrigin + rayDirection − rayOrigin = rayDestination − rayOrigin
La direction du rayon correspond à la destination moins l'origine :

direction de rayon = destination de rayon − origine de rayon


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)

Options de filtrage

accepte un objet optionnel qui indique au lancer de rayons de sélectionner ou d'exclure de façon sélective certains , d'ignorer le matériau eau pour ou d'utiliser un groupe de collision .

Clé	Avertissement
FilterDescendantsInstances	Array d'objets dont les descendants sont utilisés dans le filtrage des candidats de lancer de rayons
FilterType	Enum.RaycastFilterType enum qui détermine comment l'array FilterDescendantsInstances est utilisée dans l'opération de lancer de rayons. Exclude — Chaque BasePart est considéré comme excepté ceux qui sont les descendants d'objets dans l'matrice. Include — Seuls BaseParts les descendants d'objets dans l'array sont considérés.
IgnoreWater	Boolean qui détermine si le matériau eau est pris en compte lors du lancer de rayons contre Terrain .
CollisionGroup	Nom de chaîne du groupe de collision utilisé pour l'opération de lancer de rayons.

Filtre de raycast
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)

Détection des coups

Si l'opération de lancer de rayons frappe une cellule éligible BasePart ou Terrain, un objet RaycastResult est retourné contenant les résultats.Pour tester un hit, confirmez que le résultat n'est pas nil et utilisez les propriétés suivantes comme nécessaire.

Propriété	Avertissement
Instance	La cellule BasePart ou Terrain dans laquelle le rayon a intersecté.
Position	Vector3 position de l'intersection entre le rayon et le Instance.
Distance	Distance entre l'origine du rayon et le point d'intersection.
Material	Le Enum.Material du BasePart ou Terrain au point d'intersection.
Normal	Vector3 du vecteur normal de la face intersectionnée.

Lorsqu'il est utilisé dans un endroit avec l'instance streaming activée, un client peut ne pas avoir diffusé à distance BaseParts, de sorte qu'un raycast ne peut pas détecter un coup.En outre, le « imposteur » de détail faible Terrain et Models généré par le système de diffusion sont purement visuels et ne sont pas éligibles comme cibles de lancer de rayons.

Vous pouvez exempter n'importe quel BasePart de détection de frappe en définissant sa propriété BasePart.CanQuery à false.

Détection des coups de lancer de rayons
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("No raycast result!")
end

Options de filtrage

Détection des coups

Sur cette page