Votre avatar est votre identité dans n'importe quel espace que vous saisir.Le module développeur des interactions sociales laisse chaque utilisateur s'exprimer mieux et ses mouvements naturels, en ajoutant une touche de réalisme à l'expérience.
Ce module inclut les fonctionnalités suivantes :
Orientation du corps | Fait que le visage de l'avatar de tout le monde pointe vers la caméra de son utilisateur correspondant, grâce à un mélange de rotation du cou et de la taille.Cela fournit un indice subtil quant à qui ou quoi quelqu'un d'autre interagit. |
Animations de chat | Ajoute un peu de vivacité au chat dans l'expérience en faisant jouer ponctuellement des animations aux avatars, en fonction du contenu des messages qu'ils envoyer à.La liste des « mots déclencheurs » qui activent chaque animation est configurable. |
Utilisation du module
Étabissement
Pour utiliser le module Interactions sociales dans une expérience :
Assurez-vous que le tri des modèles est sélectionné, puis cliquez sur le bouton Voir tout pour les catégories .
Localisez et cliquez sur la case modules de développement .
Localisez le module interactions sociales et cliquez dessus, ou glissez-déposez-le dans la voir3D.
Dans la fenêtre Explorateur, déplacez l'ensemble du modèle interactions sociales dans ServerScriptService .Une fois l'expérience exécutée, le module se distribuera à différents services et commencera à fonctionner.
Configération
En insérant simplement le module interactions sociales , vous activerez à la fois la fonctionnalité orientation du corps et animations de chat à l'intérieur de votre emplacement.Pour ajuster le comportement par défaut :
Dans StarterPlayerScripts , créez un nouveau LocalScript et renommez-le en Configurer les interactions sociales .
Collez le code suivant dans le nouveau script, en utilisant la fonction configurer pour personnaliser le comportement du module.
Lecteur localScriptlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Rendre la rotation de la taille plus prononcée et désactiver la fonctionalitéd'animation de chatSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
Mots déclencheurs d'animation de chat
La liste des « mots déclencheurs » qui activent chaque animation de chat est configurable et les modèles de chaîne Luau sont utilisés pour augmenter les mots reconnaissables.Par exemple, une combinaison utilisée par l'animation Vague est he+y+o*, ce qui signifie que hey, heyyy, heyo, heyyyyo, heeeeyyyyo et d'autres variations se qualifient pour déclencher l'animations.
Notez également que les mots déclencheurs sont insensibles à la casse, donc le tapage de est le même que , , et d'autres variations.
Animation | ID d'animation | Motifs de mots |
---|---|---|
Vague | 3344650532 > | hell+o+ h+i+o* wa+[sz]+u+p+ y+o+ greetings* salutations* goo+d+%smorning+ he+y+o* howdy+ what's*%s*up+ |
Applauder | 5911729486 > | ya+y+ h[ou]+r+a+y+ woo+t* woo+h+oo+ bravo+ congratulations+ congrats+ gg pog+ poggers+ |
Accepter | 4841397952 > | ye+s* ye+a+h* y[eu]+p+ o+k+ o+k+a+y+ |
Ne pas être d'accord | 4841401869 > | no+ no+pe+ yi+ke+s+ |
Haussement | 3334392772 > | not+%s+sure+ idk+ don't%s+know+ i%s+don't%s+know+ who+%s+knows+ |
Rire | 3337966527 > | lo+l+ rof+l+ ha[ha]* he[he]+ |
Sommeil | 4686925579 > | zzz+ yawn+ |
La liste des mots déclencheurs qui activent chaque animation est configurable, et des animations supplémentaires peuvent être ajoutées via la fonction setTriggerWordsForChatAnimation.Par exemple, les liens suivants LocalScript lient l'animation Tilt avec le motif de chaîne de cra+zy pour soutenir les mots déclencheurs comme crazy et craaaaaazy .Il enregistre également un modèle de chaîne supplémentaire de coo+l pour l'animation Applaudir pour soutenir des mots comme cool et coooool .
Lecteur localScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Enregistrer le motif de chaîne pour l'animations"Inclinaison"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})-- Enregistrer un modèle de chaîne supplémentaire pour l'animations"Applaud"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})
Référence API
Fonctions
configurer
configurer(config: table )
Remplacements des options de configuration par défaut via les clés/ valeurs suivantes dans la table config .Cette fonction ne peut être appelée qu'à partir d'un LocalScript .
Clé | Avertissement | Par défaut |
---|---|---|
useBodyOrientation | Active la fonctionalité orientation du corps . | vrai |
waistOrientationWeight | L'orientation du corps utilise un mélange de rotation de la taille et du cou ; ce paramètre détermine lequel des deux est prévalent.Une valeur de 1 places souligne complètement la taille alors que 0 places soulignent complètement le cou. | 0.5 |
useChatAnimations | Active la fonctionalité animations de chat . | vrai |
useDefaultTriggerWordsForChatEmotes | Les animations de chat viennent avec une liste par défaut de mots déclencheurs.Définissez ce paramètre à false si vous souhaitez les désactiver et fournir les posséder. | vrai |
Lecteur localScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Rendre la rotation de la taille plus prononcée et désactiver la fonctionalitéd'animation de chatSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
définir les mots déclencheurs pour l'animation de chat
setTriggerWordsForChatAnimation(animationId : string , triggerWords: table )
Enregistre une nouvelle animation dans la fonctionnalité d'animation fonctionalitéchat.Taper n'importe quel mot qui correspond à un modèle de chaîne inclus dans la table triggerWords activera l'animation dont l'ID est passé en tant que premier paramètre.
Notez que les mots déclencheurs sont insensibles à la casse pour les joueurs, donc un modèle de woah acceptera des phrases de chat de woah , WOAH , Woah et d'autres variations.
Lecteur localScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Enregistrer un nouveau modèle de chaîne pour une animationspersonnaliséeSocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554",{"cra+zy", "woah+"})
Événements
onChatAnimationJouée
Se déclenche lorsqu'une animation de chat est jouée.La fonction connectée reçoit l'ID d'animation et le mot qui a déclenché l'animation en tant qu'arguments.Cet événement ne peut être connecté qu'en LocalScript .
Paramètres | |
---|---|
animationId : string | ID d'animation qui a joué. |
triggerWord : string | Mot de chat qui a déclenché l'animations. |
Lecteur localScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
print(animationId, triggerWord)
end)