Il tuo avatar è la tua identità in qualsiasi spazio in cui Entrare.Il modulo SocialInterazioni sviluppatore fa in modo che ogni utente esprima meglio se stesso e i suoi movimenti naturali, aggiungendo un tocco di realismo all'esperienza
Questo modulo include le seguenti funzionalità:
Orientamento del corpo | Fa apparire la faccia dell'avatar di tutti dove la fotocamera del corrispondente utente punta, attraverso un mix di rotazione del collo e della vita.Questo fornisce un sottile indizio su chi o cosa qualcun altro sta interagendo. |
Animazioni di chat | Aggiunge un po' di vivacità alla chat in-experience facendo giocare occasionalmente agli avatar delle animazioni, a seconda del contenuto dei messaggi che Spedire.L'elenco delle "parole di attivazione" che attivano ogni animazione è configurabile. |
Uso del modulo
Installazione
Per utilizzare il modulo Interazioni Sociali in un'esperienza:
Assicurati che la classificazione Modelli sia selezionata, quindi fai clic sul pulsante Vedi tutti per Categorie .
Individua e fai clic sul riquadro Moduli di sviluppo .
Individua il modulo Interazioni sociali e cliccalo, oppure trascinalo nella vista 3D.
Nella finestra Explorer, sposta l'intero modello Interazioni sociali in ServerScriptService .Dopo l'esecuzione dell'esperienza, il modulo si distribuirà a vari servizi e inizierà a funzionare.
Configurazione
Basta inserire il modulo Interazioni sociali per abilitare sia la funzione orientamento del corpo che le animazioni di chat all'interno del tuo Posto.Per regolare il comportamento predefinito:
In StarterPlayerScripts , crea una nuova LocalScript e rinominala in ConfiguraInterazioniSociali .
Incolla il seguente codice nel nuovo script, usando la funzione configura per personalizzare il comportamento del modulo.
Script localelocal ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Rendi più pronunciata la rotazione della vita e disabilita la Proprietàdelle animazioni di chatSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
Parole di attivazione dell'animazione di chat
L'elenco di "parole di attivazione" che attivano ogni animazione di chat è configurabile e i modelli di stringa Luau vengono utilizzati per aumentare le parole riconoscibili.Ad esempio, una combinazione utilizzata dall'animazione Onda è he+y+o* , il che significa che hey , heyyy , heyo , heyyyyo , heeeeyyyyo e altre varianti si qualificano per attivare l'animazioni.
Si noti inoltre che le parole di attivazione sono insensibili al caso , quindi digitare hey è lo stesso di HEY, Hey e altre varianti.
Animazione | ID dell'animazione | Modelli di parola |
---|---|---|
Onda | 3344650532 > | hell+o+ h+i+o* wa+[sz]+u+p+ y+o+ greetings* salutations* goo+d+%smorning+ he+y+o* howdy+ what's*%s*up+ |
Applaudi | 5911729486 > | ya+y+ h[ou]+r+a+y+ woo+t* woo+h+oo+ bravo+ congratulations+ congrats+ gg pog+ poggers+ |
Accetta | 4841397952 | ye+s* ye+a+h* y[eu]+p+ o+k+ o+k+a+y+ |
Non essere d'accordo | 4841401869 > | no+ no+pe+ yi+ke+s+ |
Alza le spalle | 3334392772 > | not+%s+sure+ idk+ don't%s+know+ i%s+don't%s+know+ who+%s+knows+ |
Ridi | 3337966527 > | lo+l+ rof+l+ ha[ha]* he[he]+ |
Dormi | 4686925579 > | zzz+ yawn+ |
L'elenco delle parole di attivazione che attivano ciascuna animazione è configurabile e ulteriori animazioni possono essere aggiunte tramite la funzione setTriggerWordsForChatAnimation.Ad esempio, i seguenti LocalScript link collegano l'animazione Inclinazione con il modello di stringa di cra+zy per supportare le parole di attivazione come crazy e craaaaaazy .Registra inoltre un modello di stringa supplementare di coo+l per l'animazione Applaud per supportare parole come cool e coooool .
Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Registra il modello di stringa per l'animazioni"Tilt"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})-- Registra un modello di stringa aggiuntivo per l'animazioni"Applaud"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})
Riferimento API
Functioni
configurare
configurare(config: table )
Sovrascrive le opzioni di configurazione predefinite attraverso le seguenti chiavi/valori nella tabella config.Questa funzione può essere chiamata solo da un LocalScript .
Chiave | Descrizione | Basilare |
---|---|---|
useBodyOrientation | Attiva/disattiva la Proprietà orientamento del corpo . | vero |
waistOrientationWeight | L'orientamento del corpo utilizza un mix di rotazione della vita e del collo; questo parametro determina quale dei due è prevalente.Un valore di 1 posti enfatizza completamente la vita mentre 0 posti enfatizzano completamente il collo. | 0.5 |
useChatAnimations | Attiva/disattiva la Proprietà animazioni di chat . | vero |
useDefaultTriggerWordsForChatEmotes | Le animazioni di chat vengono fornite con una lista predefinita di parole di attivazione.Imposta questo parametro a false se vuoi disattivarli e fornire il Proprio. | vero |
Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Rendi più pronunciata la rotazione della vita e disabilita la Proprietàdelle animazioni di chatSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
setTriggerWordsForChatAnimation
setTriggerWordsForChatAnimation(animationId: string , triggerWords: table )
Registra una nuova animazione nella funzione di Proprietàdella chat.Digitare qualsiasi parola che corrisponde a un modello di stringa incluso nella tabella triggerWords attiverà l'animazione il cui ID viene passato come primo parametro.
Nota che le parole di attivazione sono insensibili al caso per i giocatori, quindi un modello di woah accetterà frasi di chat di woah , WOAH , Woah e altre varianti.
Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Registra un nuovo modello di stringa per un'animazionipersonalizzataSocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554",{"cra+zy", "woah+"})
Eventi
onChatAnimazionePlayed
Si accende quando un'animazione di chat viene riprodotta.La funzione connessa riceve l'ID dell'animazione e la parola che ha attivato l'animazione come suoi argomenti.Questo evento può essere connesso solo in un LocalScript .
Parametri | |
---|---|
animationId: string | ID di animazione che ha giocato. |
triggerWord: string | Parola di chat che ha attivato l'animazioni. |
Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
print(animationId, triggerWord)
end)