Soziale Interaktionen

Ihr Avatar ist Ihre Identität in jedem Raum, den Sie betreten. Das SocialInteractions Entwicklermodul ermöglicht es jedem Benutzer, sich besser auszudrücken und ihre natürlichen Bewegungen darzustellen, was die Erfahrung realistischer macht.

Dieses Modul umfasst die folgenden Funktionen:

Modulnutzung

Installation

Um das SocialInteractions Modul in einer Erfahrung zu verwenden:

1. Öffnen Sie das Toolbox aus dem Fenster-Menü oder der Start-Registerkarte im Studio und wählen Sie die Registerkarte Creator Store.

   

2. Stellen Sie sicher, dass die Sortierung nach Modellen ausgewählt ist, und klicken Sie dann auf die Schaltfläche Alle anzeigen für Kategorien.

   

3. Suchen Sie die Kachel Pakete und klicken Sie darauf.

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

   

5. Verschieben Sie das gesamte SocialInteractions Modell im Explorer Fenster in ReplicatedStorage. Nach dem Ausführen der Erfahrung beginnt das Modul zu laufen.

Konfiguration

Durch einfaches Einfügen des SocialInteractions Moduls werden sowohl die Funktionen der Körperorientierung als auch der Chatanimationen in Ihrem Ort aktiviert. Um das Standardverhalten anzupassen:

1. Erstellen Sie in StarterPlayerScripts ein neues LocalScript und benennen Sie es in ConfigureSocialInteractions um.

   

2. Fügen Sie den folgenden Code in das neue Skript ein, und verwenden Sie die configure Funktion, um das Verhalten des Moduls anzupassen.

   LocalScript
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage.SocialInteractions)
   
   -- Die Taillenrotation deutlicher machen und die Funktion der Chatanimationen deaktivieren
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Triggerwörter für Chatanimationen

Die Liste der "Triggerwörter", die jede Chatanimation aktivieren, ist konfigurierbar und es werden Luau-Stringmuster 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 die Animation auslösen.

Beachten Sie außerdem, dass Triggerwörter groß-/kleinschreibungsempfindlich sind, sodass die Eingabe von hey das gleiche ist wie HEY, Hey und andere Variationen.

Die Liste der Triggerwörter, die jede Animation aktivieren, ist konfigurierbar, und zusätzliche Animationen können über die setTriggerWordsForChatAnimation Funktion hinzugefügt werden. Zum Beispiel verknüpft das folgende LocalScript die Tilt Animation mit dem Stringmuster cra+zy, um Triggerwörter wie crazy und craaaaaazy zu unterstützen. Es registriert auch ein zusätzliches Stringmuster von coo+l für die Applaudieren Animation, um Wörter wie cool und coooool zu unterstützen.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Registriere das Stringmuster für die "Tilt" Animation
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- Registriere das zusätzliche Stringmuster für die "Applaud" Animation
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

API-Referenz

Funktionen

configure

Überschreibt die Standardkonfigurationsoptionen über die folgenden Schlüssel/Werte in der config Tabelle. Diese Funktion kann nur von einem LocalScript aufgerufen werden.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Die Taillenrotation deutlicher machen und die Funktion der Chatanimationen deaktivieren
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setTriggerWordsForChatAnimation

Registriert eine neue Animation in der Funktion für Chatanimationen. Das Eingeben eines Wortes, das einem im triggerWords Tabelle enthaltenen Stringmuster entspricht, aktiviert die Animation, deren ID als erster Parameter übergeben wird.

Beachten Sie, dass Triggerwörter für Spieler groß-/kleinschreibungsempfindlich sind, sodass ein Muster von woah Chatphrasen wie woah, WOAH, Woah und andere Variationen akzeptiert.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Registriere ein neues Stringmuster für eine benutzerdefinierte Animation
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

Ereignisse

onChatAnimationPlayed

Tritt auf, wenn eine Chatanimation gespielt wird. Die verbundene Funktion erhält die Animations-ID und das Wort, das die Animation ausgelöst hat, als Argumente. Dieses Ereignis kann nur in einem LocalScript verbunden werden.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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