表情栏

表情是任何社交体验的核心组成部分。 表情栏 开发者模块 旨在为玩家提供一个可访问、可定制的方式来促进有意义的社交互动。

模块使用

安装

要在体验中使用 表情栏 模块：

1. 从视图选项卡打开工具箱并选择 创建者商店 选项卡。

   

2. 确保 模型 排序已选择，然后单击 查看全部 按钮以获取 类别 。

   

3. 找到并单击 开发模块 瓦片。

   

4. 找到 表情栏 模块，然后单击它或拖放到 3D 视查看中。

   

5. 在 浏览器 窗口中，将整个 EmoteBar 模型移至 ServerScriptService 。在运行体验时，模块将分配到各种服务并开始运行。

   

配置

模块预配备了 7 个表情，您可以轻松自定义自己的表情和显示选项。此外，如果玩家拥有以前的 Roblox 活动（例如 Lil Nas X、Royal Blood 或 Twenty One Pilots）的任何表情，那些表情将自动添加到可用表情列表。

1. 在 服务器脚本服务 中，创建一个新的 Script 并将其重命名为 配置表情符号 。

   

2. 将以下代码粘贴到新的 配置表情 脚本中。useDefaultEmotes 设置的 false 覆盖了默认表情，让你通过 setEmotes 函数定义自定义表情。

   脚本 - 配置表情
   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 参考

类型

表情

每个表情都由以下键值对表示的词典：

枚数

表情栏。贵类型

本地脚本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

EmoteBar.configureClient({
	guiType = EmoteBar.GuiType.EmoteWheel,
})

功能

配置 сервер

通过以下键/值在 config 表中覆盖默认服务器配置选项，来实现以下功能：此函数只能从 Script 调用，更改将自动复制到所有客户端。

脚本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

EmoteBar.configureServer({
	emoteMinPlayers = 2,
	playParticles = false,
})

配置客户端

通过以下键/值在 config 表中覆盖默认客户端配置选项，来实现以下功能：此函数只能从 LocalScript 中调用。根据 guiType 的值，注释标签中的选项也适用。

本地脚本 - 表情栏
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,
})

本地脚本 - 表情轮子
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

EmoteBar.configureClient({
	guiType = EmoteBar.GuiType.EmoteWheel,
})

设置表情

设置要使用的自定义表情。如果 useDefaultEmotes 是 true ，这些将被添加到默认值中，或者如果 useDefaultEmotes 是 false ，则会替换默认值。此函数只能从 Script 调用，更改将自动复制到所有客户端。

请参阅表情以获取每个表情传递到此函数的结构。

脚本 - 配置表情
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,
	},
})

设置GUI可见性

显示或隐藏表情图形GUI界面。此功能只能从特定客户端的 LocalScript 调用。

本地脚本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

EmoteBar.setGuiVisibility(false)

获取表情

通过名称获取 表情。返回 nil 如果无法找到表情，则返回。此函数只能从特定客户端的 LocalScript 调用。

本地脚本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

local shrug = EmoteBar.getEmote("Shrug")

播放表情

播放指定的 表情 并在服务器上发射 表情已发射 事件，如果连接。此函数只能从特定客户端的 LocalScript 调用。

本地脚本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

local shrug = EmoteBar.getEmote("Shrug")
EmoteBar.playEmote(shrug)

锁定表情

用给定的名称锁定 表情。此函数只能从客户端的 LocalScript 调用。

本地脚本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

EmoteBar.lockEmote("Applaud")

解锁表情

使用给定名称解锁 表情。此函数只能从客户端的 LocalScript 调用。

本地脚本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

EmoteBar.unlockEmote("Applaud")

事件

已播放表情

当任何客户端播放动作时发生火焰。此事件只能在 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)

锁定表情已激活

当客户端单击锁定的动作时发生火焰。此事件只能在 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)