Système de sommeil

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Chaque assemblage dans le moteur Roblox correspond à un corps rigide unique. La position et la vitesse de chaque corps rigide décrivent où il se trouve et à quelle vitesse il se déplace, et l'une des tâches principales du moteur est de mettre à jour les positions et les vitesses de chaque assemblage.

Les assemblages peuvent être connectés ensemble avec des contraintes mécaniques et des contraintes de mouvement pour former des mécanismes tels que des voitures ou des avions. À mesure que le nombre d'assemblages et de contraintes dans un mécanisme augmente, le temps nécessaire pour simuler le mécanisme augmente également. Heureusement, cette augmentation est compensée lorsque le système de sommeil détermine que le moteur peut ignorer la simulation des assemblages non mobiles.

États de sommeil

Chaque assemblage peut être dans l'un des trois états : éveillé, endormi ou vérification de sommeil.

Éveillé

Un assemblage éveillé est en mouvement ou en accélération, et est donc simulé. Les assemblages entrent dans cet état à partir des situations décrites dans endormi et vérification de sommeil, ainsi que des situations de réveil supplémentaires.

Endormi

Un assemblage endormi n'est ni en mouvement ni en accélération, et n'est donc pas simulé.

Un assemblage est déterminé comme non mobile en vérifiant sa vitesse linéaire et sa vitesse de rotation. Si sa vitesse linéaire est inférieure au seuil de Vitesse linéaire et que sa vitesse de rotation est inférieure au seuil de Vitesse de rotation, l'assemblage est considéré comme non mobile.

Dans certains cas, vérifier simplement l'absence de mouvement pourrait amener un assemblage à entrer incorrectement dans l'état de sommeil. Par exemple, si une balle est lancée directement vers le haut, sa vitesse approche de zéro lorsqu'elle atteint sa hauteur maximale, ce qui en fait un candidat pour dormir et ne jamais retomber. Pour gérer de tels cas, le moteur considère un assemblage comme étant en accélération si son accélération linéaire ou son accélération de rotation sont supérieures aux seuils de Vitesse linéaire et Vitesse de rotation, respectivement, et empêchera l'assemblage de s'endormir.

Vérification de sommeil

Un assemblage non mobile qui partage une contrainte avec au moins un assemblage éveillé est placé dans l'état de vérification de sommeil et n'est pas simulé. À chaque étape du monde, un assemblage en vérification de sommeil vérifie si :

Si l'une de ces conditions est vraie, ou dans l'une des situations de réveil supplémentaires, l'assemblage en vérification de sommeil entre dans l'état éveillé.

Référence des seuils

Le tableau suivant fournit les différents seuils de vitesse et d'accélération utilisés pour déterminer si un assemblage est en mouvement ou en accélération.

SeuilValeurChangement d'état
Vitesse Linéaire0.33 studs/séveillé ⟩ endormi
Vitesse de Rotation0.42 studs/séveillé ⟩ endormi
Accélération Linéaire0.24 studs/s²éveillé ⟩ endormi
Accélération de Rotation0.24 studs/s²éveillé ⟩ endormi
Vitesse Linéaire Voisine0.48 studs/svérification de sommeil ⟩ éveillé
Vitesse de Rotation Voisine0.59 studs/svérification de sommeil ⟩ éveillé
Réveil Accélération Linéaire16.9 studs/s²éveillé ⟩ endormi
Réveil Accélération de Rotation16.9 studs/s²éveillé ⟩ endormi

Les seuils de vitesse et d'accélération de rotation reflètent la vitesse et l'accélération d'un point situé sur la sphère englobante de l'assemblage (une sphère qui contient toutes les parties d'un assemblage) qui se déplace rigidement avec l'assemblage.

Joints actionnés

Parfois, les développeurs souhaitent déplacer des parties très lentement à l'aide d'un joint actionné, une contrainte qui applique une force ou un mouvement pour entraîner des parties connectées, comme un HingeConstraint utilisant un Motor. Pour prendre en charge ces scénarios, les assemblages connectés à des joints actionnés utilisent un seuil de vitesse de sommeil plus strict. Cela retarde le moment où ces assemblages s'endorment, permettant un mouvement lent et contrôlé sans que le système physique ne les mette prématurément au sommeil.

Les éléments suivants sont considérés comme des joints actionnés :

Situations de réveil supplémentaires

En plus des situations décrites dans vérification de sommeil et endormi, un assemblage entre dans l'état éveillé lorsque :

Visualisation de débogage

Lors des tests de jeu, vous pouvez visualiser les états de sommeil des assemblages en activant les Pièces éveillées depuis le widget Options de visualisation dans le coin supérieur droit de la vue 3D.

Une vue rapprochée de la vue 3D avec le bouton Options de visualisation indiqué dans le coin supérieur droit.

Une fois activé, les pièces simulées seront entourées par leur état de sommeil actuel, avec les pièces éveillées entourées de rouge, les pièces vérification de sommeil entourées d'orange, et les pièces endormies non entourées.

Pièces simulées entourées par la couleur représentant leur état de sommeil actuel
©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.