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
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
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)