Votre avatar est votre identité dans n'importe quelle zone que vous saisir. Le module de développeur SocialInteractions ajoute à chaque utilisateur de mieux s'exprimer et de mieux s'exprimer, en ajoutant une touche de réalisme à l'expérience.
Ce module inclut les fonctionnalités suivantes :
Orientation du corps | Fait en sorte que le visage de l'avatar de chacun soit le visage de leur caméra correspondant, grâce à un mélange de rotation du cou et de la taille. Cela fournit une subtil cue sur qui ou ce que quelqu'un d'autre interagit avec. |
Animations de chat | Ajoute un peu de vivacité au chat dans l'expérience en faisant jouer des animations, en fonction du contenu des messages qu'ils envoyer à. La liste des « mots déclencheurs » qui activent chaque animation est configurable. |
Utilisation des modules
Installation
Pour utiliser le module SocialInteractions dans une expérience :
À partir de l'Affichage onglet, ouvrez la boîte à outils et sélectionnez l' boutique des créateurs onglet.
Assurez-vous que le tri par Modèles est sélectionné, puis cliquez sur le bouton Voir tout pour Catégories.
Localisez et cliquez sur la case modules de pavé .
Localisez le module Interactions sociales et cliquez dessus, ou glissez-le dans la voir3D.
Dans la fenêtre Explorateur, déplacez le modèle entier SocialInteractions dans ServerScriptService . Lors de l'exécution de l'expérience, le module se distribuera à différents services et commencera à s'exécuter.
Configuration
En insérant simplement le module SocialInteractions , vous activerez les fonctionnalités orientation du corps et animation 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 ConfigureSocialInteractions .
Collez le code suivant dans le nouveau script, en utilisant la fonction configurer pour personnaliser le comportement du module.
Script locallocal ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Faites la rotation de la taille plus prononcée et désactivez la fonctionalitéd'animations de chatSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
Mots-clés 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 Lua sont utilisés pour augmenter les mots reconnaissables. Par exemple, une combinaison utilisée par l'animationsWave est he+y+o*, ce qui sign
Notez également que les mots déclencheurs sont insensibles à la casse , donc le fait d'écrire hey est le même que HEY, 1> Hey1> et d'autres variantes.
Animation | ID de l'animation | Motifs de mot |
---|---|---|
Vague | 3344650532 | hell+o+ h+i+o* |
Féliciter | 5911729486 | ya+y+ h[ou]+r+a+y+ woo+ |
Accepter | 4841397952 | ye+s*> ye+a+h* y[eu]+p+ 0> o+k+0> ye+s*3> |
D'accord | 4841401869 | no+ no+pe+ yi+ke+s+ |
Râble | 3334392772 | not+%s+sure+ idk+ don't%s+know+ 0> i%s+don't%s+know+0> not+%s+sure+3> |
Rire | 3337966527 | lo+l+ rof+l+ ha[ha]* 0> he[he+0> |
Dormir | 4686925579 | zzz+ yawn+ |
La liste des mots déclencheurs qui activent chaque animation est configurable, et des animations supplémentaires peuvent
Script local
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Enregistre le motif de chaîne pour l'animations"Tilt"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})-- Enregistre un modèle de chaîne supplémentaire pour l'animations"Applaudissements"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})
Référence de l'API
Fonctions
configurer
configurer(config: Library.table)
Les options de configuration par défaut sont remplacées par les valeurs suivantes dans la table config. Cette fonction ne peut être appelée que depuis un LocalScript.
Clé | Description | Par défaut |
---|---|---|
useBodyOrientation | Bascule 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 place l'accent sur la taille alors que 0 places l'accent sur le cou. | 0.5 |
useChatAnimations | Bascule 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 sur false si vous souhaitez les désactiver et fournir le posséder. | vrai |
Script local
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Faites la rotation de la taille plus prononcée et désactivez la fonctionalitéd'animations de chatSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
setTriggerWordsForChatAnimation
setTriggerWordsForChatAnimation(animationId: string , triggerWords: table )
Enregistre une nouvelle animation dans la fonction d'animation de chat. Tapez n'importe quel mot qui correspond à un motif de chaîne inclus dans la table triggerWords activera l'animation dont l'ID est donné en tant que premier argument.
Notez que les mots déclencheurs sont insensibles à la casse pour les joueurs, donc un motif de woah acceptera les phrases de chat de woah, 1> WOAH1>, 4> Woah4>, et d'autres variantes.
Script local
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Enregistrez un nouveau motif de chaîne pour une animationspersonnaliséeSocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554",{"cra+zy", "woah+"})
Événements
sur la playlist de chat
Se déclenche lorsqu'une animation de chat s'exécute. La fonction connectée reçoit l'ID de l'animation et le mot qui a déclenché l'animation en tant que ses arguments. Cet événement ne peut être connecté qu'à un LocalScript .
Paramètres | |
---|---|
animationId : string | ID d'animation qui a joué. |
trigger Word : string | Mot de chat qui a déclenché l'animations. |
Script local
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
print(animationId, triggerWord)
end)