表情

表情是一種用於表達的角色 動畫 ，可以通過使用聊天指令("/e cheer")或存取上方右邊的任何體驗的 表情菜單 來訪問。所有用戶都有權使用預設表情，例如 跳舞 、1>點擊

在您的體驗中，您可以執行以下動作自訂表情：

• 開啟和關閉一個使用者的表情符號菜單程式。
• 從使用者的選單中移除或新增表情選項。
• 停用 存取選單。
• 播放一個動作，目標為特定的使用者角色。

表情符號選單

您可以手動打開和關閉用戶的表情選擇菜單，自訂菜單以顯示特定表情，或將菜單完全關閉。

開啟和關閉

要手動開啟或關閉玩家的表情菜單，請使用 Class.GuiService:SetEmotesMenuOpen() 並使用 true 或 false 的Boolean值。

下面的代碼示例會為使用者開啟表情符號選單：

-- 開啟表情符號選單
local GuiService = game:GetService("GuiService")
GuiService:SetEmotesMenuOpen(true)

如果您需要檢查是否啟用表情符號選單，請呼叫 GuiService:GetEmotesMenuOpen() 。這會返回指示狀態的Boolean。

添加和移除表情

自訂表情選擇頁面，將目錄中的表情設定為 Humanoid 然後裝備表情到 HumanoidDescription:SetEmotes() 。使用 HumanoidDescription:SetEquippedEmotes() 方法設置表情，並裝備最多 8 個表情到表情選擇頁面使用 2>Class.HumanoidDescription:SetEquippedEmotes2> 。

使用 LocalScript 內的 StarterCharacterScripts 文件夾內的代碼示例來設定並裝備您的體驗中的表情：

local Players = game:GetService("Players")
local humanoid = Players.LocalPlayer.Character.Humanoid
local humanoidDescription = humanoid.HumanoidDescription

-- 在表中設定自訂表情
local emoteTable = {
  ["Hello"] = {3576686446},
  ["Stadium"] = {3360686498},
  ["Tilt"] = {3360692915},
  ["Shrug"] = {3576968026},
  ["Salute"] = {3360689775},
  ["Point"] = {3576823880}
}
humanoidDescription:SetEmotes(emoteTable)

-- 裝備特定順序的表情符號
local equippedEmotes = {"Hello", "Stadium", "Tilt", "Shrug", "Salute", "Point"}
humanoidDescription:SetEquippedEmotes(equippedEmotes)

關閉

使用 StarterGui:SetCoreGuiEnabled() 關閉表情元素選單。關閉表情元素選單不會防止使用聊天指令執行表情。

下列示例碼將禁用表情元素選單：

local StarterGui = game:GetService("StarterGui")
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.EmotesMenu, false)

除了停用菜單外，您還可以禁用用戶擁有的表情，設置 StarterPlayer.UserEmotesEnabled 屬性內的 StarterPlayer > Character 至 1> false1>。此特屬僅能在 Studio 中設置，並且無法由指令碼設置。

播放表情

要手動播放角色在其 HumanoidDescription 中的表情，請呼叫 Humanoid:PlayEmote()，並且傳送動作的字串名稱。這個呼叫會返回 true 指示表情成功播放，或 false 指示表情未播放。

使用以下代碼示例來播放 Shrug 表情：

local Players = game:GetService("Players")
local humanoid = Players.LocalPlayer.Character.Humanoid

humanoid:PlayEmote("Shrug")