소셜 인터랙션

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

아바타는 입력하는 모든 공간에서 귀하의 신원입니다. 소셜 인터랙션 개발자 모듈 은 각 사용자를 더 잘 표현하고 자연스러운 움직임을 추가하여 경험에 현실감을 더합니다.

이 모듈에는 다음과 같은 기능이 포함됩니다.

바디 지향성 사용자의 카메라가 가리키는 곳에 해당 사용자의 아바타 얼굴의 모습을 합니다. 이것은 사용자가 누구나 다른 사람과 상호 작용하고 있는지에 대한 미묘한 힌트를 제공합니다.
채팅 애니메이션 경험 내 채팅에 일부 활기를 더하려면 아바타가 가끔 애니메이션을 재생하도록 합니다. 메시지 내용에 따라 트리거 단어 목록을 구성할 수 있습니다.

모듈 사용

설치

경험에서 소셜 인터랙션 모듈을 사용하려면:

  1. 보기 탭에서 도구 상자를 엽니다. 그리고 크리에이터 스토어 탭을 선택합니다.

    Toolbox toggle button in Studio
  2. 모델 정렬을 선택한 다음 모두 보기 버튼을 클릭하여 범주 에 대한 전체 보기를 클릭하십시오.

  3. 찾아 클릭하십시오 개발자 모듈 타일.

  4. 소셜 인터액션 모듈을 찾아보고 클릭하거나 3D 뷰에 드래그 앤 드롭하세요.

  5. In the 탐색기 창에서 전체 SocialInteractions 모델을 ServerScriptService 로 이동합니다. 경험을 실행할 때 모듈은 다양한 서비스에 배포되고 실행을 시작합니다.

구성

단순히 SocialInteractions 모듈을 삽입하면 내 플레이스내의 신체 지향채팅 애니메이션 기능을 모두 활성화할 수 있습니다. 기본 동작을 조정하려면:

  1. In StarterPlayerScripts , create a new LocalScript and rename it to ConfigureSocialInteractions .

  2. 새 스크립트에 다음 코드를 붙여넣으세요, 구성 함수를 사용하여 모듈의 동작을 사용자 정의합니다.

    로컬 스크립트

    local ReplicatedStorage = game:GetService("ReplicatedStorage")
    local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
    -- 웅덩이 회전을 더 두드러지게 하고 채팅 애니메이션 기능을 비활성화하십시오
    SocialInteractions.configure({
    waistOrientationWeight = 0.75,
    useChatAnimations = false,
    })

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

각 채팅 애니메이션을 활성화하는 "트리거 단어" 목록은 구성할 수 있으며 Lua 문자열 패턴은 인식 가능한 단어를 증가시키기 위해 사용됩니다. 예를 들어

트리거 단어는 케이스 인센티브 이므로 hey 를 입력하는 것은 HEY , 1> hey1> 및 다른 변형과 동일합니다.

애니메이션애니메이션 ID단어 패턴
파도3344650532

hell+o+     h+i+o*     <

박수5911729486

ya+y+     h[ou]+r+a+y+     woo

동의4841397952

ye+s*     ye+a+h*ye+a+p>)     y[eu+p+     0> o+k+0>     3> o+k+a+y+3>

동의 안함4841401869

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

슈크3334392772

not+%s+sure+     idk+     don't%s+know+     0> i%s+don't%s+know+0>     not+%s+sure+3>

웃음3337966527

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

잠자기4686925579

zzz+``yawn+

각 애니메이션을 활성화하는 트리거 단어 목록은 구성

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
-- “기울기” 애니메이션에 대한 문자열 패턴 등록
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})
-- “Applaud” 애니메이션에 대한 추가 문자열 패턴 등록
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

API 참조

함수

구성

구성(구성: table )

Class.LocalScript 테이블의 다음 키/값을 통해 기본 구성 옵션을 재정의합니다. 이 함수는 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(animationId: string , triggerWords: table )

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

트리거 단어는 플레이어에게 케이스 인센티브 이므로 패턴의 woah 는 채팅 단어의 woah , 2> WOAH2> , 5> Woah5> 및 다른 변형을 수락합니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
-- 사용자 지정 애니메이션에 대한 새로운 문자열 패턴 등록
SocialInteractions.setTriggerWordsForChatAnimation(
"rbxassetid://3334538554",
{"cra+zy", "woah+"}
)

이벤트

onChatAnimationPlayed

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

매개 변수
animationId: string재생된 애니메이션 ID.
트리거 단어: Library.문자열애니메이션을 트리거한 단어를 채팅합니다.
로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
print(animationId, triggerWord)
end)