Raios

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Em seu nível mais básico, raiocasting é o ato de enviar um raio invisível de um ponto Vector3 em uma direção específica com um comprimento definido. Uma vez lançado, você pode detectar se o raio atinge uma BasePart ou célula de Terrain.

Los lasers são disparados por orbes flutuantes, e o raiocasting determina se um laser atinge uma plataforma. As plataformas tocadas pelos lasers são destruídas temporariamente.

Você pode lançar um raio com o método WorldRoot:Raycast() (Workspace:Raycast()) de uma origem Vector3 em uma direção Vector3.

Raycast Básico

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)

Ao lançar um raio, o parâmetro de direção deve abranger o comprimento desejado do raio. Por exemplo, se a magnitude da direção for 10, o raio resultante também terá 10 de comprimento. O comprimento máximo é 15.000 studs.

Quando aplicável, você pode calcular um vetor direcional desconhecido (rayDirection) usando uma origem e destino conhecidos. Isso é útil ao lançar um raio entre dois pontos que podem mudar, como de um personagem jogador para outro.

A origem mais um vetor direcional indica o destino do raio:

$\text{rayOrigin} + \text{rayDirection} = \text{rayDestination}$
Subtraia $\text{rayOrigin}$ de ambos os lados da equação:

$\text{rayOrigin} + \text{rayDirection} - \text{rayOrigin} = \text{rayDestination} - \text{rayOrigin}$
A direção do raio é igual ao destino menos a origem:

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

Opções de filtro

WorldRoot:Raycast() aceita um objeto opcional RaycastParams que informa ao raiocasting para incluir ou excluir seletivamente certas BaseParts, ignorar o material Water para Terrain, ou usar um grupo de colisão.

Chave	Descrição
FilterDescendantsInstances	Array de objetos cujos descendentes são usados na filtragem de candidatos a raiocasting.
FilterType	Enum Enum.RaycastFilterType que determina como o array FilterDescendantsInstances é usado na operação de raiocasting. Exclude — Cada BasePart é considerado exceto aqueles que são descendentes de objetos no array. Include — Somente BaseParts que são descendentes de objetos no array são considerados.
IgnoreWater	Booleano que determina se o material Water é considerado ao raiocar contra Terrain.
CollisionGroup	Nome da string do grupo de colisão usado para a operação de raiocasting.

Filtragem 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)

Detecção de impacto

Se a operação de raiocasting atingir uma BasePart ou célula de Terrain elegível, um objeto RaycastResult é retornado contendo os resultados. Para testar se houve uma colisão, confirme que o resultado não é nil e utilize as seguintes propriedades conforme necessário.

Propriedade	Descrição
Instance	A BasePart ou célula de Terrain que o raio intersectou.
Position	Posição Vector3 da interseção entre o raio e a Instance.
Distance	Distância entre a origem do raio e o ponto de interseção.
Material	O Enum.Material da BasePart ou Terrain no ponto de interseção.
Normal	Vector3 do vetor normal da face intersectada.

Quando usado em um lugar com streaming de instâncias ativado, um cliente pode não ter transmitido BaseParts distantes, portanto, um raiocasting pode não detectar um impacto. Além disso, "impostores" de baixo detalhe de Terrain e Models gerados pelo sistema de streaming são puramente visuais e não são alvos elegíveis para raiocasting.

Você pode isentar qualquer BasePart da detecção de impacto definindo sua propriedade BasePart.CanQuery como false.

Detecção de Impacto de Raycast

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("Instância:", raycastResult.Instance)
	print("Posição:", raycastResult.Position)
	print("Distância:", raycastResult.Distance)
	print("Material:", raycastResult.Material)
	print("Normal:", raycastResult.Normal)
else
	warn("Nenhum resultado de raiocasting!")
end

Português (Brasil)