소셜 상호 작용

아바타는 입력하는 모든 공간에서 당신의 정체성입니다.소셜 상호 작용 개발자 모듈은 각 사용자가 자신과 자연 움직임을 더 잘 표현할 수 있도록 하고, 경험에 현실감을 더해줍니다.

이 모듈에는 다음 기능이 포함됩니다:

바디 오리엔테이션	목과 허리 회전의 혼합을 통해 모든 사람의 아바타 얼굴에 해당 사용자의 카메라가 가리키도록 만듭니다.이것은 누가 또는 무엇이 다른 사람과 상호작용하고 있는지에 대한 미묘한 힌트를 제공합니다.
채팅 애니메이션	경험 내 채팅에 생동감을 더하여 아바타가 때때로 메시지의 내용에 따라 애니메이션을 재생하도록 합니다.각 애니메이션을 활성화하는 "트리거 단어" 목록은 구성할 수 있습니다.

바디 오리엔테이션 기능은 캐릭터의 목 및 허리 관절의 조정을 사용하여 사용자 지정 리그가 올바르게 작동하려면 동일한 이름의 개체를 포함해야 한다는 것을 의미합니다.

모듈 사용량

설치

경험에서 소셜 상호 작용 모듈을 사용하려면:

보기 탭에서 도구 상자 를 열고 크리에이터 스토어 탭을 선택합니다.
모델 정렬이 선택되었는지 확인한 다음 모두 보기 버튼을 클릭하여 카테고리를 확인하십시오.
찾아서 클릭하십시오 개발자 모듈 타일.
소셜 상호 작용 모듈을 찾아 클릭하거나 3D 뷰에 드래그 앤 드롭하세요.
탐색기 창에서 전체 소셜 상호 작용 모델을 서버 스크립트 서비스로 이동합니다.경험을 실행하면 모듈이 다양한 서비스에 배포되고 실행을 시작합니다.

구성

단순히 소셜 상호 작용 모듈을 삽입하면 플레이스내에서 몸 방향과 채팅 애니메이션 기능을 모두 활성화할 수 있습니다.기본 동작을 조정하려면:

In 스타터 플레이어 스크립트 , 새로운 LocalScript 를 만들고 소셜 상호 작용 구성 으로 이름을 바꿉니다.

새 스크립트에 다음 코드를 붙여넣고 configure 함수를 사용하여 모듈의 동작을 사용자 지정합니다.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- 허리 회전을 더 두드러지게 만들고 채팅 애니메이션 기능을 비활성화
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

채팅 애니메이션 트리거 단어

각 채팅 애니메이션을 활성화하는 "트리거 단어" 목록은 구성할 수 있으며 Luau 문자열 패턴이 사용되어 인식 가능한 단어가 증가합니다.예를 들어, 웨이브 애니메이션에서 사용되는 하나의 조합은 he+y+o*로, 즉 hey, heyyy, heyo, heyyyyo, heeeeyyyyo 및 기타 변형이 애니메이션을 트리거할 수 있음을 의미합니다.

또한 트리거 단어는 대/소문자를 구분하지 않습니다 , 따라서 입력 hey 은 HEY , Hey 및 기타 변형과 동일합니다.

애니메이션	애니메이션 ID	단어 패턴
웨이브	3344650532 >	hell+o+ h+i+o* wa+[sz]+u+p+ y+o+ greetings* salutations* goo+d+%smorning+ he+y+o* howdy+ what's%sup+
박수	5911729486 >	ya+y+ h[ou]+r+a+y+ woo+t* woo+h+oo+ bravo+ congratulations+ congrats+ gg pog+ poggers+
동의	4841397952 >	ye+s* ye+a+h* y[eu]+p+ o+k+ o+k+a+y+
동의 안함	4841401869	no+ no+pe+ yi+ke+s+
슈러그	3334392772	not+%s+sure+ idk+ don't%s+know+ i%s+don't%s+know+ who+%s+knows+
웃기기	3337966527 >	lo+l+ rof+l+ ha[ha]* he[he]+
잠	4686925579 >	zzz+ yawn+

각 애니메이션을 활성화하는 트리거 단어 목록은 구성할 수 있으며, setTriggerWordsForChatAnimation 함수를 통해 추가 애니메이션을 추가할 수 있습니다.예를 들어, 다음 LocalScript 링크는 기울기 애니메이션을 문자열 패턴 cra+zy 으로 연결하여 트리거 단어 crazy 및 craaaaaazy와 같은 단어를 지원합니다.또한 coo+l 박수 애니메이션에 대해 추가 문자열 패턴을 등록하여 단어 cool 및 coooool와 같은 단어를 지원합니다.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- 「기울기」 애니메이션에 대한 문자열 패턴 등록
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- 애플라우드" 애니메이션에 대한 추가 문자열 패턴 등록
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

API 참조

함수

구성

구성(config: table)

기본 구성 옵션을 다음 키/값을 통해 재정의합니다 config 테이블에서.이 함수는 LocalScript 호출할 수 있습니다.

키	설명	기본
useBodyOrientation	바디 오리엔테이션 기능을 토글합니다.	참
waistOrientationWeight	바디 오리엔테이션은 허리와 목 회전의 혼합을 사용하며, 이 매개변수는 두 가지 중 어느 것이 우세한지 결정합니다.1 개의 값은 허리에 주요 강조를 하고 0 개의 값은 목에 주요 강조를 합니다.	0.5
useChatAnimations	채팅 애니메이션 기능을 토글합니다.	참
useDefaultTriggerWordsForChatEmotes	채팅 애니메이션은 기본 트리거 단어 목록 과 함께 제공됩니다.이 매개변수를 false로 설정하면 끄고 자신의 보유제공하길 원하면 됩니다.	참

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- 허리 회전을 더 두드러지게 만들고 채팅 애니메이션 기능을 비활성화
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

채팅 애니메이션용 트리거 단어 설정 setTriggerWordsForChatAnimation

setTriggerWordsForChatAnimation(animationId: string, 트리거 단어: table)

채팅 애니메이션 기능에 새로운 애니메이션을 등록합니다.triggerWords 테이블에 포함된 문자열 패턴과 일치하는 모든 단어를 입력하면 첫 번째 매개변수로 전달된 ID의 애니메이션이 활성화됩니다.

트리거 단어는 플레이어에게 대/소문자를 구분하지 않으므로 패턴은 , , , 그리고 다른 변형들의 채팅 구절을 수락합니다.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

-- 사용자 지정 애니메이션에 새 문자열 패턴 등록
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

이벤트

온채팅 애니메이션 재생됨

채팅 애니메이션이 재생될 때 발생합니다.연결된 함수는 애니메이션 ID와 애니메이션을 트리거한 단어를 인수로 받습니다.이 이벤트는 LocalScript에만 연결할 수 있습니다.

매개 변수
애니메이션 ID: string	재생된 애니메이션 ID.
트리거 단어: string	애니메이션을 트리거한 채팅 단어.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))

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

이 페이지