Interazioni Sociali

Il tuo avatar è la tua identità in qualsiasi spazio tu entri. Il modulo SocialInteractions developer module consente a ogni utente di esprimersi meglio e di muoversi in modo naturale, aggiungendo un tocco di realismo all'esperienza.

Questo modulo include le seguenti funzionalità:

Utilizzo del Modulo

Installazione

Per utilizzare il modulo SocialInteractions in un'esperienza:

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

   

2. Assicurati di avere 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 Explorer, sposta l'intero modello SocialInteractions in ReplicatedStorage. All'esecuzione dell'esperienza, il modulo inizierà a funzionare.

Configurazione

Inserire semplicemente il modulo SocialInteractions attiverà sia le funzionalità di orientamento del corpo che di animazioni di chat all'interno del tuo luogo. Per modificare il comportamento predefinito:

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

   

2. Incolla il seguente codice nel nuovo script, utilizzando la funzione configure 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 funzione delle animazioni di chat
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Parole Attivatori per Animazioni di Chat

L'elenco delle "parole attivatori" che attivano ciascuna animazione di chat è configurabile e vengono utilizzati schemi di stringhe Luau per migliorare il riconoscimento delle parole. 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 inoltre che le parole attivatori sono insensibili al maiuscolo, quindi digitare hey è equivalente a HEY, Hey e altre variazioni.

L'elenco delle parole attivatori 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 lo schema di stringhe cra+zy per supportare parole attivatori come crazy e craaaaaazy. Registra anche uno schema di stringhe aggiuntivo di coo+l per l'animazione Applaud per supportare parole come cool e coooool.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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

-- Registra lo schema 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.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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

setTriggerWordsForChatAnimation

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

Nota che le parole attivatori sono insensibili al maiuscolo per i giocatori, quindi uno schema di woah accetterà frasi di chat come woah, WOAH, Woah e altre variazioni.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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

Eventi

onChatAnimationPlayed

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

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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