Émotions

Les émotions sont des animations expressives de personnage qui peuvent être accessibles en utilisant des commandes de chat ("/e cheer") ou en accédant au menu des émotions en haut à droite de n'importe quel jeu. Tous les utilisateurs ont accès aux émotions par défaut, telles que danser, pointer, et applaudir. Des émotions d'avatar supplémentaires peuvent être achetées et équipées depuis le Marché.

Dans votre jeu, vous pouvez effectuer les personnalisation d'émotions suivantes :

• Ouvrir et fermer le menu des émotions d'un utilisateur par programme.
• Ajouter ou retirer des options d'émotions du menu d'un utilisateur.
• Désactiver l'accès au menu.
• Jouer une émotion, ciblant un personnage utilisateur spécifique.

Menu des émotions

Vous pouvez ouvrir et fermer manuellement le menu des émotions d'un utilisateur, personnaliser le menu pour afficher des émotions spécifiques, ou désactiver complètement le menu.

Ouvrir et fermer

Pour ouvrir ou fermer manuellement le menu des émotions d'un joueur, appelez GuiService:SetEmotesMenuOpen() avec une valeur booléenne de vrai ou faux.

Le code d'exemple suivant ouvrira le menu des émotions pour l'utilisateur :

-- Ouvrir le Menu des émotions
local GuiService = game:GetService("GuiService")
GuiService:SetEmotesMenuOpen(true)

Si vous devez détecter si le menu des émotions est ouvert, appelez GuiService:GetEmotesMenuOpen(). Cela renvoie un booléen indiquant l'état actuel du menu.

Ajouter et retirer des émotions

Personnalisez le menu des émotions en définissant des émotions à partir du catalogue et en équipant ensuite des émotions à un Humanoid. Définissez des émotions avec la méthode HumanoidDescription:SetEmotes() et équipez jusqu'à 8 émotions dans le menu des émotions en utilisant HumanoidDescription:SetEquippedEmotes().

Utilisez le code d'exemple suivant dans un LocalScript au sein du dossier StarterCharacterScripts pour définir et équiper des émotions dans votre jeu :

local Players = game:GetService("Players")
local humanoid = Players.LocalPlayer.Character.Humanoid
local humanoidDescription = humanoid.HumanoidDescription

-- Définir des émotions personnalisées dans une table
local emoteTable = {
  ["Bonjour"] = {3576686446},
  ["Stade"] = {3360686498},
  ["Inclinaison"] = {3360692915},
  ["Haussement d'épaules"] = {3576968026},
  ["Saluer"] = {3360689775},
  ["Pointer"] = {3576823880}
}
humanoidDescription:SetEmotes(emoteTable)

-- Équiper des émotions dans un ordre spécifique
local equippedEmotes = {"Bonjour", "Stade", "Inclinaison", "Haussement d'épaules", "Saluer", "Pointer"}
humanoidDescription:SetEquippedEmotes(equippedEmotes)

Désactiver

Désactivez le menu des émotions avec StarterGui:SetCoreGuiEnabled(). Désactiver le menu des émotions n'empêchera pas les émotions d'être effectuées via une commande de chat.

Le code d'exemple suivant désactivera le menu des émotions :

local StarterGui = game:GetService("StarterGui")
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.EmotesMenu, false)

En plus de désactiver le menu, vous pouvez désactiver le chargement des émotions appartenant à l'utilisateur en définissant la propriété StarterPlayer.UserEmotesEnabled à l'intérieur de StarterPlayer ⟩ Character sur false. Cette propriété spécifique ne peut être définie qu'en Studio et ne peut pas être définie par des scripts.

Jouer des émotions

Pour jouer manuellement une émotion qu'un personnage a dans sa HumanoidDescription, appelez Humanoid:PlayEmote(), en passant le nom de chaîne de l'émotion. Cet appel renverra vrai pour indiquer que l'émotion a été jouée avec succès, ou faux sinon.

Utilisez le code d'exemple suivant pour jouer l'émotion Haussement d'épaules :

local Players = game:GetService("Players")
local humanoid = Players.LocalPlayer.Character.Humanoid

humanoid:PlayEmote("Haussement d'épaules")