Interacciones Sociales

Tu avatar es tu identidad en cualquier espacio al que entres. El módulo de SocialInteractions desarrollador permite a cada usuario expresarse mejor y mostrar sus movimientos naturales, añadiendo un toque de realismo a la experiencia.

Este módulo incluye las siguientes características:

Uso del Módulo

Instalación

Para usar el módulo SocialInteractions en una experiencia:

1. Desde el menú Ventana de Studio o la barra de herramientas de la pestaña Inicio, abre el Toolbox y selecciona la pestaña Creator Store.

   

2. Asegúrate de que esté seleccionado el orden de Modelos, luego haz clic en el botón Ver Todo para Categorías.

   

3. Localiza y haz clic en el mosaico Paquetes.

4. Localiza el módulo Interacciones Sociales y haz clic en él, o arrástralo y suéltalo en la vista 3D.

   

5. En la ventana de Explorador, mueve todo el modelo SocialInteractions a ReplicatedStorage. Al ejecutar la experiencia, el módulo comenzará a funcionar.

Configuración

Simplemente insertar el módulo SocialInteractions habilitará tanto las funciones de orientación corporal como de animaciones de chat dentro de tu lugar. Para ajustar el comportamiento predeterminado:

1. En StarterPlayerScripts, crea un nuevo LocalScript y renómbralo a ConfigureSocialInteractions.

   

2. Pega el siguiente código en el nuevo script, utilizando la función configure para personalizar el comportamiento del módulo.

   LocalScript
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage.SocialInteractions)
   
   -- Hacer que la rotación de la cintura sea más pronunciada y desactivar la función de animaciones de chat
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Palabras Clave para Animaciones de Chat

La lista de "palabras clave" que activan cada animación de chat es configurable y se utilizan patrones de cadena Luau para aumentar las palabras reconocibles. Por ejemplo, una combinación utilizada por la animación Ola es he+y+o*, lo que significa que hey, heyyy, heyo, heyyyyo, heeeeyyyyo, y otras variaciones califican para activar la animación.

Ten en cuenta que las palabras clave son insensibles a mayúsculas y minúsculas, por lo que escribir hey es lo mismo que HEY, Hey, y otras variaciones.

La lista de palabras clave que activan cada animación es configurable, y se pueden añadir animaciones adicionales mediante la función setTriggerWordsForChatAnimation. Por ejemplo, el siguiente LocalScript vincula la animación Tilt con el patrón de cadena de cra+zy para soportar palabras clave como crazy y craaaaaazy. También registra un patrón de cadena adicional de coo+l para la animación Aplaudir para soportar palabras como cool y coooool.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Registrar patrón de cadena para la animación "Tilt"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- Registrar patrón de cadena adicional para la animación "Aplaudir"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

Referencia de API

Funciones

configure

Sobrescribe las opciones de configuración predeterminadas a través de las siguientes claves/valores en la tabla config. Esta función solo puede ser llamada desde un LocalScript.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Hacer que la rotación de la cintura sea más pronunciada y desactivar la función de animaciones de chat
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setTriggerWordsForChatAnimation

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 el primer parámetro.

Ten en cuenta que las palabras clave son insensibles a mayúsculas y minúsculas para los jugadores, por lo que un patrón de woah aceptará frases de chat como woah, WOAH, Woah, y otras variaciones.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Registrar nuevo patrón de cadena para una animación personalizada
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

Eventos

onChatAnimationPlayed

Se dispara cuando se reproduce una animación de chat. La función conectada recibe el 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.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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