Interazioni sociali

Il tuo avatar è la tua identità, in qualunque spazio tu ti trovi. Il modulo sviluppatore SocialInteractions consente a ogni utente di esprimere al meglio se stesso e i propri movimenti naturali, aggiungendo un tocco di realismo all'esperienza.

Questo modulo include le seguenti funzionalità:

Utilizzo del modulo

Installazione

Per usare il modulo SocialInteractions in un'esperienza:

1. Dalla scheda Visualizza, aprire il Pannello degli strumenti e selezionare la scheda Marketplace.

   

2. Assicurarsi che la selezione dei modelli sia selezionata, quindi fare clic sul pulsante Vedi tutto per le Categorie.

   

3. Individuare e fare clic sulla piastrella DEV MODULES.

   

4. Individuare il modulo Interazioni sociali e fai clic su di esso, oppure trascinalo e rilascialo nella visualizzazione 3D.

   

5. Nella finestra Explorer, spostare l'intero modello InterazioniSociali in ServerScriptService. Dopo aver avviato l'esperienza, il modulo si distribuirà ai vari servizi e inizierà a funzionare.

   

Configurazione

Il semplice inserimento del modulo SocialInteractions avvierà sia la funzione di orientamento del corpo che le animazioni di chat all'interno del tuo posto. Per regolare 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 di configurazione per personalizzare il comportamento del modulo.

   LocalScript
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
   -- Make waist rotation more pronounced and disable the chat animations feature
   SocialInteractions.configure({
    waistOrientationWeight = 0.75,
    useChatAnimations = false,
   })

Parole di attivazione dell'animazione della chat

L'elenco delle "parole di attivazione" che attivano ogni animazione di chat è configurabile e i modelli di stringa Lua vengono utilizzati per aumentare le parole riconoscibili. Ad esempio, una combinazione utilizzata dall'animazione Onda è he+y+o*, nel senso che hey, heyyy, heyo, heyyyyo, heeeeyyyyo e altre varianti saranno utili per attivare l'animazione.

Da notare inoltre che le parole di attivazione sono case-insensitive, quindi la digitazione hey è la stessa di HEY, Hey e altre varianti.

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

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
-- Register string pattern for the "Tilt" animation
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})
-- Register additional string pattern for the "Applaud" animation
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

Riferimento API

Funzioni

Configurare

configure(config:table):nil

Sovrascrive la configurazione predefinita attraverso le seguenti chiavi/valori nella configtabella. Questa funzione può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
-- Make waist rotation more pronounced and disable the chat animations feature
SocialInteractions.configure({
    waistOrientationWeight = 0.75,
    useChatAnimations = false,
})

setTriggerWordsForChatAnimation

setTriggerWordsForChatAnimazione(animationId:string, triggerWords:table):nil

Registra una nuova animazione nella funzione di animazione della chat. Digitando una parola che corrisponde a un modello di stringa incluso nella tabella triggerWords si attiverà l'animazione il cui ID viene spostato come primo parametro.

Si noti che le parole di attivazione sono case-insensitive per i giocatori, quindi un modello di woah accetterà frasi di chat di woah, WOAH, Woah e altre varianti.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
-- Register new string pattern for a custom animation
SocialInteractions.setTriggerWordsForChatAnimation(
    "rbxassetid://3334538554",
    {"cra+zy", "woah+"}
)

Eventi

onChatAnimationPlayed

onChatAnimationPlayed(animationId:string, triggerWord:string): RBXScriptSignal

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

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
    print(animationId, triggerWord)
end)