Biểu cảm

Biểu cảm là các hoạt ảnh đặc sắc của nhân vật, có thể truy cập bằng cách sử dụng lệnh chat ("/e cheer") hoặc bằng cách truy cập vào menu biểu cảm ở góc trên bên phải của bất kỳ trò chơi nào. Tất cả người dùng đều có quyền truy cập vào các biểu cảm mặc định, chẳng hạn như nhảy múa, chỉ tay, và hoan hô. Các biểu cảm avatar bổ sung có thể được mua và trang bị từ Thị Trường.

Trong trò chơi của bạn, bạn có thể thực hiện các tùy chỉnh biểu cảm sau:

• Mở và đóng menu biểu cảm của người dùng một cách lập trình.
• Thêm hoặc xóa các tùy chọn biểu cảm từ menu của người dùng.
• Vô hiệu hóa quyền truy cập vào menu.
• Chơi một biểu cảm, nhắm mục tiêu đến một nhân vật người dùng cụ thể.

Menu biểu cảm

Bạn có thể mở và đóng menu biểu cảm của người dùng một cách thủ công, tùy chỉnh menu để hiển thị các biểu cảm cụ thể hoặc vô hiệu hóa hoàn toàn menu.

Mở và đóng

Để mở hoặc đóng menu biểu cảm của một người chơi, hãy gọi GuiService:SetEmotesMenuOpen() với giá trị boolean là true hoặc false.

Mẫu mã sau sẽ mở menu biểu cảm cho người dùng:

-- Mở menu biểu cảm
local GuiService = game:GetService("GuiService")
GuiService:SetEmotesMenuOpen(true)

Nếu bạn cần phát hiện xem menu biểu cảm có đang mở không, hãy gọi GuiService:GetEmotesMenuOpen(). Điều này trả về một giá trị boolean cho biết trạng thái hiện tại của menu.

Thêm và xóa biểu cảm

Tùy chỉnh menu biểu cảm bằng cách thiết lập các biểu cảm từ danh mục và sau đó trang bị biểu cảm cho một Humanoid. Thiết lập biểu cảm bằng phương thức HumanoidDescription:SetEmotes() và trang bị tối đa 8 biểu cảm vào menu biểu cảm bằng phương thức HumanoidDescription:SetEquippedEmotes().

Sử dụng mẫu mã sau trong LocalScript trong thư mục StarterCharacterScripts để thiết lập và trang bị biểu cảm trong trò chơi của bạn:

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

-- Thiết lập biểu cảm tùy chỉnh trong một bảng
local emoteTable = {
  ["Xin chào"] = {3576686446},
  ["Sân vận động"] = {3360686498},
  ["Nghiêng"] = {3360692915},
  ["Nhún vai"] = {3576968026},
  ["Chào"] = {3360689775},
  ["Chỉ"] = {3576823880}
}
humanoidDescription:SetEmotes(emoteTable)

-- Trang bị biểu cảm theo thứ tự cụ thể
local equippedEmotes = {"Xin chào", "Sân vận động", "Nghiêng", "Nhún vai", "Chào", "Chỉ"}
humanoidDescription:SetEquippedEmotes(equippedEmotes)

Vô hiệu hóa

Vô hiệu hóa menu biểu cảm bằng StarterGui:SetCoreGuiEnabled(). Việc vô hiệu hóa menu biểu cảm sẽ không ngăn chặn các biểu cảm được thực hiện bằng lệnh chat.

Mẫu mã sau sẽ vô hiệu hóa menu biểu cảm:

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

Ngoài việc vô hiệu hóa menu, bạn có thể vô hiệu hóa tải các biểu cảm do người dùng sở hữu bằng cách thiết lập thuộc tính StarterPlayer.UserEmotesEnabled trong StarterPlayer ⟩ Character thành false. Thuộc tính cụ thể này chỉ có thể được thiết lập trong Studio và không thể được thiết lập bởi các mã lệnh.

Chơi biểu cảm

Để chơi một biểu cảm mà một nhân vật có trong HumanoidDescription, hãy gọi Humanoid:PlayEmote(), truyền vào tên chuỗi của biểu cảm. Lệnh này sẽ trả về true để chỉ ra rằng biểu cảm đã được chơi thành công, hoặc false nếu không.

Sử dụng mẫu mã sau để chơi biểu cảm Nhún vai:

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

humanoid:PlayEmote("Nhún vai")