Emotikony

Emotikony to ekspresyjne animacje postaci, które są dostępne poprzez użycie poleceń czatu ("/e cheer") lub poprzez dostęp do menu emotikonów w prawym górnym rogu każdej gry. Wszyscy użytkownicy mają dostęp do domyślnych emotikonów, takich jak tańczyć, wskazywać i cieszyć się. Dodatkowe emotikony awatara można kupić i wyposażyć z Rynku.

W swojej grze możesz wykonać następujące dostosowania emotikonów:

• Otwieranie i zamykanie menu emotikonów użytkownika programowo.
• Dodawanie lub usuwanie opcji emotikonów z menu użytkownika.
• Wyłączanie dostępu do menu.
• Odtwarzanie emotikonu, celując w konkretną postać użytkownika.

Menu emotikonów

Możesz ręcznie otworzyć i zamknąć menu emotikonów użytkownika, dostosować menu, aby wyświetlało konkretne emotikony, lub całkowicie wyłączyć menu.

Otwieranie i zamykanie

Aby ręcznie otworzyć lub zamknąć menu emotikonów gracza, wywołaj GuiService:SetEmotesMenuOpen() z wartością boolean true lub false.

Poniższy fragment kodu otworzy menu emotikonów dla użytkownika:

-- Otwórz menu emotikonów
local GuiService = game:GetService("GuiService")
GuiService:SetEmotesMenuOpen(true)

Jeśli musisz wykryć, czy menu emotikonów jest otwarte, wywołaj GuiService:GetEmotesMenuOpen(). To zwraca wartość boolowską wskazującą obecny stan menu.

Dodawanie i usuwanie emotikonów

Dostosuj menu emotikonów, ustawiając emotikony z katalogu, a następnie wyposażając emotikony do Humanoid. Ustaw emotikony za pomocą metody HumanoidDescription:SetEmotes() i wyposaź do 8 emotikonów w menu emotikonów za pomocą HumanoidDescription:SetEquippedEmotes().

Użyj poniższego fragmentu kodu w LocalScript w folderze StarterCharacterScripts, aby ustawić i wyposażyć emotikony w swojej grze:

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

-- Ustaw niestandardowe emotikony w tabeli
local emoteTable = {
  ["Hello"] = {3576686446},
  ["Stadium"] = {3360686498},
  ["Tilt"] = {3360692915},
  ["Shrug"] = {3576968026},
  ["Salute"] = {3360689775},
  ["Point"] = {3576823880}
}
humanoidDescription:SetEmotes(emoteTable)

-- Wyposaż emotikony w określonej kolejności
local equippedEmotes = {"Hello", "Stadium", "Tilt", "Shrug", "Salute", "Point"}
humanoidDescription:SetEquippedEmotes(equippedEmotes)

Wyłączanie

Wyłącz menu emotikonów za pomocą StarterGui:SetCoreGuiEnabled(). Wyłączenie menu emotikonów nie uniemożliwi wykonywania emotikonów za pomocą polecenia czatu.

Poniższy fragment kodu wyłączy menu emotikonów:

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

Oprócz wyłączania menu, możesz wyłączyć ładowanie emotikonów należących do użytkownika, ustawiając właściwość StarterPlayer.UserEmotesEnabled w StarterPlayer ⟩ Character na false. Ta specyficzna właściwość może być ustawiana tylko w Studio i nie może być ustawiana przez skrypty.

Odtwarzanie emotikonów

Aby ręcznie odtworzyć emotikon, który postać ma w swojej HumanoidDescription, wywołaj Humanoid:PlayEmote(), przekazując nazwę string emotikonu. To wywołanie zwróci true, aby wskazać, że emotikon został odegrany pomyślnie, lub false w przeciwnym razie.

Użyj poniższego fragmentu kodu, aby odtworzyć emotikon Shrug:

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

humanoid:PlayEmote("Shrug")