Interakcje społeczne

Twój awatar jest twoją tożsamością w każdej przestrzeni, którą wchodzisz. Moduł SocialInteractions moduł dewelopera pozwala każdemu użytkownikowi lepiej wyrażać siebie i swoje naturalne ruchy, dodając odrobinę realizmu do doświadczenia.

Moduł ten zawiera następujące funkcje:

Użycie modułu

Instalacja

Aby użyć modułu SocialInteractions w doświadczeniu:

1. Z menu Okno w Studio lub z paska narzędzi w zakładce Strona główna, otwórz Toolbox i wybierz zakładkę Sklep Stwórców.

   

2. Upewnij się, że wybrano sortowanie Modele, a następnie kliknij przycisk Zobacz wszystkie dla Kategorii.

   

3. Znajdź i kliknij kafelek Pakiety.

4. Znajdź moduł Interakcje Społeczne i kliknij go lub przeciągnij go do widoku 3D.

   

5. W oknie Eksploratora przenieś cały model SocialInteractions do ReplicatedStorage. Po uruchomieniu doświadczenia moduł zacznie działać.

Konfiguracja

Proste wstawienie modułu SocialInteractions włączy zarówno funkcję orientacji ciała, jak i animacji czatowych w twoim miejscu. Aby dostosować domyślne zachowanie:

1. W StarterPlayerScripts utwórz nowy LocalScript i zmień jego nazwę na ConfigureSocialInteractions.

   

2. Wklej poniższy kod do nowego skryptu, używając funkcji configure, aby dostosować zachowanie modułu.

   LocalScript
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage.SocialInteractions)
   
   -- Zwiększ efekt rotacji talii i wyłącz animacje czatowe
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Słowa uruchamiające animacje czatowe

Lista "słów uruchamiających", które aktywują każdą animację czatową, jest konfigurowalna, a wzory ciągów Luau są wykorzystywane do zwiększenia rozpoznawalnych słów. Na przykład jedna kombinacja używana przez animację Fala to he+y+o*, co oznacza, że hey, heyyy, heyo, heyyyyo, heeeeyyyyo i inne warianty kwalifikują się do uruchomienia animacji.

Zauważ również, że słowa uruchamiające są nieczułe na wielkość liter, więc wpisanie hey jest takie samo jak HEY, Hey i inne warianty.

Lista słów uruchamiających, które aktywują każdą animację, jest konfigurowalna, a dodatkowe animacje można dodać za pomocą funkcji setTriggerWordsForChatAnimation. Na przykład poniższy LocalScript łączy animację Tilt z wzorem ciągu cra+zy, aby wspierać słowa uruchamiające, takie jak crazy i craaaaaazy. Rejestruje również dodatkowy wzór ciągu coo+l dla animacji Oklaski, aby wspierać słowa takie jak cool i coooool.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Zarejestruj wzór ciągu dla animacji "Tilt"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- Zarejestruj dodatkowy wzór ciągu dla animacji "Oklaski"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

Dokumentacja API

Funkcje

configure

Nadpisuje domyślne opcje konfiguracyjne za pomocą następujących kluczy/wartości w tabeli config. Ta funkcja może być wywoływana tylko z LocalScript.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Zwiększ efekt rotacji talii i wyłącz animacje czatowe
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setTriggerWordsForChatAnimation

Rejestruje nową animację w funkcji animacji czatowych. Wpisanie jakiegokolwiek słowa, które pasuje do wzoru ciągu zawartego w tabeli triggerWords, uruchomi animację, której ID przekazano jako pierwszy parametr.

Zauważ, że słowa uruchamiające są nieczułe na wielkość liter dla graczy, więc wzór woah zaakceptuje frazy czatowe woah, WOAH, Woah i inne warianty.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Zarejestruj nowy wzór ciągu dla niestandardowej animacji
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

Zdarzenia

onChatAnimationPlayed

Wywołuje się, gdy animacja czatowa jest odtwarzana. Podłączona funkcja otrzymuje ID animacji oraz słowo, które uruchomiło animację jako swoje argumenty. To zdarzenie może być podłączone tylko w LocalScript.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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