Soziale Interaktionen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

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:

  1. Von der Ansicht-Registerkarte öffne die Toolbox und wähle die Creator-Store -Registerkarte aus.

    Toolbox toggle button in Studio
  2. Stellen Sie sicher, dass die Sortierung der Modelle ausgewählt ist, dann klicken Sie auf die Schaltfläche Alle sehen für Kategorien .

  3. Suchen und klicken Sie auf die Entwickler-Module -Kachel.

  4. Suchen Sie das Modul Soziale Interaktionen und klicken Sie darauf oder ziehen Sie es in die 3D-Ansicht.

  5. 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:

  1. In StarterPlayerScripts erstellen Sie ein neues LocalScript und benennen es in Konfigurieren von sozialen Interaktionen um.

  2. Füge den folgenden Code in das neue Skript, das. PL: die Skriptsein, verwende die configure-Funktion, um das Verhalten des Moduls anzupassen.

    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-Animations
    SocialInteractions.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.

AnimierungAnimation-IDWortmuster
Welle3344650532 >

hell+o+     h+i+o*     wa+[sz]+u+p+     y+o+     greetings*     salutations*     goo+d+%smorning+     he+y+o*     howdy+     what's*%s*up+

Applaudieren5911729486 >

ya+y+     h[ou]+r+a+y+     woo+t*     woo+h+oo+     bravo+     congratulations+     congrats+     gg     pog+     poggers+

Zustimmen4841397952 >

ye+s*     ye+a+h*     y[eu]+p+     o+k+     o+k+a+y+

Ablehnen4841401869 >

no+     no+pe+     yi+ke+s+

Schütteln3334392772 >

not+%s+sure+     idk+     don't%s+know+     i%s+don't%s+know+     who+%s+knows+

Lachen3337966527 >

lo+l+     rof+l+     ha[ha]*     he[he]+

Schlaf4686925579 >

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"Animationen
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})
-- Registrieren Sie ein zusätzliches Zeichenmuster für die "Applaud"Animationen
SocialInteractions.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.

SchlaveBeschreibungStandardmäßig
useBodyOrientationSchaltet die Körperorientierung -Funktion um.wahr
waistOrientationWeightDie 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
useChatAnimationsSchaltet die Chat-Animationen -Funktion um.wahr
useDefaultTriggerWordsForChatEmotesChat-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-Animations
SocialInteractions.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 Animationen
SocialInteractions.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: stringAnimations-ID, die abgespielt wurde.
Triggerwort: stringChat-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)