Tu avatar es tu identidad en cualquier espacio al que introducir.El módulo Interacciones sociales desarrollador permite que cada usuario se exprese mejor y sus movimientos naturales, añadiendo un toque de realismo a la experiencia.
Este módulo incluye las siguientes características:
Orientación del cuerpo | Hace que la cara del avatar de todos apunte a la cámara de su usuario correspondiente, a través de una mezcla de rotación de cuello y cintura.Esto proporciona una pista sutil de quién o con qué alguien más está interactuando. |
Animaciones de chat | Añade algo de dinamismo al chat en la experiencia haciendo que los avatares ocasionalmente reproduzcan animaciones, dependiendo del contenido de los mensajes que enviar.La lista de "palabras de activación" que activan cada animación es configurable. |
Uso del módulo
Instalación
Para usar el módulo Interacciones sociales en una experiencia:
Asegúrese de que la clasificación de modelos esté seleccionada, luego haga clic en el botón Ver todo para categorías .
Localiza y haz clic en el mosaico Módulos de desarrollo .
Localice el módulo Interacciones sociales y haga clic en él, o arrástrelo a la vista 3D.
En la ventana Explorador, mueva todo el modelo Interacciones sociales en Servicio de guión del servidor .Al ejecutar la experiencia, el módulo se distribuirá a varios servicios y comenzará a funcionar.
Configuración
Simplemente insertando el módulo Interacciones sociales activará tanto la función de orientación del cuerpo como las animaciones de chat dentro de tu lugar.Para ajustar el comportamiento predeterminado:
En StarterPlayerScripts , crea un nuevo LocalScript y renómlalo a Configurar interacciones sociales .
Pega el siguiente código en el nuevo script, usando la función configurar para personalizar el comportamiento del módulo.
Guión locallocal ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Hacer que la rotación de la cintura sea más pronunciada y desactivar la función de animaciones de chatSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
Palabras de activación de animación de chat
La lista de "palabras de activación" que activan cada animación de chat es configurable y se utilizan los patrones de cadena Luau para aumentar las palabras reconocibles.Por ejemplo, una combinación utilizada por la animación de ola es he+y+o* , lo que significa que hey , heyyy , heyo , heyyyyo , heeeeyyyyo , y otras variaciones califican para activar la animaciones.
Tenga en cuenta también que las palabras de activación son insensibles a mayúsculas , por lo que escribir hey es lo mismo que HEY, Hey y otras variaciones.
Animación | ID de animación | Patrones de palabra |
---|---|---|
Ola | 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+ |
Aplaudir | 5911729486 | ya+y+ h[ou]+r+a+y+ woo+t* woo+h+oo+ bravo+ congratulations+ congrats+ gg pog+ poggers+ |
Aceptar | 4841397952 | ye+s* ye+a+h* y[eu]+p+ o+k+ o+k+a+y+ |
No estar de acuerdo | 4841401869 | no+ no+pe+ yi+ke+s+ |
Encogerse de hombros | 3334392772 | not+%s+sure+ idk+ don't%s+know+ i%s+don't%s+know+ who+%s+knows+ |
Reír | 3337966527 | lo+l+ rof+l+ ha[ha]* he[he]+ |
Dormir | 4686925579 | zzz+ yawn+ |
La lista de palabras de gatillo que activan cada animación es configurable, y se pueden agregar animaciones adicionales a través de la función setTriggerWordsForChatAnimation.Por ejemplo, los siguientes LocalScript enlaces vinculan la animación Inclinación con el patrón de cadena de cra+zy para soportar palabras de gatillo como crazy y craaaaaazy .También registra un patrón de cadena adicional de coo+l para la animación Aplaudir para apoyar palabras como cool y coooool .
Guión local
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Registrar patrón de cadena para la animaciones"Inclinación"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})-- Registre un patrón de cadena adicional para la animaciones"Applaud"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})
Referencia de API
Funciones
configurar
configurar(config: table )
Anula las opciones de configuración predeterminadas a través de las siguientes claves/valores en la tabla config.Esta función solo se puede llamar desde un LocalScript .
Clave | Descripción | Por defecto |
---|---|---|
useBodyOrientation | Alterna la función de orientación del cuerpo . | cierto |
waistOrientationWeight | La orientación del cuerpo utiliza una mezcla de rotación de la cintura y el cuello; este parámetro determina cuál de los dos es prevalente.Un valor de 1 lugares completa el énfasis en la cintura mientras 0 lugares completan el énfasis en el cuello. | 0.5 |
useChatAnimations | Alterna la función de animaciones de chat . | cierto |
useDefaultTriggerWordsForChatEmotes | Las animaciones de chat vienen con una lista predeterminada de palabras de activación.Establezca este parámetro en false si desea desactivarlos y proporcionar los en posesión. | cierto |
Guión local
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Hacer que la rotación de la cintura sea más pronunciada y desactivar la función de animaciones de chatSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
establecer palabras de gatillo para la animación de chat
setTriggerWordsForChatAnimation(animationId: string , triggerWords: table )
Registra una nueva animación en la función de animación de chat.Escribir cualquier palabra que coincida con un patrón de cadena incluido en la tabla triggerWords activará la animación cuyo ID se pasa como primer parámetro.
Tenga en cuenta que las palabras de activación son insensibles a mayúsculas para los jugadores, por lo que un patrón de woah aceptará frases de chat de woah , WOAH , Woah y otras variaciones.
Guión local
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Registre un nuevo patrón de cadena para una animacionespersonalizadaSocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554",{"cra+zy", "woah+"})
Eventos
enChatAnimaciónJugada
Se enciende cuando se reproduce una animación de chat.La función conectada recibe la ID de la animación y la palabra que activó la animación como sus argumentos.Este evento solo se puede conectar en un LocalScript .
Parámetros | |
---|---|
animationId: string | ID de animación que se reprodujo. |
palabra de activación: string | Palabra de chat que activó la animaciones. |
Guión local
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
print(animationId, triggerWord)
end)