Émotes

Les emotes sont des animations expressives du personnage qui sont accessibles en utilisant les commandes de chat ("/e cheer") ou en accédant au menu des emotes en haut à droite de toute expérience.Tous les utilisateurs ont accès aux émotes par défaut, telles que danse , point et encouragement .Les émotes d'avatar supplémentaires peuvent être achetées et équipées à partir du marché.

Dans votre expérience, vous pouvez effectuer les modifications d'émote suivantes :

• Ouvrir et fermer le menu d'émotes d'un utilisateur de manière programmatique.
• Ajouter ou supprimer options d'émotes du menu d'un utilisateur.
• Désactiver l'accès au menu.
• Jouer une Emoteciblant un personnage d'utilisateur spécifique.

Menu des émotes

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

Ouvrir et fermer

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

L'exemple de code suivant ouvrira le menu d'émotes pour l'utilisateur :

-- Ouvrir le menu d'émote
local GuiService = game:GetService("GuiService")
GuiService:SetEmotesMenuOpen(true)

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

Ajouter et supprimer des emotes

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

Utilisez l'exemple de code suivant dans un LocalScript dans le dossier StarterCharacterScripts pour définir et équiper des emotes dans votre expérience :

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

-- Définir des emotes personnalisées dans une table
local emoteTable = {
  ["Hello"] = {3576686446},
  ["Stadium"] = {3360686498},
  ["Tilt"] = {3360692915},
  ["Shrug"] = {3576968026},
  ["Salute"] = {3360689775},
  ["Point"] = {3576823880}
}
humanoidDescription:SetEmotes(emoteTable)

-- Équiper les emotes dans un ordre spécifique
local equippedEmotes = {"Hello", "Stadium", "Tilt", "Shrug", "Salute", "Point"}
humanoidDescription:SetEquippedEmotes(equippedEmotes)

Désactiver

Désactivez le menu d'émotes avec StarterGui:SetCoreGuiEnabled() . La désactivation du menu d'émotes n'empêchera pas les émotes d'être exécutées avec une commande de chat.

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

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 emotes appartenant à l'utilisateur en définissant la propriété StarterPlayer.UserEmotesEnabled à l'intérieur de StarterPlayer > Personnage sur faux .Cette propriété spécifique ne peut être définie que dans Studio et ne peut pas être définie par des scripts.

Jouer des emotes

Pour jouer manuellement une emote que un personnage a dans son HumanoidDescription, appelez Humanoid:PlayEmote(), en passant le nom de la chaîne de l'Emote.Cet appel retournera vrai pour indiquer que l'émote a été jouée avec succès, ou faux autrement.

Utilisez l'exemple de code suivant pour jouer l'EmoteShrug :

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

humanoid:PlayEmote("Shrug")