The following example demonstrates how to get the `Enum.UserCFrame` of the left controller and place a part at that point in real world space. The `Datatype.CFrame` of the controller changes whenever the device moves, so you should update the necessary parts whenever `Class.VRService.UserCFrameChanged` fires.

**VRService** est responsable de la gestion des interactions entre Roblox et la réalité virtuelle (VR).Ses méthodes, propriétés et événements vous aident à fournir la meilleure expérience pour les utilisateurs finaux qui cherchent à expérimenter Roblox sur des appareils VR.

  Voir [directives VR](/production/publishing/vr-guidelines) pour plus d'informations sur la publication d'une expérience pour les appareils VR.

This example prints the name of the UserCFrame VR device making the request,
and the CFrame coordinates passed.

Cet événement se déclenche lorsque la navigation est demandée à partir de `Class.VRService` pour un appareil VR spécifié `Enum.UserCFrame`.Il tire avec une coordonnée `Datatype.CFrame` et l'indication spécifiée `Enum.UserCFrame` indiquant la demande d'appareil demandant la navigation.

  Cet événement peut être utilisé aux côtés des événements et des méthodes de service `Class.UserInputService`.

  Puisque cet événement se déclenche localement, il ne peut être utilisé qu'en `Class.LocalScript` .

VRService.NavigationRequested

cframe

Les coordonnées demandées `Datatype.CFrame` .

inputUserCFrame

Indique l'appareil VR pour lequel la navigation est demandée.

Tiré lorsque la navigation est demandée à partir de `Class.VRService` .

This example fires when the state of a VRTouchpad changes. It prints the name
of the Touchpad that changed, and the state that it changed to.

Cet événement se déclenche si le `Enum.VRTouchpadMode` d'un `Enum.VRTouchpad` est modifié.Vous pouvez utiliser cet événement pour suivre les états des touches VR connectées via le client de l'utilisateur.

  Cet événement peut être utilisé aux côtés des événements et des méthodes de service `Class.UserInputService`.

  Puisque cet événement se déclenche localement, il ne peut être utilisé qu'en `Class.LocalScript` .

VRService.TouchpadModeChanged

mode

Se déclenche si le `Enum.VRTouchpadMode` d'un `Enum.VRTouchpad` est modifié.

This event fires when the user moves a connected VR device. When the event
fires, this prints the name of the VR device type that changed, and the
updated CFrame coordinates.

Cet événement se déclenche lorsqu'un `Enum.UserCFrame` est modifié, par exemple lorsque l'utilisateur déplace un appareil VR connecté.Il peut être utilisé aux côtés de `Class.VRService:GetUserCFrame()|GetUserCFrame()` pour suivre les coordonnées `Datatype.CFrame` d'un appareil VR et lorsqu'il change/se déplace.Il peut également être utilisé aux côtés des événements et des méthodes de service `Class.UserInputService`.

  Puisque cet événement se déclenche localement, il ne peut être utilisé qu'en `Class.LocalScript` .

VRService.UserCFrameChanged

type

value

Les coordonnées mises à jour `Datatype.CFrame` de l'appareil VR après le changement.

Se déclenche lorsqu'un `Enum.UserCFrame` est modifié.

This example fires when a UserCFrame changes state, printing the name of the
changed UserCFrame and whether it changed got enabled or disabled.

Cet événement se déclenche lorsqu'un `Enum.UserCFrame` est activé ou désactivé.Il peut être utilisé aux côtés de `Class.VRService:GetUserCFrameEnabled()|GetUserCFrameEnabled()` pour suivre si un `Enum.UserCFrame|UserCFrame` spécifié est activé et quand son état change.Il peut également être utilisé aux côtés des événements et des méthodes de service `Class.UserInputService`.

  Puisque cet événement se déclenche localement, il ne peut être utilisé qu'en `Class.LocalScript` .

VRService.UserCFrameEnabled

Le `Enum.UserCFrame|UserCFrame` obtenir activé ou désactivé.

enabled

Un booléen indiquant si le `Enum.UserCFrame|UserCFrame` est activé ( `true` ) ou désactivé ( `false` ).

Se déclenche lorsqu'un `Enum.UserCFrame` est activé ou désactivé.

This example retrieves and prints the name of the user's current
VRTouchpad.Left touchpad mode.

Cette méthode renvoie le `Enum.VRTouchpadMode` indiquant le mode d'un mode spécifié `Enum.VRTouchpad` .Le mode retourné indique comment l'utilisateur interagit avec son touchpad pour jouer au jeu.

  Cela peut également être utilisé aux côtés des plusieurs méthodes et événements VR `Class.UserInputService`.

  Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un `Class.LocalScript`.

VRService:GetTouchpadMode

Le mode du spécifié `Enum.VRTouchpad|VRTouchpad` .

Renvoie le mode VRTouchpad indiquant le mode d'un VRTouchpad spécifié.

This example positions a part at the player's left hand, assuming Camera.HeadLocked = true

Cette méthode renvoie un `Datatype.CFrame` décrivant la position et l'orientation d'un appareil de réalité virtuelle spécifié comme un décalage par rapport à un point dans l'espace du monde réel.Cette méthode doit être utilisée lors de la mise en œuvre de la compatibilité VR dans un jeu pour obtenir et suivre le mouvement d'un appareil VR connecté.

  En utilisant la méthode, les développeurs peuvent implémenter des fonctionnalités telles que le répositionnement du personnage de l'utilisateur dans le jeu correspondant à l'emplacement d'un appareil VR connecté.Cela peut être fait en modifiant le *CFrame* du personnage du joueur dans le jeu pour correspondre au *CFrame* de l'appareil VR spécifié en utilisant les arguments de valeur UserCFrame et *CFrame* transmis par l'événement.

  `Class.VRService` fournit également un événement `Class.VRService.UserCFrameChanged|UserCFrameChanged` qui se déclenche automatiquement lorsque le `Datatype.CFrame` du dispositif VR connecté change, tant qu'il est utilisé dans un `Class.LocalScript` .

  Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un `Class.LocalScript`.

VRService:GetUserCFrame

Renvoie un cadre C qui décrit la position et l'orientation d'un appareil de réalité virtuelle spécifié en tant qu'écart par rapport à un point dans l'espace du monde réel.

This example indicates whether the UserCFrame.Head VR device is enabled or
disabled for the user. If the device is enabled, this prints "VR device is
enabled!". If the device is disabled, this prints "VR device is disabled!".

Cette méthode renvoie true si le dispositif de réalité virtuelle spécifié `Enum.UserCFrame` est disponible pour être écouté.Il peut être utilisé pour déterminer si un appareil VR spécifié, tel que `Enum.UserCFrame.Head`, est connecté au jeu de l'utilisateur.

  Cela peut également être utilisé aux côtés des plusieurs méthodes et événements VR `Class.UserInputService`.

  Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un `Class.LocalScript`.

VRService:GetUserCFrameEnabled

Un booléen indiquant si le dispositif VR spécifié est activé ( `true` ) ou désactivé ( `false` ).

Renvoie vrai si le `Enum.UserCFrame` est disponible pour être écouté.

This example fires the function to recenter the CFrame of the user's head to
the current location of the VR headset being worn by the user.

Cette méthode redécentre le `Datatype.CFrame` de la tête de l'utilisateur à l'emplacement actuel du casque VR porté par l'utilisateur.Il peut être utilisé pour assurer que la tête de l'utilisateur dans le jeu soit positionnée en fonction de l'emplacement du casque VR de l'utilisateur.

  Cela se comporte de manière identique à `Class.UserInputService:RecenterUserHeadCFrame()`.

  Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un `Class.LocalScript`.

VRService:RecenterUserHeadCFrame

Re-centre le `Datatype.CFrame` à l'emplacement actuel du casque VR porté par l'utilisateur.

This example requests navigation from the user's **UserCFrame.Head**
coordinates to the CFrame coordinates of a `Part` named
_NavigationDestination_.

_Note:_ In order for this to work, a Part named _NavigationDestination_ must
exist in the game's Workspace.

Cette méthode demande la navigation vers le spécifié `Datatype.CFrame` en utilisant le spécifié `Enum.UserCFrame` comme origine pour la parabole visuelle.Il peut être utilisé pour incorporer la réalité virtuelle (VR) dans votre jeu en fournissant un moyen de visualiser un chemin de navigation depuis l'appareil VR de l'utilisateur jusqu'à une destination.

  `Class.VRService` a un événement similaire, `Class.VRService.NavigationRequested|NavigationRequested`, utilisé pour détecter de telles demandes.Cela peut également être utilisé aux côtés des plusieurs méthodes et événements VR `Class.UserInputService`.

  Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un `Class.LocalScript`.

VRService:RequestNavigation

Les coordonnées spécifiées `Datatype.CFrame` .

L'appareil VR pour lequel la navigation est demandée.

Navigations de requêtes vers le spécifié `Datatype.CFrame` en utilisant le spécifié `Enum.UserCFrame` comme origine pour la parabole visuelle.

This example sets the user's VRTouchpad.Left touchpad mode to
TouchMode.Touch. This means that the left touchpad is treated as ButtonB.

Cette méthode définit le mode du mode spécifié `Enum.VRTouchpad` à celui spécifié `Enum.VRTouchpadMode`.Il peut être utilisé pour modifier le mode de la tablette de réalité virtuelle (VR) de l'utilisateur afin que l'utilisateur interagisse différemment avec le jeu en utilisant la tablette.

  Cela peut également être utilisé aux côtés des plusieurs méthodes et événements VR `Class.UserInputService`.

  Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un `Class.LocalScript`.

VRService:SetTouchpadMode

Le mode spécifié `Enum.VRTouchpad|VRTouchpad` que vous souhaitez définir.

Le mode auquel vous souhaitez définir le `Enum.VRTouchpad|VRTouchpad` spécifié.

Définit le mode du spécifié `Enum.VRTouchpad` au spécifié `Enum.VRTouchpadMode`.

VRService

Lorsqu'il est défini à `Enum.VRScaling.World`, `Class.Camera.HeadScale` ajuste de sorte que la taille du monde soit vue du point de vue de l'avatar.Un joueur avec un petit avatar percevra les objets autour de lui comme plus grands que ceux d'un joueur avec un grand avatar.

VRService.AutomaticScaling

Ajuste automatiquement l'échelle dans VR pour aligner le joueur avec son avatar.

Lorsqu'il est réglé sur vrai, un joueur VR pourra animer ses mains et sa tête en utilisant ses contrôleurs et son casque.

  Cette propriété doit être définie sur le serveur.

VRService.AvatarGestures

Lorsque c'est vrai, un joueur VR pourra animer ses mains et sa tête en utilisant ses contrôleurs et son casque.

VRService.ControllerModels

Lorsque c'est vrai, la vue d'un joueur VR disparaît en noir lorsque sa tête se heurte à un objet.Cette propriété empêche les joueurs de pouvoir voir à travers les murs en VR.La valeur par défaut est vraie.

VRService.FadeOutViewOnCollision

Lorsque c'est vrai, la vue d'un joueur VR disparaîtra en noir lorsque sa tête se heurtera à un objet.

This example checks if Roblox detects a VR device. If a VR device is detected,
this prints the name of the UserCFrame responsible for VR input. If not, this
example prints "No VR device detected!".

Cette propriété décrit ce que `Enum.UserCFrame` est responsable de l'entrée dans VR.Par instance, si un casque VR est responsable, la valeur de cette propriété sera `Enum.UserCFrame.Head` .

  Pour vérifier si Roblox détecte des appareils VR, qui seraient responsables de l'entrée en VR, vous pouvez vérifier la propriété `Class.VRService.VREnabled|VREnabled`.

VRService.GuiInputUserCFrame

Détermine ce que `Enum.UserCFrame` est responsable de l'entrée dans VR.

VRService.LaserPointer

VRService.ThirdPersonFollowCamEnabled

This example demonstrates how to implement a head tracking script that mirrors
the movement of a virtual reality (VR) headset (the user's actual head) to
their in-game character's head.

The example first check if the user is using a VR device by checking the value
of the `Class.VRService.VREnabled|VREnabled()` property. This example
only works if the user is using a VR headset.

To determine the initial `Datatype.CFrame` of the character's head, the code
sample calls `Class.VRService:GetUserCFrame()|GetUserCFrame()` and
passes `Enum.UserCFrame.Head` as the argument.

To update the head's CFrame whenever the user's VR headset moves, the example
connects the `Class.VRService.UserCFrameChanged` event to the
_TrackHead()_ function. When the event fires to indicate that a VR device
moved, TrackHead() checks if the headset moved. If the headset moved, the
function updates the CFrame of the character's head to the `Datatype.CFrame`
_value_ provided as an argument.

As the UserCFrame enum also tracks VR left and right hand devices, the concept
of VR device tracking can be expanded to other character bodyparts.

In order for the example to work as expected, it must be placed in a
`LocalScript`.

Cette propriété décrit si l'utilisateur utilise un appareil de réalité virtuelle (VR).

  Si un appareil VR est activé, vous pouvez interagir avec sa localisation et son mouvement via des méthodes telles que `Class.UserInputService:GetUserCFrame()`.Vous pouvez également réagir au mouvement du dispositif VR en utilisant l'événement `Class.UserInputService.UserCFrameChanged`.

  ```lua
  local UserInputService = game:GetService("UserInputService")

  local isUsingVR = UserInputService.VREnabled
  if isUsingVR then
  	print("User is using a VR headset!")
  else
  	print("User is not using a VR headset!")
  end
  ```

  Cette propriété ne peut être utilisée qu'en `Class.LocalScript` .

  #### Voir aussi

  *   `Class.Camera.HeadLocked`
  *   `Class.UserInputService:GetUserCFrame()`
  *   `Class.UserInputService.UserCFrameChanged`

VRService.VREnabled

Détermine si l'utilisateur utilise un appareil de réalité virtuelle.

Service responsable de la gestion des interactions entre Roblox et la réalité virtuelle (VR).

`Instance` est la classe de base pour toutes les classes dans la hiérarchie de classe Roblox qui peuvent faire partie de l'arbre `Class.DataModel`.

  Il n'est pas possible de créer directement des objets racine `Instance` , mais le constructeur spécial `Datatype.Instance.new()` crée des objets via du code, en prenant le nom de la classe en paramètre et en retournant l'objet créé.

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

S'enflamme lorsque la propriété `Class.Instance.Parent` de l'objet ou l'une de ses ancêtres est modifiée.

  Cet événement inclut deux paramètres : `child` se réfère au `Class.Instance` dont le `Class.Instance.Parent` a été effectivement modifié, alors que `parent` se réfère au nouveau `Class.Instance.Parent` de cette instance.

  Vous pouvez utiliser cet événement pour suivre la suppression d'une instance dans Studio, comme la suppression manuelle dans l'Explorateur ou via un plugin.Si vous devez détecter quand une instance est détruite en utilisant `Class.Instance:Destroy()` , utilisez l'événement `Class.Instance.Destroying` à la place.

Instance.AncestryChanged

child

Le `Class.Instance` dont le `Class.Instance.Parent` a été modifié.

parent

Le nouveau `Class.Instance.Parent` de la `Class.Instance` dont le `Class.Instance.Parent` a été modifié.

S'enflamme lorsque la propriété `Class.Instance.Parent` de l'objet ou l'une de ses ancêtres est modifiée.

Cet événement se déclenche chaque fois que n'importe quel attribut est modifié sur l'instance, y compris lorsqu'un attribut est défini sur `nil`.Le nom de l'attribut modifié est transmis à la fonction connectée.

  Par exemple, le fragment de code suivant connecte la fonction `attributeChanged()` à tirer chaque fois que l'un des attributs de la partie change :

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part

  local function attributeChanged(attributeName)
  	print(attributeName, "changed")
  end

  part.AttributeChanged:Connect(attributeChanged)
  ```

  Voir aussi `Class.Instance:GetAttributeChangedSignal()` qui renvoie un événement qui se déclenche lorsqu'un attribut spécifique change.

Instance.AttributeChanged

attribute

Le nom de l'attribut qui a été modifié.

S'enflamme chaque fois qu'un attribut est modifié sur le `Class.Instance`.

This snippet prints the names of objects as they are added to the Workspace:

Feux après qu'un objet soit parenté à ceci `Class.Instance` .

  Remarque, lors de l'utilisation de cette fonction sur un client pour détecter les objets créés par le serveur, il est nécessaire d'utiliser `Class.Instance:WaitForChild()` lors de l'indexation des descendants de cet objet.C'est parce que l'objet et ses descendants ne sont pas garantis de se répliquer simultanément du serveur au client.Par exemple :

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  Notez que cette fonction ne fonctionne que pour les enfants immédiats du `Class.Instance` . Pour une fonction qui capture tous les descendants, utilisez `Class.Instance.DescendantAdded` .

  Voir aussi `Class.Instance.ChildRemoved` .

Instance.ChildAdded

Feux après qu'un objet soit parenté à ceci `Class.Instance` .

This snippet prints the names of objects as they are removed from the
Workspace:

Feux après qu'un enfant a été retiré de ce `Class.Instance` .

  Supprimé fait référence au moment où le parent d'un objet est modifié de cette `Class.Instance` à quelque chose d'autre que ceci `Class.Instance` .Notez que cet événement se déclenchera également lorsqu'un enfant est détruit (en utilisant `Class.Instance:Destroy()` ) car la fonction destroy définira le parent d'un objet à `nil` .

  Cette fonction ne fonctionne que pour les enfants immédiats du `Class.Instance`. Pour une fonction qui capture tous les descendants, utilisez `Class.Instance.DescendantRemoving`.

  Voir aussi `Class.Instance.ChildAdded` .

Instance.ChildRemoved

Le `Class.Instance` qui a été supprimé.

Feux après qu'un enfant a été retiré de ce `Class.Instance` .

This following example will print the name of any object that is added to the
Workspace:

Cet événement se déclenche après l'ajout d'un descendant à la `Class.Instance`.

  Comme il tire pour chaque descendant, parenter un objet à la `Class.Instance` fera tirer l'événement pour cet objet et tous ses descendants individuellement.

  Si vous ne vous souciez que des enfants directs de la , utilisez à la place.

  Voir aussi `Class.Instance.DescendantRemoving` .

Instance.DescendantAdded

descendant

Feux après qu'un descendant ait été ajouté à la `Class.Instance`.

The following example prints the name of any descendant as it is being removed
from the Workspace:

Cet événement se déclenche **immédiatement avant** que le parent `Class.Instance` de telle sorte qu'une instance **descendante** ne sera plus une descendante.`Class.Instance:Destroy()|Destroy()` change le `Class.Instance.Parent|Parent` d'une instance en `nil`, donc l'appel de cette méthode sur un descendant du parent provoquera le déclenchement de cet événement.

  Puisque cet événement se déclenche avant **la suppression du descendant, le parent du descendant sera inchangé au moment du déclenchement de cet événement** .Si le descendant est également un enfant direct du parent, cet événement se déclenchera avant .

  Si un descendant a des enfants, cet événement se déclenche d'abord avec le descendant, suivi de ses descendants.

  ##### Avertissement

  Cet événement se déclenche avec l'objet descendant qui est supprimé.Tenter de définir le `Class.Instance.Parent|Parent` du descendant sur autre chose échouera.Ci-dessous est un exemple qui montre cela :

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	descendant.Parent = game
  end)

  local part = Instance.new("Part")
  part.Parent = Workspace
  part.Parent = nil
  ```

  Voir aussi `Class.Instance.DescendantAdded|DescendantAdded` .

Instance.DescendantRemoving

Le `Class.Instance` qui est en train d'être supprimé.

S'enflamme immédiatement avant que le descendant du `Class.Instance` soit supprimé.

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.

This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.

La `Class.Instance` ne sera jamais supprimée de la mémoire tant qu'une fonction connectée l'utilise encore.Cependant, si la fonction produit à tout moment, le `Class.Instance` et ses descendants seront parentés à `nil` .

  Si la propriété `Class.Workspace.SignalBehavior` est définie sur `Enum.SignalBehavior.Immediate`, cet événement se déclenche immédiatement avant que `Class.Instance` ou l'un de ses ancêtres ne soit détruit avec `Class.Instance:Destroy()` .

  Si la propriété `Class.Workspace.SignalBehavior` est définie sur `Enum.SignalBehavior.Deferred`, cet événement se déclenche au prochain point de reprise, qui sera après que le `Class.Instance` ou l'un de ses ancêtres a été détruit avec `Class.Instance:Destroy()` .

  Avec le comportement `Enum.SignalBehavior.Deferred|Deferred`, la connexion d'un script à son propre événement `Class.Instance.Destroying` est problématique, car le script sera détruit avant que le rappel puisse être appelé (ce qui signifie qu'il ne sera pas exécuté).

  Lors de la suppression d'un `Class.Instance` dans Studio, comme la suppression manuelle via le [Explorateur](/studio/explorer) ou via un plugin, le `Class.Instance` n'est pas détruit.Au lieu de cela, le parent est défini sur `nil` que vous pouvez suivre avec `Class.Instance.AncestryChanged` .

Instance.Destroying

Il se déclenche immédiatement avant (ou est reporté jusqu'à ce que) l'instance soit détruite via `Class.Instance:Destroy()` .

Cet événement se déclenche chaque fois que toute propriété de style est modifiée sur l'instance, y compris lorsque une propriété est définie sur `nil` .

  ```lua
  local Players = game:GetService("Players")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")
  local meterBar = HUDContainer.MeterBar

  local function stylePropertyChanged()
  	print("Styled properties changed")
  end

  meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
  ```

Instance.StyledPropertiesChanged

Il se déclenche chaque fois que toute propriété de style est modifiée sur l'instance, y compris lorsqu'une propriété est définie sur `nil` .

Instance.childAdded

Cette méthode applique une balise à l'instance, sans effet si la balise est déjà appliquée.Ajouter avec succès une balise déclenchera un signal créé par `Class.CollectionService:GetInstanceAddedSignal()` avec la balise donnée.

  ##### Avertissements

  *   Les balises d'une instance qui ont été ajoutées côté client seront supprimées si le serveur ajoute ou supprime plus tard une balise sur cette instance car le serveur réplique toutes les balises ensemble et remplace les balises précédentes.

  *   Lors du marquage d'une instance, il est courant que certaines ressources soient utilisées pour donner au tag sa fonctionnalité, par exemple des connexions d'événements ou des tables.Pour empêcher les fuites de mémoire, il est une bonne idée de les nettoyer (débrancher, réinitialiser à `nil` , etc.) lorsqu'elles ne sont plus nécessaires pour une balise.Faites ceci lorsque vous appelez `Class.Instance:RemoveTag()`, appelez `Class.Instance:Destroy()` ou dans une fonction connectée à un signal retourné par `Class.CollectionService:GetInstanceRemovedSignal()` .

Instance:AddTag

Cette fonction détruit tous les enfants et les descendants d'une instance.

  ```
  local part = Instance.new("Part")

  -- Add some sparkles
  for i = 1, 3 do
  	local sparkles = Instance.new("Sparkles")
  	sparkles.Parent = part

    local sc = Instance.new("Sparkles")
    sc.Parent = sparkles
  end

  print("Children:", #part:GetChildren())  --> Children: 3

  part:ClearAllChildren()

  print("Children:", #part:GetChildren())  --> Children: 0
  ```

  Si vous ne souhaitez pas détruire **tous** les enfants et les descendants, utilisez `Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` pour parcourir ces enfants/descendants et sélectionnez ce que vous devez détruire.Par exemple, l'exemple de code suivant détruira tous les `Class.BasePart|BaseParts` descendant d'un `Class.Model` :

  ```
  local Workspace = game:GetService("Workspace")

  local model = Workspace:FindFirstChild("TestModel")

  for _, descendant in model:GetDescendants() do
  	if descendant:IsA("BasePart") then
  		descendant:Destroy()
  	end
  end
  ```

Instance:ClearAllChildren

Cette fonction détruit tous les enfants d'une instance.

Demonstrates cloning a model using `Class.Instance:Clone()`.

`Clone()` crée une copie d'une instance et de tous ses descendants, en ignorant toutes les instances qui ne sont pas `Class.Instance.Archivable|Archivable` .Une copie de l'instance racine est retournée par cette méthode et son `Class.Instance.Parent|Parent` est défini sur `nil` .Notez que si l'instance elle-même a `Class.Instance.Archivable|Archivable` définie à `false`, cette fonction retournera `nil` .

  Si une propriété de référence telle que `Class.ObjectValue.Value` est définie dans une instance clonée, la valeur de la propriété de la copie dépend de la valeur de l'original :

  *   Si une propriété de référence se réfère à une instance qui a été **également** clonée, la copie se référera à la copie.
  *   Si une propriété de référence se réfère à un objet qui n'a pas été **cloné** , la même valeur est maintenue dans la copie.

Instance:Clone

Créer une copie d'une instance et de tous ses descendants, en ignorant les instances qui ne sont pas `Class.Instance.Archivable|Archivable` .

Demonstrates destroying a Part using the `Class.Instance:Destroy()` function.

This function is the correct way to dispose of objects that are no longer required.

Définit la propriété `Class.Instance.Parent` à `nil`, verrouille la propriété `Class.Instance.Parent` et déconnecte toutes les connexions, puis appelle `Destroy()` sur tous les enfants.Cette fonction est la bonne façon de se débarrasser d'objets qui ne sont plus nécessaires.

  L'élimination des objets inutiles est importante, car les objets inutiles et les connexions dans un endroit utilisent la mémoire qui peut entraîner des problèmes de performance sérieux au fil du temps.

  En tant que meilleure pratique après avoir appelé `Destroy()` sur un objet, définissez toutes les variables qui font référence à l'objet (ou à ses descendants) à `nil` .Cela empêche votre code d'accéder à quoi que ce soit ayant à voir avec l'objet.

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  part:Destroy()
  -- Ne faites pas cela :
  print(part.Name)  --> "Bonjour, monde"
  -- Faites ceci pour empêcher la ligne ci-dessus de fonctionner :
  part = nil
  ```

  Une fois qu'une `Class.Instance` a été détruite par cette méthode, elle ne peut pas être réutilisée car la propriété `Class.Instance.Parent` est verrouillée.Pour **temporairement** supprimer un objet au lieu de le détruire, définissez `Class.Instance.Parent|Parent` à `nil` .Par exemple :

  ```
  local Workspace = game:GetService("Workspace")

  object.Parent = nil
  task.wait(2)
  object.Parent = Workspace
  ```

  Pour détruire un objet après un certain nombre de temps, utilisez `Class.Debris:AddItem()` .

Instance:Destroy

Définit la propriété `Class.Instance.Parent` à `nil`, verrouille la propriété `Class.Instance.Parent` et déconnecte toutes les connexions, puis appelle `Destroy()` sur tous les enfants.

Renvoie le premier ancêtre du `Class.Instance` dont le `Class.Instance.Name` est égal au nom donné.

  Cette fonction fonctionne en aval, ce qui signifie qu'elle commence à l'instant immédiat de l'instance `Class.Instance.Parent` et fonctionne vers le `Class.DataModel`.Si aucun ancêtre correspondant n'est trouvé, il renvoie `nil` .

  Le fragment de code suivant trouverait le premier ancêtre de l'objet nommé `Car` .

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  Pour les variantes de cette fonction qui trouvent des ancêtres d'une classe spécifique, voir `Class.Instance:FindFirstAncestorOfClass()` et `Class.Instance:FindFirstAncestorWhichIsA()` .

Instance:FindFirstAncestor

name

Renvoie le premier ancêtre du `Class.Instance` dont le `Class.Instance.Name` est égal au nom donné.

Renvoie le premier ancêtre du `Class.Instance` dont le `Class.Object.ClassName` est égal à la classe donnée.

  Cette fonction fonctionne en aval, ce qui signifie qu'elle commence à l'instant immédiat de l'instance `Class.Instance.Parent` et fonctionne vers le `Class.DataModel`.Si aucun ancêtre correspondant n'est trouvé, il renvoie `nil` .

  Un usage commun de cette fonction est de trouver le appartient à. Par exemple :

  ```
  local model = part:FindFirstAncestorOfClass("Model")
  ```

  Cette fonction est une variante de `Class.Instance:FindFirstAncestor()` qui vérifie la propriété `Class.Object.ClassName` plutôt que `Class.Instance.Name`.`Class.Instance:FindFirstAncestorWhichIsA()` existe également, en utilisant la méthode `Class.Object:IsA()` au lieu de respecter l'héritage de classe.

Instance:FindFirstAncestorOfClass

className

Le `Class.Object.ClassName` à rechercher.

Renvoie le premier ancêtre du `Class.Instance` dont le `Class.Object.ClassName` est égal à la classe donnée.

Retourne le premier ancêtre du `Class.Instance` pour lequel `Class.Object:IsA()` renvoie vrai pour la classe donnée.

  Cette fonction fonctionne en aval, ce qui signifie qu'elle commence à l'instant immédiat de l'instance `Class.Instance.Parent` et fonctionne vers le `Class.DataModel`.Si aucun ancêtre correspondant n'est trouvé, il renvoie `nil` .

  Contrairement à `Class.Instance:FindFirstAncestorOfClass()`, cette fonction utilise `Class.Object:IsA()` qui respecte l'héritage de classe. Par exemple :

  ```
  print(part:IsA("Part"))  --> true
  print(part:IsA("BasePart"))  --> true
  print(part:IsA("Instance"))  --> true
  ```

  La suite du code suivante retournera donc le premier ancêtre , ou , indépendamment du fait qu'il s'agisse d'un , ou .

  ```
  local part = object:FindFirstAncestorWhichIsA("BasePart")
  ```

  Voir aussi `Class.Instance:FindFirstAncestor()` .

Instance:FindFirstAncestorWhichIsA

Retourne le premier ancêtre du `Class.Instance` pour lequel `Class.Object:IsA()` renvoie vrai pour la classe donnée.

Ce qui suit rechercherait dans l'espace de travail un nom d'objet « Brick ». S'il est trouvé, il changerait le nom de l'objet en « Foo ».

Retourne le premier enfant du `Class.Instance` avec le nom donné, ou `nil` si aucun tel enfant n'existe.Si l'argument facultatif `recursive` optionnel est `true`, cette fonction recherche tous les descendants plutôt que les enfants immédiats du `Class.Instance`.

  ##### Vérification de l'existence d'un objet

  `FindFirstChild()` est nécessaire si vous devez vérifier qu'un objet existe avant de continuer.Tenter d'indexer un enfant par son nom en utilisant l'opérateur point provoque une erreur si l'enfant n'existe pas.

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Les erreurs suivantes se produisent si la partie n'existe pas dans l'espace de travail
  Workspace.Part.Transparency = 0.5
  ```

  Une meilleure approche consiste à utiliser `FindFirstChild()` pour vérifier d'abord `Part` , puis à utiliser une déclaration `if` pour exécuter du code qui en a besoin.

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace:FindFirstChild("Part")
  if part then
  	part.Transparency = 0.5
  end
  ```

  ##### Trouver un enfant dont le nom correspond à une propriété

  Parfois, le `Class.Instance.Name|Name` d'un objet est le même que celui d'une propriété de son `Class.Instance.Parent|Parent` .Lors de l'utilisation de l'opérateur point, les propriétés prennent le pas sur les enfants s'ils partagent un nom.

  Dans l'exemple suivant, un `Class.Folder` appelé `Color` est ajouté à un `Class.Part` qui a également la propriété `Class.Part.Color`.Remarquez que `part.Color` se réfère à la valeur de propriété `Datatype.Color3`, pas à l'instance enfant `Class.Folder`.Un avantage de l'utilisation de `Class.Instance:FindFirstChild()|FindFirstChild()` est que l'introduction de nouvelles propriétés n'impose pas de risque pour votre code.

  ```lua
  local part = Instance.new("Part")
  local folder = Instance.new("Folder")
  folder.Name = "Color"
  folder.Parent = part
  local c1 = part.Color  -- La propriété
  local c2 = part:FindFirstChild("Color")  -- The child folder
  ```

  ##### Notes de performances

  `Class.Instance:FindFirstChild()|FindFirstChild()` prend environ 20 % plus de temps que l'utilisation de l'opérateur point et presque 8 fois plus de temps que simplement le stockage d'une référence à un objet.Vous devez donc éviter de l'appeler dans du code dépendant de la performance, comme dans des boucles serrées ou des fonctions connectées à `Class.RunService.Heartbeat` et `Class.RunService.PreRender` .Au lieu de cela, stockez le résultat dans une variable, ou envisagez d'utiliser `Class.Instance.ChildAdded|ChildAdded` ou `Class.Instance:WaitForChild()|WaitForChild()` pour détecter quand un enfant d'un nom donné devient disponible.

Instance:FindFirstChild

recursive

Si la recherche doit être menée de manière récursive ou non.

Renvoie le premier enfant du `Class.Instance` trouvé avec le nom donné.

Retourne le premier enfant du `Class.Instance` dont le `Class.Object.ClassName|ClassName` est égal au donné `className` .Contrairement à `Class.Instance:FindFirstChildWhichIsA()` , cette fonction ne renvoie que des objets dont la classe correspond à `className` , en ignorant l'héritage de classe.Si aucun enfant correspondant n'est trouvé, cette fonction renvoie `nil` .

Instance:FindFirstChildOfClass

Retourne le premier enfant du `Class.Instance` dont le `Class.Object.ClassName|ClassName` est égal au nom de classe donné.

Retourne le premier enfant du `Class.Instance` pour lequel `Class.Object:IsA()` renvoie vrai pour la classe donnée.

  Si aucun enfant correspondant n'est trouvé, cette fonction renvoie `nil` .Si l'argument récursif facultatif est vrai, cette fonction recherche tous les descendants plutôt que les enfants immédiats de la `Class.Instance` .

  Contrairement à `Class.Instance:FindFirstChildOfClass()`, cette fonction utilise `Class.Object:IsA()` qui respecte l'héritage de classe. Par exemple :

  ```lua
  print(part:IsA("Part")) --> vrai
  print(part:IsA("BasePart")) --> vrai
  print(part:IsA("Instance")) --> true
  ```

  Par conséquent, l'exemple de code suivant retournera le premier enfant `Class.BasePart` , indépendamment du fait qu'il s'agisse d'un `Class.WedgePart` , `Class.MeshPart` ou `Class.Part` .

  ```
  local part = object:FindFirstChildWhichIsA("BasePart")
  ```

  Les développeurs qui recherchent un enfant par nom devraient utiliser `Class.Instance:FindFirstChild()` à la place.

Instance:FindFirstChildWhichIsA

Retourne le premier enfant du `Class.Instance` pour lequel `Class.Object:IsA()` renvoie vrai pour la classe donnée.

Renvoie le premier descendant trouvé avec le donné `Class.Instance.Name` .

  Cette méthode est désactivée et ne peut pas être utilisée.Pour trouver le premier descendant d'une instance, envisagez d'utiliser le paramètre `recursive` sur `Class.Instance:FindFirstChild()` à la place.

Instance:FindFirstDescendant

Renvoie le premier descendant trouvé avec le donné `Class.Instance.Name` .

Si le `Class.Instance` est un `Class.Actor`, le `Class.Actor` lui-même est renvoyé.Sinon, son ancêtre le plus proche `Class.Actor` est retourné.Si aucun ancêtre n'est un `Class.Actor` , le résultat est `nil` .

Instance:GetActor

Retourne le `Class.Actor` associé à l'instance, si nécessaire.

Cette méthode renvoie la valeur qui a été attribuée au nom d'attribut donné. Si aucun attribut n'a été attribué, `nil` est renvoyé.

  Par exemple, le fragment de code suivant définit puis obtient la valeur de l'attribut `InitialPosition` de l'instance :

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local initialPosition = instance:GetAttribute("InitialPosition")
  print(initialPosition)
  ```

  ##### Voir aussi

  *   `Class.Instance:SetAttribute()` qui définit l'attribut avec le nom donné à la valeur donnée.
  *   `Class.Instance:GetAttributes()` qui renvoie un dictionnaire de paires clé-valeur pour chacun des attributs de l'instance.

Instance:GetAttribute

La valeur qui a été attribuée au nom d'attribut donné. Si aucun attribut n'a été attribué, `nil` est retournée.

Renvoie la valeur qui a été attribuée au nom d'attribut donné.

Cette fonction renvoie un événement qui se comporte exactement comme l'événement `Class.Object.Changed|Changed`, sauf qu'il ne se déclenche que lorsque l'attribut spécifique change ; efficacement, c'est similaire à `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` pour les attributs.

  Il est généralement une bonne idée d'utiliser cette méthode au lieu d'une connexion à `Class.Object.Changed|Changed` avec une fonction qui vérifie le nom de l'attribut.Les appels ultérieurs à cette méthode sur le même objet avec le même nom d'attribut retournent le même événement.

  L'exemple de code suivant renvoie un signal qui déclenche la fonction `attributeChanged()` lorsque l'attribut de la partie `InitialPosition` change :

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local function attributeChanged()
  	print("Attribute changed")
  end

  part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
  ```

  Voir aussi `Class.Instance.AttributeChanged` qui se déclenche chaque fois que n'importe quel attribut est modifié sur l'instance.

Instance:GetAttributeChangedSignal

Le nom de l'attribut spécifié pour lequel le signal de changement est renvoyé.

Un événement qui se déclenche lorsque l'attribut donné change.

Renvoie un événement qui se déclenche lorsque l'attribut donné change.

Cette méthode renvoie un dictionnaire de paires clé-valeur pour chaque attribut où la clé est le nom de l'attribut et la valeur est une valeur non `nil` .

  Par exemple, le fragment de code suivant affiche les attributs et les valeurs d'une instance :

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)
  part:SetAttribute("CanUse", true)

  for name, value in part:GetAttributes() do
  	print(name .. " = " .. value)
  end
  ```

  Voir aussi `Class.Instance:GetAttribute()` qui renvoie la valeur qui a été attribuée au nom d'attribut donné.

Instance:GetAttributes

Un dictionnaire de paires de chaîne → variantes pour chaque attribut où la chaîne est le nom de l'attribut et la variante est une valeur non nulle.

Renvoie un dictionnaire des attributs de l'instance.

The below would print the name of all objects currently in Workspace when ran.

Renvoie un tableau (une table numérotée) contenant tous les enfants directs de l'instance, ou chaque `Class.Instance` dont le `Class.Instance.Parent|Parent` est égal à l'objet.L'array peut être itérée en utilisant un boucle for numérique ou générique :

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Exemple de boucle for numérique
  local children = Workspace:GetChildren()
  for i = 1, #children do
  	local child = children[i]
  	print(child.Name .. " is child number " .. i)
  end
  ```

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Exemple générique de boucle while
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  Les enfants sont triés par l'ordre dans lequel leur propriété `Class.Instance.Parent|Parent` a été définie à l'objet.

  Voir aussi la fonction `Class.Instance:GetDescendants()|GetDescendants`.

Instance:GetChildren

Un tableau contenant les enfants de l'instance.

Renvoie un tableau contenant tous les enfants de l'instance.

Renvoie une chaîne codée de l'ID de débogage utilisé internement par Roblox. Notez que :

  *   Cet élément est protégé. Tenter de l'utiliser dans un `Class.Script` ou `Class.LocalScript` provoquera une erreur.
  *   Un ID de débogage est un ID utilisé dans les processus de débogage.Il permet à un débogueur de lire chaque instruction avant qu'une application ne la traite.Tous les objets dans Roblox agissent comme des processus et chaque instruction d'exécution (ou «code») qui peut être débogée si nécessaire.
  *   Cela peut être utile pour les plugins qui doivent distinguer des objets similaires les uns des autres (tels que les objets qui partagent le même nom).

Instance:GetDebugId

scopeLength

Renvoie une chaîne codée de l'ID de débogage utilisé internement par Roblox.

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.

Cette méthode d'objet renvoie une liste qui contient tous les descendants de cet objet.Contrairement à `Class.Instance:GetChildren()`, qui ne renvoie que les enfants immédiats d'un objet, cette méthode trouve chaque enfant de l'objet, chaque enfant de ces enfants, et ainsi de suite.

Instance:GetDescendants

Un tableau contenant les descendants de l'instance.

Renvoie un tableau contenant tous les descendants de l'instance.

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.

This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.

Renvoie une chaîne décrivant l'ascendance de l'instance.La chaîne est une concaténation du `Class.Instance.Name|Name` de l'objet et de ses ancêtres, séparée par des périodes.Le `Class.DataModel` ( `game` ) n'est pas pris en compte.Par exemple, un `Class.Part` dans le `Class.Workspace` peut retourner `Class.Workspace.Part`.

  Lorsqu'on appelle sur un `Class.Instance` qui n'est pas un descendant du `Class.DataModel` , cette fonction prend en compte tous les ancêtres jusqu'à et y compris le plus ancien sans `Class.Instance.Parent|Parent` .

  Cette fonction est utile pour l'enregistrement et le débogage.Vous ne devriez pas essayer d'analyser la chaîne renvoyée pour toute opération utile ; cette fonction n'échappe pas les périodes (ou tout autre symbole) dans les noms d'objets.En d'autres termes, bien que son résultat semble souvent être un identifiant Luau valide, il n'est pas garanti.

Instance:GetFullName

Renvoie une chaîne décrivant l'ascendance de l'instance.

Cette méthode renvoie la valeur stylée ou explicitement modifiée de la propriété spécifiée, ou la valeur par défaut de la propriété si elle n'a pas été stylée/modifiée.Cela diffère légèrement de l'accès à la valeur de propriété directement, comme `[GuiObject].Rotation` , qui renvoie la valeur par défaut ou modifiée de la propriété.

  ```lua
  local Players = game:GetService("Players")
  local ReplicatedStorage = game:GetService("ReplicatedStorage")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")

  local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
  local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
  rule.Selector = "TextButton"

  -- Référence à un bouton
  local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

  print(button:GetStyled("Rotation")) --> 0 (valeur par défaut)
  print(button.Rotation) --> 0 (valeur par défaut)

  -- Appliquer la rotation via la propriété règle de style
  rule:SetProperty("Rotation", 30)

  print(button:GetStyled("Rotation")) --> 30 (valeur stylée basée sur la règle)
  print(button.Rotation) --> 0 (valeur par défaut)

  -- Modifier/annuler explicitement la propriété style
  button.Rotation = 45

  print(button:GetStyled("Rotation")) --> 45 ( valeur modifiée )
  print(button.Rotation) --> 45 (modified value)
  ```

Instance:GetStyled

La valeur style ou explicitement modifiée de la propriété spécifiée, ou la valeur de propriété par défaut si elle n'a pas été style/modifiée.

Renvoie la valeur stylée ou explicitement modifiée de la propriété spécifiée, ou la valeur de propriété par défaut si elle n'a pas été stylée/modifiée.

Instance

`Instance` est la classe de base pour toutes les classes dans la hiérarchie de classe Roblox qui peuvent faire partie de l'arbre `Class.DataModel`.

VRService

Échantillons de code

Résumé

Propriétés

Méthodes

Événements

Propriétés

Méthodes

Événements