Interações Sociais

Seu avatar é sua identidade em qualquer espaço que você entrar. O módulo SocialInteractions developer module permite que cada usuário se expresse melhor e realize movimentos naturais, adicionando um toque de realismo à experiência.

Este módulo inclui os seguintes recursos:

Uso do Módulo

Instalação

Para usar o módulo SocialInteractions em uma experiência:

1. No menu Janela do Studio ou na barra de ferramentas da aba Início, abra a Caixa de Ferramentas e selecione a aba Loja do Criador.

   

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

   

3. Localize e clique no bloco Pacotes.

4. Localize o módulo Interações Sociais e clique nele ou arraste e solte-o na visualização 3D.

   

5. Na janela Explorador, mova todo o modelo SocialInteractions para ReplicatedStorage. Ao executar a experiência, o módulo começará a ser executado.

Configuração

Simplesmente inserir o módulo SocialInteractions habilitará tanto os recursos de orientação corporal quanto de animações de chat dentro do seu lugar. Para ajustar o comportamento padrão:

1. Em StarterPlayerScripts, crie um novo LocalScript e renomeie-o para ConfigureSocialInteractions.

   

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

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

Palavras Gatilho para Animações de Chat

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

Note também que as palavras 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 gatilho que ativam cada animação é configurável, e animações adicionais podem ser adicionadas através da função setTriggerWordsForChatAnimation. Por exemplo, o seguinte LocalScript vincula a animação Tilt com o padrão de string cra+zy para suportar palavras gatilho como crazy e craaaaaazy. Ele também registra um padrão de string adicional de coo+l para a animação Aplaudir para suportar palavras como cool e coooool.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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

-- Registra padrão de string adicional para a animação "Aplaudir"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

Referência da API

Funções

configure

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

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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

setTriggerWordsForChatAnimation

Registra uma nova animação no recurso 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.

Note que as palavras gatilho são insensíveis a maiúsculas para os jogadores, então um padrão de woah aceitará frases de chat como woah, WOAH, Woah, e outras variações.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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

Eventos

onChatAnimationPlayed

Dispara quando uma animação de chat é tocada. A função conectada recebe o ID da animação e a palavra que ativou 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.SocialInteractions)

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