Dein Avatar ist deine Identität in jedem Raum, in den du eingeben.Das Sozialinteraktionen-Entwicklermodul lässt jeden Benutzer sich und seine natürlichen Bewegungen besser ausdrücken und fügt der Erlebniseinen Hauch von Realismus hinzu.
Dieses Modul enthält die folgenden Funktionen:
Körperorientierung | Macht das Gesicht des Avatars aller zum Gesicht, auf das die Kamera des entsprechenden Benutzers zeigt, durch eine Mischung aus Nacken- und Taillenrotierung.Dies liefert einen subtilen Hinweis darauf, mit wem oder was sich jemand anders interagiert. |
Chat-Animationen | Fügt dem Erlebnisk聊 einige Lebhaftigkeit hinzu, indem Avatare gelegentlich Animationen spielen, je nach dem Inhalt der Nachrichten, die sie senden.Die Liste der "Auslöswörter", die jede Animation aktivieren, ist konfigurierbar. |
Modul-Verwendung
Installationen
Um das Modul Soziale Interaktionen in einem Erlebnis zu verwenden:
Stellen Sie sicher, dass die Sortierung der Modelle ausgewählt ist, dann klicken Sie auf die Schaltfläche Alle sehen für Kategorien .
Suchen und klicken Sie auf die Entwickler-Module -Kachel.
Suchen Sie das Modul Soziale Interaktionen und klicken Sie darauf oder ziehen Sie es in die 3D-Ansicht.
In dem Explorer-Fenster verschiebe das gesamte SocialInteractions -Modell in ServerScriptService .Wenn das Erlebnis ausgeführt wird, verteilt sich das Modul auf verschiedene Dienste und beginnt zu laufen.
Konfigurieren
Das einfache Einfügen des Moduls Soziale Interaktionen wird sowohl die Körperorientierung als auch die Chat-Animationen -Funktionen in deinem Ortaktivieren.Um das Standardverhalten anzupassen:
In StarterPlayerScripts erstellen Sie ein neues LocalScript und benennen es in Konfigurieren von sozialen Interaktionen um.
Füge den folgenden Code in das neue Skript, das. PL: die Skriptsein, verwende die configure-Funktion, um das Verhalten des Moduls anzupassen.
Lokales Skriptlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Machen Sie die Taillenrotierung deutlicher und deaktivieren Sie die Funktion der Chat-AnimationsSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
Chat-Animationsauslöserwörter
Die Liste der "Auslöswörter", die jede Chat-Animation aktivieren, ist konfigurierbar, und Luau-Schnurzmuster werden verwendet, um erkennbare Wörter zu erhöhen.Zum Beispiel ist eine Kombination, die von der Welle -Animation verwendet wird, he+y+o* , was bedeutet, dass hey , heyyy , heyo , heyyyyo , heeeeyyyyo und andere Variationen berechtigt sind, die Animationenauszulösen.
Beachten Sie auch, dass Auslöserwörter unabhängig von der Groß-/Kleinschreibung sind , also ist die Eingabe von hey gleich wie HEY, Hey und andere Variationen.
Animierung | Animation-ID | Wortmuster |
---|---|---|
Welle | 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+ |
Applaudieren | 5911729486 > | ya+y+ h[ou]+r+a+y+ woo+t* woo+h+oo+ bravo+ congratulations+ congrats+ gg pog+ poggers+ |
Zustimmen | 4841397952 > | ye+s* ye+a+h* y[eu]+p+ o+k+ o+k+a+y+ |
Ablehnen | 4841401869 > | no+ no+pe+ yi+ke+s+ |
Schütteln | 3334392772 > | not+%s+sure+ idk+ don't%s+know+ i%s+don't%s+know+ who+%s+knows+ |
Lachen | 3337966527 > | lo+l+ rof+l+ ha[ha]* he[he]+ |
Schlaf | 4686925579 > | zzz+ yawn+ |
Die Liste der Auslöswörter, die jede Animation aktivieren, ist konfigurierbar, und zusätzliche Animationen können über die Funktion setTriggerWordsForChatAnimation hinzugefügt werden.Zum Beispiel verknüpfen die folgenden LocalScript -Links die Neigung -Animation mit dem Zeichenmuster von cra+zy , um Auslöserwörter wie crazy und craaaaaazy zu unterstützen.Es registriert auch ein zusätzliches Zeichenmuster von coo+l für die Applaud Animation, um Wörter wie cool und coooool zu unterstützen.
Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Registrierungsstringmuster für die "Tilt"AnimationenSocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})-- Registrieren Sie ein zusätzliches Zeichenmuster für die "Applaud"AnimationenSocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})
APIReferenz
Funktionen
konfigurieren
konfigurieren(config: table )
Übernimmt Standard-Konfigurationsoptionen durch die folgenden Schlüssel-/Werte in der config Tabelle.Diese Funktion kann nur von einem LocalScript aufgerufen werden.
Schlave | Beschreibung | Standardmäßig |
---|---|---|
useBodyOrientation | Schaltet die Körperorientierung -Funktion um. | wahr |
waistOrientationWeight | Die Körperorientierung verwendet eine Mischung aus Taillen- und Nackenrotierung; dieser Parameter bestimmt, welcher der beiden vorherrschend ist.Ein Wert von 1 Plätzen betont die Taille vollständig, während 0 Plätze den Hals vollständig betonen. | 0.5 |
useChatAnimations | Schaltet die Chat-Animationen -Funktion um. | wahr |
useDefaultTriggerWordsForChatEmotes | Chat-Animationen kommen mit einer Standardliste von Auslöserwörtern .Setze diesen Parameter auf false, wenn du sie deaktivieren und deine besitzenbereitstellen möchtest. | wahr |
Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Machen Sie die Taillenrotierung deutlicher und deaktivieren Sie die Funktion der Chat-AnimationsSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
setTriggerWörter für Chat-Animation einstellen
setTriggerWordsForChatAnimation(AnimationId: string , triggerWörter: table )
Registriert eine neue Animation in der Funktion.Das Eingeben eines Wortes, das einem in der triggerWords Tabelle enthaltenen Zeichenmuster entspricht, aktiviert die Animation, deren ID als erster Parameter übergeben wird.
Beachten Sie, dass Auslöserwörter für Spieler unempfindlich gegen Groß- und Kleinschreibung sind , so dass ein Muster von woah Chat-Sätzen von woah , WOAH , Woah und anderen Variationen akzeptiert wird.
Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Registrieren Sie ein neues Zeichenmuster für eine benutzerdefinierte AnimationenSocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554",{"cra+zy", "woah+"})
Ereignisse
onChatAnimationAbgespielt
Feuert, wenn eine Chat-Animation abgespielt wird.Die verbundene Funktion erhält die Animations-ID und das Wort, das die Animation als Argument ausgelöst hat, als Argumente.Dieses Ereignis kann nur in einem LocalScript verbunden werden.
Parameter | |
---|---|
AnimationId: string | Animations-ID, die abgespielt wurde. |
Triggerwort: string | Chat-Wort, das die Animationenausgelöst hat. |
Lokales Skript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
print(animationId, triggerWord)
end)