بطاقة الملف الشخصي

*This content is translated using AI (Beta) and may contain errors. To view this page in English, click here.

قد يكون من المثير للاهتمام معرفة المزيد عن لاعبين آخرين. модуль ProfileCard المطوّر هو وسيلة رائعة لرؤية المزيد من المعلومات حول الآخرين داخل تجربة ما، بدءًا من الشارات المحققة وصولاً إلى تجارب اللاعب المفضلة.

استخدام الوحدة

التثبيت

لاستخدام модуль ProfileCard في تجربة ما:

  1. من قائمة Window في Studio أو شريط أدوات علامة التبويب Home، افتح Toolbox وحدد علامة التبويب Creator Store.

  2. تأكد من تحديد فرز Models، ثم انقر على زر See All لـ Categories.

  3. حدد وانقر على بلاطة Packages.

  4. ابحث عن модуль بطاقة الملف الشخصي وانقر عليه، أو اسحبه وأفلته في العرض ثلاثي الأبعاد.

  5. في نافذة Explorer، انقل نموذج ProfileCard بالكامل إلى ReplicatedStorage. عند تشغيل التجربة، سيبدأ الموديل في العمل.

العرض

تحتوي بطاقات الملف الشخصي على طرق عرض مختلفة اعتمادًا على ما إذا كنت تعرض بطاقتك الخاصة أو بطاقة لاعب آخر.

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

عند عرض بطاقتك الخاصة، تظهر كما لو كانت للاعب آخر، باستثناء أن نصوص العينة ستظهر لأي مدخلات فارغة. بالإضافة إلى ذلك، السلسلة الحالة تخضع لـ تصفية النصوص، كما يجب أن تكون أي مدخلات نصية مجانية.

بطاقة بدون حالة مخصصة
بطاقة مع حالة مخصصة
الدخول إلى حالة مخصصة
محاولة الدخول إلى حالة غير صالحة

مرجع API

الوظائف

configure

configure(config: table)

يعيد تحديد خيارات التكوين الافتراضية من خلال المفاتيح/القيم التالية في جدول config. يجب استدعاء هذه الوظيفة من LocalScript داخل StarterPlayerScripts.

المفتاحالوصفالافتراضي
alwaysOnTopإذا كان true، يظهر أيقونات المحدد فوق كل شيء، مما يمنع حجبها بواسطة عناصر العالم ثلاثي الأبعاد.true
showPersonalIndicatorإذا كان true، يظهر المؤشر الشخصي عندما يدخل لاعب ما التجربة لأول مرة.true
showBlurإذا كان true، يظهر خلفية الشاشة الضبابية عندما يدخل لاعب ما وضع التحرير.true
maxClickDistanceأقصى مسافة من وجهة نظر الكاميرا التي ستظهر بها البطاقة عند النقر على شخصية، تقاس بالدواليب.100
backgroundColorلون خلفية البطاقة (Color3).[228, 255, 255]
backgroundTransparencyشفافية backgroundColor للبطاقة.0.2
isScaledإذا كان true، يقوم تلقائيًا بتعديل حجم النص لملء ارتفاع المساحة.false
isTruncatedإذا كان true، يقوم تلقائيًا بإخفاء أطراف السلاسل النصية التي ستكون طويلة جدًا للرؤية المناسبة.true
hasRoundedCornersإذا كان true، ستكون زوايا البطاقة مستديرة.false
cornerRadiusValueقيمة نصف قطر الزاوية لـ UICorner، إذا كان hasRoundedCorners هو true.20
hasBorderإذا كان true، يظهر حد للبطاقة.false
borderColorلون حد البطاقة (Color3). ينطبق فقط إذا كان hasBorder هو true.[228, 255, 255]
borderThicknessسمك حد البطاقة، إذا كان hasBorder هو true.3
borderTransparencyشفافية حد البطاقة، إذا كان hasBorder هو true.0
borderLineJoinModeأسلوب الزاوية لحد البطاقة (Enum.LineJoinMode). ينطبق فقط إذا كان hasBorder هو true.Round
headerFontSizeحجم خط رأس البطاقة.18
headerFontTypeنوع الخط لرأس البطاقة (Enum.Font).GothamBlack
textFontSizeحجم خط نص جسم البطاقة.15
textFontTypeنوع الخط لنص جسم البطاقة (Enum.Font).GothamMedium
LocalScript

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ProfileCard = require(ReplicatedStorage.ProfileCard)
ProfileCard.configure({
alwaysOnTop = true,
maxClickDistance = 50,
backgroundColor = Color3.fromRGB(0, 0, 0),
backgroundTransparency = 0.4
})
©2026 شركة Roblox Corporation. تُعد منصّة Roblox، وشعار Roblox وشعار "توسيع حدود المخيلة"، من ضمن علاماتنا التجارية المسجّلة وغير المسجّلة في الولايات المتحدة وبلدان أخرى.