Interactions sociales

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

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 :

  1. À partir de l'Affichage onglet, ouvrez la boîte à outils et sélectionnez l' boutique des créateurs onglet.

    Toolbox toggle button in Studio
  2. Assurez-vous que le tri par Modèles est sélectionné, puis cliquez sur le bouton Voir tout pour Catégories.

  3. Localisez et cliquez sur la case modules de pavé .

  4. Localisez le module Interactions sociales et cliquez dessus, ou glissez-le dans la voir3D.

  5. 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 :

  1. Dans StarterPlayerScripts , créez un nouveau LocalScript et renommez-le en ConfigureSocialInteractions .

  2. Collez le code suivant dans le nouveau script, en utilisant la fonction configurer pour personnaliser le comportement du module.

    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 chat
    SocialInteractions.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.

AnimationID de l'animationMotifs de mot
Vague3344650532

hell+o+     h+i+o*    

Féliciter5911729486

ya+y+     h[ou]+r+a+y+     woo+

Accepter4841397952

ye+s*>     ye+a+h*     y[eu]+p+     0> o+k+0>     ye+s*3>

D'accord4841401869

no+     no+pe+     yi+ke+s+

Râble3334392772

not+%s+sure+     idk+     don't%s+know+    0> i%s+don't%s+know+0>    not+%s+sure+3>

Rire3337966527

lo+l+     rof+l+    ha[ha]*    0> he[he+0>

Dormir4686925579

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éDescriptionPar défaut
useBodyOrientationBascule la fonctionalité orientation du corps .vrai
waistOrientationWeightL'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
useChatAnimationsBascule la fonctionalité animations de chat .vrai
useDefaultTriggerWordsForChatEmotesLes 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 chat
SocialInteractions.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ée
SocialInteractions.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 : stringID d'animation qui a joué.
trigger Word : stringMot 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)