Interacciones sociales

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

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:

  1. Desde la pestaña Ver, abra la Caja de herramientas y seleccione la pestaña Tienda de creadores .

    Toolbox toggle button in Studio
  2. Asegúrese de que la clasificación de modelos esté seleccionada, luego haga clic en el botón Ver todo para categorías .

  3. Localiza y haz clic en el mosaico Módulos de desarrollo .

  4. Localice el módulo Interacciones sociales y haga clic en él, o arrástrelo a la vista 3D.

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

  1. En StarterPlayerScripts , crea un nuevo LocalScript y renómlalo a Configurar interacciones sociales .

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

    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 chat
    SocialInteractions.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ónID de animaciónPatrones de palabra
Ola3344650532

hell+o+     h+i+o*     wa+[sz]+u+p+     y+o+     greetings*     salutations*     goo+d+%smorning+     he+y+o*     howdy+     what's*%s*up+

Aplaudir5911729486

ya+y+     h[ou]+r+a+y+     woo+t*     woo+h+oo+     bravo+     congratulations+     congrats+     gg     pog+     poggers+

Aceptar4841397952

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

No estar de acuerdo4841401869

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

Encogerse de hombros3334392772

not+%s+sure+     idk+     don't%s+know+     i%s+don't%s+know+     who+%s+knows+

Reír3337966527

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

Dormir4686925579

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 .

ClaveDescripciónPor defecto
useBodyOrientationAlterna la función de orientación del cuerpo . cierto
waistOrientationWeightLa 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
useChatAnimationsAlterna la función de animaciones de chat .cierto
useDefaultTriggerWordsForChatEmotesLas 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 chat
SocialInteractions.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 animacionespersonalizada
SocialInteractions.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: stringID de animación que se reprodujo.
palabra de activación: stringPalabra 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)