Twój awatar jest twoją tożsamością w każdej przestrzeni, do której wprowadzać.Moduł Interakcje społeczne developera pozwala każdemu użytkownikowi lepiej wyrazić siebie i swoje naturalne ruchy, dodając odrobinę realizmu do doświadczenia.
Ten moduł zawiera następujące funkcje:
Orientacja ciała | Rozmieszcza twarz awatara każdego, gdzie aparat odpowiadającego użytkownika wskazuje, poprzez miks rotacji szyi i biodła.Dostarcza to subtelny wskazówkę, z kim lub czym ktoś inny wchodzi w interakcję. |
Animacje czatu | Dodaje odrobinę życia do czatu w doświadczeniu, sprawiając, że awatary czasami odtwarzają animacje, w zależności od zawartości wysyłaćwiadomości.Lista "słów spustowych", które aktywują każdą animację, jest konfigurowalna. |
Użycie modułu
Instalacja
Aby użyć modułu Interakcje społeczne w doświadczeniu:
Upewnij się, że wybrano sortowanie modele , a następnie kliknij przycisk Zobacz wszystko dla kategorii .
Zlokalizuj i kliknij pasek modułów rozwojowych .
Zlokalizuj moduł Interakcje społeczne i kliknij go, lub przeciągnij i upuść do widoku 3D.
W oknie Eksploratora przenieś cały model Interakcji Społecznych do ServerScriptService .Po uruchomieniu doświadczenia moduł rozproszy się na różne usługi i rozpocznie działanie.
Konfiguracja
Po prostu wstawienie modułu Interakcje społeczne umożliwi zarówno włączenie funkcji orientacji ciała jak i animacji czatu w twoim miejsce.Aby dostosować domyślne zachowanie:
W StarterPlayerScripts , utwórz nowy LocalScript i zmień nazwę na Konfiguruj interakcje społeczne .
Wklej następujący kod do nowego skryptu, korzystając z funkcji konfiguruj, aby dostosować zachowanie modułu.
Lokalny skryptlocal ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Uczynij rotację w pasie bardziej wyraźną i wyłącz funkcję animacji funkcjaSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
Słowa uruchamiające animację czatu
Lista "słów uruchamiających", które aktywują każdą animację czatu, jest konfigurowalna, a wzory strun Luau są wykorzystywane do zwiększenia rozpoznawalnych słów.Na przykład jedna kombinacja używana przez animację Falę jest he+y+o*, co oznacza, że hey, heyyy, heyo, heyyyyo, heeeeyyyyo i inne zmiany kwalifikują się do uruchomienia animacja.
Zauważ też, że słowa uruchamiające są niewrażliwe na dużą/małą literę , więc wpisanie hey jest takie samo jak HEY, Hey i inne odmiany.
Animacja | ID animacji | Wzory słowa |
---|---|---|
Fala | 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+ |
Oklaski | 5911729486 > | ya+y+ h[ou]+r+a+y+ woo+t* woo+h+oo+ bravo+ congratulations+ congrats+ gg pog+ poggers+ |
Zgoda | 4841397952 > | ye+s* ye+a+h* y[eu]+p+ o+k+ o+k+a+y+ |
Nie zgadzam się | 4841401869 > | no+ no+pe+ yi+ke+s+ |
Ziewanie | 3334392772 > | not+%s+sure+ idk+ don't%s+know+ i%s+don't%s+know+ who+%s+knows+ |
Śmiech | 3337966527 > | lo+l+ rof+l+ ha[ha]* he[he]+ |
Sen | 4686925579 > | zzz+ yawn+ |
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 następujące LocalScript linki łączą animację nachylenia z wzorcem ciągu znaków cra+zy w celu wsparcia słów uruchamiających, takich jak crazy i craaaaaazy.Rejestruje również dodatkowy wzór ciągu coo+l dla animacji Applaud, aby wspierać słowa takie jak cool i coooool.
Lokalny skrypt
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Rejestracja wzoru ciągu dla animacja"Tilt"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})-- Rejestracja dodatkowego wzorca ciągu dla animacja"Applaud"SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})
Referencja API
Funkcje
skonfigurować
konfigurować(config: table )
Nadpisanie domyślnych opcji konfiguracyjnych za pomocą następujących kluczy/wartości w tabeli config.Funkcja ta może być wywołana tylko z LocalScript.
Klucz | Opis | Domyślny |
---|---|---|
useBodyOrientation | Przełącza funkcję funkcjaciała. | prawda |
waistOrientationWeight | Orientacja ciała wykorzystuje miks rotacji w talii i szyi; ten parametr określa, które z tych dwóch jest dominujące.Wartość 1 miejsc kompletnie podkreśla pas, podczas gdy 0 miejsc kompletnie podkreśla szyję. | 0.5 |
useChatAnimations | Przełącza funkcję animacji czatu . | prawda |
useDefaultTriggerWordsForChatEmotes | Animacje czatu pochodzą z domyślną listą słów uruchamiających.Ustaw ten parametr na false, jeśli chcesz je wyłączyć i dostarczyć posiadać. | prawda |
Lokalny skrypt
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Uczynij rotację w pasie bardziej wyraźną i wyłącz funkcję animacji funkcjaSocialInteractions.configure({waistOrientationWeight = 0.75,useChatAnimations = false,})
ustawTriggerWordsForChatAnimation
setTriggerWordsForChatAnimation(animationId: string , triggerWords: table )
Rejestruje nową animację w funkcji animacji czatu.Wpisanie dowolnego słowa, które pasuje do wzoru ciągu znaków zawartego w tabeli triggerWords aktywuje animację, której ID przekazano jako pierwszy parametr.
Zauważ, że słowa uruchamiające są niewrażliwe na wielkość liter dla graczy, więc wzór woah będzie akceptował frazy czatu woah , WOAH , Woah i inne odmiany.
Lokalny skrypt
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))-- Rejestracja nowego wzorca ciągu dla niestandardowej animacjaSocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554",{"cra+zy", "woah+"})
Wydarzenia
naChatAnimacjaOdtwarzana
Wybucha, gdy odtwarzana jest animacja czatu.Połączona funkcja otrzymuje ID animacji i słowo, które uruchomiło animację jako jej argumenty.To wydarzenie może być połączone tylko w LocalScript.
Parametry | |
---|---|
animationId: string | ID animacji, która się odtwarzała. |
triggerWord: string | Słowo czatu, które uruchomiło animacja. |
Lokalny skrypt
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
print(animationId, triggerWord)
end)