تعابير

تعابير هي رسوم متحركة تعبيرية للشخصيات تعبيرات يمكن الوصول إليها باستخدام أوامر الدردشة ("/e cheer") أو من خلال الوصول إلى قائمة التعابير في الجزء العلوي الأيمن من أي لعبة. جميع المستخدمين لديهم إمكانية الوصول إلى التعابير الافتراضية، مثل رقص، إشارة، وتشجيع. يمكن شراء تعابير أخرى للرمز الشخصي وتجهيزها من السوق.

في لعبتك، يمكنك إجراء التخصيصات التالية للتعابير:

• فتح وإغلاق قائمة تعابير المستخدم برمجياً.
• إضافة أو إزالة خيارات التعابير من قائمة المستخدم.
• تعطيل الوصول إلى القائمة.
• تشغيل تعبير، مستهدفًا شخصية مستخدم محددة.

قائمة التعابير

يمكنك فتح وإغلاق قائمة تعابير المستخدم يدويًا، تخصيص القائمة لعرض تعابير محددة، أو تعطيل القائمة تمامًا.

فتح وإغلاق

لفتح أو إغلاق قائمة تعابير اللاعب يدويًا، استدعِ GuiService:SetEmotesMenuOpen() مع قيمة منطقية true أو false.

ستفتح عينة الشيفرة التالية قائمة التعابير للمستخدم:

-- فتح قائمة التعابير
local GuiService = game:GetService("GuiService")
GuiService:SetEmotesMenuOpen(true)

إذا كنت بحاجة إلى اكتشاف ما إذا كانت قائمة التعابير مفتوحة، استدعِ GuiService:GetEmotesMenuOpen(). سيعيد هذا قيمة منطقية تشير إلى الحالة الحالية للقائمة.

إضافة وإزالة تعابير

قم بتخصيص قائمة التعابير من خلال تعيين التعابير من الكتالوج ثم تجهيز التعابير إلى Humanoid. قم بتعيين التعابير باستخدام طريقة HumanoidDescription:SetEmotes() وجهز ما يصل إلى 8 تعابير في قائمة التعابير باستخدام HumanoidDescription:SetEquippedEmotes().

استخدم عينة الشيفرة التالية في 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 إلى false. يمكن تعيين هذه الخاصية المحددة في الاستوديو فقط ولا يمكن تعيينها بواسطة الشيفرات.

تشغيل التعابير

لتشغيل تعبير يدويًا يمتلكه شخصية في HumanoidDescription، استدعِ Humanoid:PlayEmote(), ممررًا اسم التعبير كسلسلة. ستعيد هذه المكالمة true للإشارة إلى أن التعبير قد تم تشغيله بنجاح، أو false خلاف ذلك.

استخدم عينة الشيفرة التالية لتشغيل تعبير Shrug:

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

humanoid:PlayEmote("Shrug")