Interações Sociais

Seu avatar é sua identidade em qualquer espaço que você inserir/digitar.O módulo de desenvolvedor Interações Sociais permite que cada usuário se exprese melhor e seus movimentos naturais, adicionando um toque de realismo à experiência.

Este módulo inclui as seguintes características:

Uso do Módulo

Instalação

Para usar o módulo Interações Sociais em uma experiência:

1. Da aba Ver, abra a Caixa de Ferramentas e selecione a aba Loja do Criador .

   

2. Certifique-se de que a classificação Modelos está selecionada, então clique no botão Ver Todos para Categorias .

   

3. Localize e clique no tijolo Dev Modules .

   

4. Localize o módulo Interações Sociais e clique nele ou arraste-o para a ver3D.

   

5. Na janela Explorer, mova todo o modelo Interações Sociais para Serviço de Script de Servidor .Ao executar a experiência, o módulo se distribuirá a vários serviços e começará a funcionar.

   

Configuração

Simplesmente inserindo o módulo Interações Sociais, você habilitará tanto a orientação do corpo quanto as animações de chat dentro do seu local.Para ajustar o comportamento padrão:

1. Em StarterPlayerScripts , crie um novo LocalScript e renomeie-o para Configurar Interações Sociais .

   

2. Cole o seguinte código no novo script, usando a função configurar para personalizar o comportamento do módulo.

   LocalScript
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
   
   -- Faça a rotação da cintura mais pronunciada e desative a funcionalidade de animações de chat
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Palavras de Ativação de Animação de Bate-papo

A lista de "palavras de gatilho" que ativam cada animação de chat é configurável e padrões de corda Luau são utilizados para aumentar palavras reconhecíveis.Por exemplo, uma combinação usada pela animação Onda é he+y+o* , o que significa que hey , heyyy , heyo , heyyyyo , heeeeyyyyo e outras variações se qualificam para ativar a animações.

Observe também que as palavras de gatilho são insensíveis a maiúsculas , então digitar hey é o mesmo que HEY, Hey e outras variações.

A lista de palavras de gatilho que ativam cada animação é configurável, e animações adicionais podem ser adicionadas através da função setTriggerWordsForChatAnimation.Por exemplo, os seguintes LocalScript links ligam a animação Inclinação com o padrão de corda de cra+zy para suportar palavras de gatilho como crazy e craaaaaazy .Ele também registra um padrão de corda adicional de coo+l para a animação Applaud para suportar palavras como cool e coooool .

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

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- Registrar padrão de string para a animações"Inclinação"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- Registre padrão de corda adicional para a animações"Applaud"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

Referência da API

Funções

configurar

Substitui as opções de configuração padrão através das seguintes chaves/valores na tabela config.Essa função só pode ser chamada a partir de um LocalScript .

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

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- Faça a rotação da cintura mais pronunciada e desative a funcionalidade de animações de chat
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

definir palavras de gatilho para animação de chat

Registra uma nova funcionalidadena função de animação de chat.Digitar qualquer palavra que corresponda a um padrão de string incluído na tabela triggerWords ativará a animação cujo ID é passado como o primeiro parâmetro.

Observe que as palavras de gatilho são insensíveis ao caso para os jogadores, então um padrão de woah aceitará frases de chat de woah , WOAH , Woah e outras variações.

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

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- Registre um novo padrão de corda para uma animaçõespersonalizada
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

Eventos

emChatAnimação Jogada

Dispara quando uma animação de chat é reproduzida.A função conectada recebe o ID da animação e a palavra que disparou a animação como seus argumentos.Este evento só pode ser conectado em um LocalScript .

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

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

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