Interazioni Sociali

Il tuo avatar è la tua identità in qualsiasi spazio tu entri. Il modulo SocialInteractions per sviluppatori consente a ciascun utente di esprimere meglio se stesso e i propri movimenti naturali, aggiungendo un tocco di realismo al gioco.

Questo modulo include le seguenti funzionalità:

Utilizzo del Modulo

Installazione

Per utilizzare il modulo SocialInteractions in un gioco:

1. Dal menu Finestra di Studio o dalla barra degli strumenti della scheda Home, apri il Toolbox e seleziona la scheda Negozio Creatori.

   

2. Assicurati che sia selezionato l'ordinamento Modelli, quindi fai clic sul pulsante Vedi Tutti per le Categorie.

   

3. Individua e fai clic sulla tessera Pacchetti.

4. Individua il modulo Interazioni Sociali e fai clic su di esso, oppure trascinalo nella vista 3D.

   

5. Nella finestra Esplora, sposta l'intero modello SocialInteractions in ReplicatedStorage. Una volta avviato il gioco, il modulo inizierà a funzionare.

Configurazione

Inserire semplicemente il modulo SocialInteractions abiliterà sia la funzionalità di orientamento del corpo che quella delle animazioni di chat all'interno del tuo luogo. Per regolare il comportamento predefinito:

1. In StarterPlayerScripts, crea un nuovo LocalScript e rinominalo in ConfiguraInterazioniSociali.

   

2. Incolla il seguente codice nel nuovo script, utilizzando la funzione configura per personalizzare il comportamento del modulo.

   LocalScript

   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage.SocialInteractions)
   
   -- Rendi la rotazione della vita più pronunciata e disabilita la funzionalità delle animazioni di chat
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Parole Chiave per le Animazioni di Chat

L'elenco delle "parole chiave" che attivano ciascuna animazione di chat è configurabile e vengono utilizzati modelli di stringa Luau per aumentare le parole riconoscibili. Ad esempio, una combinazione utilizzata dall'animazione Wave è he+y+o*, il che significa che hey, heyyy, heyo, heyyyyo, heeeeyyyyo e altre variazioni qualificano per attivare l'animazione.

Nota anche che le parole chiave sono non sensibili al maiuscolo, quindi digitare hey è lo stesso di HEY, Hey e altre variazioni.

L'elenco delle parole chiave che attivano ciascuna animazione è configurabile e animazioni aggiuntive possono essere aggiunte tramite la funzione setTriggerWordsForChatAnimation. Ad esempio, il seguente LocalScript collega l'animazione Tilt con il modello di stringa cra+zy per supportare parole chiave come crazy e craaaaaazy. Registra anche un modello di stringa aggiuntivo di coo+l per l'animazione Applaud per supportare parole come cool e coooool.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Registra il modello di stringa per l'animazione "Tilt"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- Registra il modello di stringa aggiuntivo per l'animazione "Applaud"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

Riferimento API

Funzioni

configure

Sovrascrive le opzioni di configurazione predefinite attraverso le seguenti chiavi/valori nella tabella config. Questa funzione può essere chiamata solo da un LocalScript.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Rendi la rotazione della vita più pronunciata e disabilita la funzionalità delle animazioni di chat
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setTriggerWordsForChatAnimation

Registra una nuova animazione nella funzionalità di animazione di chat. Digitare qualsiasi parola che corrisponde a un modello di stringa incluso nella tabella triggerWords attiverà l'animazione il cui ID è passato come primo parametro.

Nota che le parole chiave sono non sensibili al maiuscolo per i giocatori, quindi un modello di woah accetterà frasi di chat come woah, WOAH, Woah e altre variazioni.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Registra un nuovo modello di stringa per un'animazione personalizzata
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

Eventi

onChatAnimationPlayed

Si attiva quando viene riprodotta un'animazione di chat. La funzione connessa riceve l'ID dell'animazione e la parola che ha attivato l'animazione come argomenti. Questo evento può essere connesso solo in un LocalScript.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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