Vector3Value
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Um Vector3Value simplesmente armazena um Vector3 como um valor. Este valor pode ser usado para scripts se comunicarem, para objetos se moverem para uma localização predefinida, etc.
Amostras de código
Este exemplo de código causa a teleportação de uma peça para qualquer jogador que a toque para uma posição específica definida por um valor de vetor "TeleportPosition" Vector3.
-- Coloque-me em um Script dentro de uma Parte
local part = script.Parent
local teleportPosition = part.TeleportPosition
local function onTouch(otherPart)
-- Primeiro, encontre a HumanoidRootPart. Se não pudermos encontrá-la, saia.
local hrp = otherPart.Parent:FindFirstChild("HumanoidRootPart")
if not hrp then
return
end
-- Agora teletransporte definindo o CFrame para um criado a partir de
-- a posição de teletransporte armazenada
hrp.CFrame = CFrame.new(teleportPosition.Value)
end
part.Touched:Connect(onTouch)
This code sample demonstrates how it is possible to store a Vector2 within a Vector3Value by converting a Vector2 into a Vector3 with a dummy Z value. Similarly, you can load it by reconstructing the Vector2 from the X and Y axes.
local vector3Value = Instance.new("Vector3Value")
-- Store a Vector2 in a Vector3
local vector2 = Vector2.new(42, 70)
vector3Value.Value = Vector3.new(vector2.X, vector2.Y, 0) -- The Z value is ignored
-- Load a Vector2 from a Vector3
vector2 = Vector2.new(vector3Value.Value.X, vector3Value.Value.Y)
print(vector2)
Resumo
Propriedades
O armazenado Vector3 armazenado.
Eventos
Dispedido sempre que Vector3Value.Value for alterado.
Propriedades
Métodos
Eventos
Changed
Dispedido sempre que o Vector3Value.Value da Vector3Value for alterado.Ele será executado com o novo valor sendo armazenado no Objetode argumento, em vez de uma string que representa a propriedade sendo alterada.
Este evento, como outros eventos alterados, pode ser usado para rastrear quando um Vector3Value muda e para rastrear os diferentes valores que ele pode mudar.
Por instância, isso pode ser útil em jogos que dependem de Vector3Values para rastrear posições no mundo do jogo.
Eventos equivalentes modificados existem para objetos semelhantes, como NumberValue e StringValue, dependendo do tipo de objeto que melhor atende à necessidade.
Parâmetros
O novo valor após a alteração.
Amostras de código
O exemplo a seguir, assumindo que todos os objetos referenciados existissem, imprimiria o novo valor do Vector3Value cada vez que ele mudasse.No exemplo abaixo, ele imprimiria "10,10,10" .
local value = Instance.new("Vector3Value")
value.Parent = workspace
value.Changed:Connect(function(NewValue)
print(NewValue)
end)
value.Value = Vector3.new(10, 10, 10)