Vector3Value
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Une valeur Vector3 simplement tient un Vector3 comme valeur. Cette valeur peut être utilisée pour que les scripts se communiquent, pour que les objets se déplacent vers une position prédéfinie, etc.
Échantillons de code
Ce code d'exemple fait en sorte qu'une partie téléporte n'importe quel joueur qui la touche vers une position spécifique définie par un vecteur "Position de téléportation" Vector3Value.
-- Collez-moi dans un script à l'intérieur d'une partie
local part = script.Parent
local teleportPosition = part.TeleportPosition
local function onTouch(otherPart)
-- Tout d'abord, trouvez la partie racine humanoïde. Si nous ne pouvons pas la trouver, sortez.
local hrp = otherPart.Parent:FindFirstChild("HumanoidRootPart")
if not hrp then
return
end
-- Maintenant téléporter en définissant le CFrame sur celui créé à partir de
-- la position de téléportation stockée
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)
Propriétés
Méthodes
Évènements
Changed
Tiré chaque fois que le Vector3Value.Value du Vector3Value est modifié.Il s'exécutera avec la nouvelle valeur stockée dans l'objet d'argument, au lieu d'une chaîne représentant la propriété modifiée.
Cet événement, comme d'autres événements modifiés, peut être utilisé pour suivre quand un Vector3Value change et pour suivre les différentes valeurs qu'il peut changer.
Par instance, cela peut être utile dans les jeux qui comptent sur Vector3Values pour suivre les positions dans le monde du jeu.
Des événements équivalents modifiés existent pour des objets similaires, tels que NumberValue et StringValue, en fonction du type d'objet qui convient le mieux aux besoins.
Paramètres
La nouvelle valeur après le changement.
Échantillons de code
L'exemple ci-dessous, en supposant que tous les objets référencés existaient, imprimerait la nouvelle valeur du Vector3Value à chaque fois qu'elle changeait.Dans l'exemple ci-dessous, il imprimerait "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)