Interactions Sociales

Votre avatar est votre identité dans tout espace que vous entrez. Le module Interactions Sociales développeur permet à chaque utilisateur de mieux s'exprimer et de bouger naturellement, ajoutant une touche de réalisme à l'expérience.

Ce module comprend les fonctionnalités suivantes :

Utilisation du Module

Installation

Pour utiliser le module Interactions Sociales dans une expérience :

1. Dans le menu Fenêtre de Studio ou la barre d'outils de l'onglet Accueil, ouvrez la Boîte à Outils et sélectionnez l'onglet Magasin de Créateurs.

   

2. Assurez-vous que le tri Modèles est sélectionné, puis cliquez sur le bouton Voir Tout pour Catégories.

   

3. Localisez et cliquez sur la tuile Packages.

4. Localisez le module Interactions Sociales et cliquez dessus, ou faites-le glisser et déposez-le dans la vue 3D.

   

5. Dans la fenêtre Explorateur, déplacez l'ensemble du modèle Interactions Sociales dans ReplicatedStorage. Dès que l'expérience sera lancée, le module commencera à fonctionner.

Configuration

Insérer simplement le module Interactions Sociales activera à la fois les fonctionnalités d'orientation du corps et d'animations de chat dans votre endroit. Pour ajuster le comportement par défaut :

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

   

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

   LocalScript
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage.SocialInteractions)
   
   -- Rendre la rotation de la taille plus prononcée et désactiver la fonctionnalité d'animations de chat
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Mots Déclencheurs pour les Animations de Chat

La liste des "mots déclencheurs" qui activent chaque animation de chat est configurable et les motifs de chaînes 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 suffisent à déclencher l'animation.

Notez également que les mots déclencheurs sont insensibles à la casse, donc taper hey est identique à HEY, Hey, et d'autres variations.

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, le LocalScript suivant lie l'animation Inclinaison avec le motif de chaîne de cra+zy pour prendre en charge des mots déclencheurs comme crazy et craaaaaazy. Il enregistre également un motif de chaîne supplémentaire de coo+l pour l'animation Applaudir pour prendre en charge des mots comme cool et coooool.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Enregistrer le motif de chaîne pour l'animation "Inclinaison"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- Enregistrer un motif de chaîne supplémentaire pour l'animation "Applaudir"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

Référence API

Fonctions

configurer

Remplace les options de configuration par défaut via les clés/valeurs suivantes dans la table config. Cette fonction ne peut être appelée que depuis un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Rendre la rotation de la taille plus prononcée et désactiver la fonctionnalité d'animations de chat
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setTriggerWordsForChatAnimation

Enregistre une nouvelle animation dans la fonctionnalité d'animation de chat. Taper tout mot correspondant à un motif de chaîne inclus dans la table triggerWords activera l'animation dont l'ID est transmis en premier paramètre.

Notez que les mots déclencheurs sont insensibles à la casse pour les joueurs, donc un motif de woah acceptera des phrases de chat comme woah, WOAH, Woah, et d'autres variations.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Enregistrer un nouveau motif de chaîne pour une animation personnalisée
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

Evénements

onChatAnimationPlayed

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 comme arguments. Cet événement ne peut être connecté qu'un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
	print(animationId, triggerWord)
end)