감정 표현 바

감정 표현은 모든 소셜 체험의 핵심 구성 요소입니다. EmoteBar 개발자 모듈의 목표는 플레이어에게 의미 있는 소셜 인터랙션을 활발히 수행할 수 있도록 액세스 가능하고 사용자 정의할 수 있는 방법을 제공하는 것입니다.

모듈 사용

설치

체험에서 EmoteBar 모듈을 사용하는 방법

1. 보기 탭에서 도구 상자를 열고 마켓플레이스 탭을 선택합니다.

   

2. 모델 정렬이 선택되었는지 확인한 다음 카테고리에서 모두 보기 버튼을 클릭합니다.

   

3. 개발자 모듈 타일을 찾아 클릭합니다.

   

4. 감정 표현 표시줄 모듈을 찾아 클릭하거나 3D 보기로 끌어다 놓습니다.

   

5. 탐색기 창에서 전체 EmoteBar 모델을 ServerScriptService로 이동합니다. 체험을 실행하면 모듈이 다양한 서비스에 배포되고 실행되기 시작합니다.

   

구성

모듈은 7개 감정 표현으로 사전 구성되어 있으며 크리에이터가 보유하고 있는 감정 표현과 표시 옵션으로 쉽게 사용자 정의할 수 있습니다. 또한 플레이어가 Lil Nas X, Royal Blood, Twenty One Pilots 등과 같은 이전 Roblox 이벤트의 감정 표현을 보유하고 있는 경우, 이러한 감정 표현은 사용 가능한 감정 표현 목록에 자동으로 추가됩니다.

1. ServerScriptService에서 새로운 Script를 만들고 이름을 ConfigureEmotes로 변경합니다.

   

2. 다음의 코드를 이 새로운 ConfigureEmotes 스크립트에 붙여 넣습니다. false의 useDefaultEmotes 설정이 기본 감정 표현을 재정의하고 setEmotes 함수를 통해 사용자 지정 감정 표현을 정의할 수 있게 해줍니다.

   Script - ConfigureEmotes
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
   EmoteBar.configureServer({
    useDefaultEmotes = false,
   })
   EmoteBar.setEmotes({
    {
        name = "Hello",
        animation = "rbxassetid://3344650532",
        image = "rbxassetid://7719817462",
        defaultTempo = 1,
    },
    {
        name = "Applaud",
        animation = "rbxassetid://5915693819",
        image = "rbxassetid://7720292217",
        defaultTempo = 2,
    },
   })

메가 감정 표현

동일한 영역의 여러 플레이어가 동일한 시간에 동일한 감정 표현을 실행할 때 메가 감정 표현이 형성됩니다. 플레이어가 더 많이 참여할수록 메가 감정 표현은 점점 더 커집니다. 플레이어들이 이 감정 표현의 실행을 중지하면 메가 감정 표현이 점점 작아져 결국 사라집니다.

템포

감정 표현의 템포는 버튼을 한 번 누를 때 플레이하는 속도입니다. 감정 표현의 기본 속도는 defaultTempo에 의해 결정됩니다. 감정 표현의 버튼을 더 빠르게 또는 더 느리게 눌러 속도를 높이거나 낮출 수 있습니다.

API 참조

유형

감정 표현

각 감정 표현은 다음과 같은 키-값 쌍이 들어 있는 사전의 구조로 표현됩니다.

열거형

EmoteBar.GuiType

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureClient({
    guiType = EmoteBar.GuiType.EmoteWheel,
})

함수

configureServer

configureServer(config:table):nil

config 테이블의 다음 키/값을 통해 기본 서버측 구성 옵션을 무효화합니다. 이 함수는 Script에서만 호출되며 변경 사항은 자동으로 모든 클라이언트에 복제됩니다.

Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureServer({
    emoteMinPlayers = 2,
    playParticles = false,
})

configureClient

configureClient(config:table):nil

config 테이블의 다음 키/값을 통해 기본 클라이언트 측 구성 옵션을 무효화합니다. 이 함수는 LocalScript에서만 호출할 수 있습니다. guiType의 값에 따라 표시된 탭의 옵션도 적용됩니다.

일반

EmoteBar

EmoteWheel

LocalScript - Emote Bar
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureClient({
    guiType = EmoteBar.GuiType.EmoteBar,
    maxEmotesPerPage = 6,
    nextPageKey = Enum.KeyCode.Z,
    prevPageKey = Enum.KeyCode.C,
})

LocalScript - Emote Wheel
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureClient({
    guiType = EmoteBar.GuiType.EmoteWheel,
})

setEmotes

setEmotes(emotes:table):nil

사용하려는 사용자 지정 감정 표현을 설정합니다. useDefaultEmotes가 true이면 이러한 감정 표현이 기본값에 추가되고, useDefaultEmotes가 false이면 기본값을 대체합니다. 이 함수는 Script에서만 호출되며 변경 사항은 자동으로 모든 클라이언트에 복제됩니다.

이 함수에 전달되는 각 감정 표현의 구조를 보려면 감정 표현을 참조해 주세요.

Script - ConfigureEmotes
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureServer({
    useDefaultEmotes = false,
})
EmoteBar.setEmotes({
    {
        name = "Hello",
        animation = "rbxassetid://3344650532",
        image = "rbxassetid://7719817462",
        defaultTempo = 1,
    },
    {
        name = "Applaud",
        animation = "rbxassetid://5915693819",
        image = "rbxassetid://7720292217",
        defaultTempo = 2,
    },
})

setGuiVisibility

setGuiVisibility(visible:boolean):nil

감정 표현 GUI를 표시하거나 숨깁니다. 이 함수는 특정 클라이언트의 LocalScript에서만 호출될 수 있습니다.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.setGuiVisibility(false)

getEmote

getEmote(emoteName:string):table

이름으로 감정 표현을 가져옵니다. 감정 표현이 검색되지 않으면 nil을 반환합니다. 이 함수는 특정 클라이언트의 LocalScript에서만 호출될 수 있습니다.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
local shrug = EmoteBar.getEmote("Shrug")

playEmote

playEmote(emote:Emote):nil

제공된 감정 표현을 플레이하고 연결된 경우 서버에서 emotePlayed 이벤트를 발생시킵니다. 이 함수는 특정 클라이언트의 LocalScript에서만 호출될 수 있습니다.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
local shrug = EmoteBar.getEmote("Shrug")
EmoteBar.playEmote(shrug)

lockEmote

lockEmote(emoteName:string):nil

제공된 이름으로 감정 표현을 잠급니다. 이 함수는 클라이언트의 LocalScript에서만 호출될 수 있습니다.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.lockEmote("Applaud")

unlockEmote

unlockEmote(emoteName:string):nil

제공된 이름으로 감정 표현 잠금을 해제합니다. 이 함수는 클라이언트의 LocalScript에서만 호출될 수 있습니다.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.unlockEmote("Applaud")

이벤트

emotePlayed

emotePlayed(player:Player, emote:Emote): RBXScriptSignal

어떤 클라이언트든 감정 표현을 플레이하면 발생합니다. 해당 이벤트는 LocalScript에서만 연결할 수 있습니다.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.emotePlayed:Connect(function(player, emote)
    print(player.Name, "played", emote.name)
end)

lockedEmoteActivated

lockedEmoteActivated(emote:Emote): RBXScriptSignal

클라이언트가 잠긴 감정 표현을 클릭하면 발생합니다. 해당 이벤트는 LocalScript에서만 연결할 수 있습니다.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.lockedEmoteActivated:Connect(function(emote)
    print(Players.LocalPlayer, "clicked", emote.name)
end)