OmniInteraction

نظام تفاعل مرن وسهل الاستخدام مع Blueprint. اكتشف الكائنات القريبة، وتنقّل بينها، وتفاعل معها فورًا أو بالضغط المطوّل، مع أحداث واجهة مستخدم مدمجة.

نظرة عامة

يمنح OmniInteraction أي Actor القدرة على العثور على الكائنات القابلة للتفاعل من حوله واستخدامها. أضِف مكوّنًا واحدًا إلى شخصيتك، وطبّق واجهة واحدة على كائناتك، لتحصل على الاكتشاف، وفحوصات خط الرؤية، وقائمة قابلة للتحديد، والتفاعل بالضغط المطوّل، وأحداث واجهة المستخدم.

الاكتشاف بالنطاقمسح كروي حول المالك بنصف قطر قابل للضبط.

خط الرؤيةيتم تجاهل الكائنات المخفية خلف الجدران تلقائيًا.

تحديد عدة عناصرتنقّل بين عدة عناصر قريبة باستخدام ⁦IndexUp / IndexDown⁩، مع إمكانية التفاف التحديد اختياريًا.

فوري أو مطوّليحدد كل كائن مدة تفاعله بنفسه. يتم توفير نسبة التقدّم لأشرطة واجهة المستخدم.

أحداث جاهزة لواجهة المستخدممفوّضات (Delegates) للدخول والإزالة والتحديد وتحديث النص مباشرةً لعناصر الواجهة.

تصحيح مدمجارسم نصف القطر واطبع حالة التفاعل الكاملة على الشاشة.

البدء السريع

فعِّل الإضافة
من القائمة Edit → Plugins، فعِّل OmniInteraction، ثم أعد تشغيل المحرر.
أضِف المكوّن
افتح Blueprint الخاص بشخصيتك (Character) أو أي Actor، وأضِف Interaction System.
طبّق الواجهة
في الكائن الذي تريد التفاعل معه: Class Settings → Interfaces → أضِف Interactable.
املأ الدوال
تجاوز (Override) Interact، Get Interact Text، Get Interact Icon، Get Interaction Duration وShould Remove On Interact.
اربط الإدخال
استدعِ Interact(Get Current Index) عند الضغط، وStop Interact عند الإفلات، وIndex Up / Down عند التمرير.
العب
اقترب من الكائن، وسيتم اكتشافه وتمييزه تلقائيًا.

متطلب التصادم: يجب أن يحتوي الـ Actors القابلة للتفاعل على مكوّن تصادم يتداخل مع قناة Visibility أو يحجبها، وإلا فلن يعثر عليها المسح.

واجهة Interactable

طبّق IInteractable على أي Actor. جميع الدوال هي Blueprint Native Events، لذا يمكنك تنفيذها في Blueprint أو تجاوز _Implementation في C++.

الدالة	القيمة المُرجَعة	الغرض
`Interact(Interactor)`	void	يُستدعى عند نجاح التفاعل. `Interactor` هو مالك المكوّن.
`GetInteractText`	String	التسمية المعروضة في واجهة المستخدم، مثل «التقط السيف». يتم استطلاعها في كل إطار، لذا يمكن أن تكون ديناميكية.
`GetInteractIcon`	Texture2D	أيقونة اختيارية لعنصر واجهة المستخدم.
`GetInteractionDuration`	float	`0` = فوري. أكبر من `0` = عدد الثواني التي يجب على اللاعب الضغط خلالها.
`ShouldRemoveOnInteract`	bool	إذا كانت true، يغادر العنصر القائمة بعد تفاعل ناجح (العناصر الملتقطة، المستهلكات).
`OnHighlightStart`	void	يُستدعى عندما يصبح العنصر هو المحدَّد. استخدمه للحواف المضيئة أو التوهّج.
`OnHighlightEnd`	void	يُستدعى عند إلغاء تحديده أو خروجه من النطاق.

مثال C++

class AMyPickup : public AActor, public IInteractable
{
    GENERATED_BODY()
public:
    virtual void Interact_Implementation(AActor* Interactor) override;
    virtual FString GetInteractText_Implementation() override { return TEXT("Pick up"); }
    virtual float GetInteractionDuration_Implementation() override { return 0.0f; }
    virtual bool ShouldRemoveOnInteract_Implementation() override { return true; }
};

مرجع المكوّن

الفئة: UInteractionSystem (مكوّن Actor). أضِفه إلى الـ Actor الذي يقوم بالتفاعل.

الخصائص

الخاصية	الافتراضي	الوصف
`InteractionRadius`	90.0	نصف قطر الاكتشاف بوحدات Unreal. قابل للقراءة والكتابة في Blueprint.
`bWrapSelection`	false	يلتف التحديد من الأخير إلى الأول (والعكس) عند التمرير.
`bShowDebugRadius`	false	يرسم كرة الاكتشاف. أخضر عند الخمول، وأحمر أثناء الضغط المطوّل.
`bShowDebugState`	false	يطبع الفهرس المحدَّد وقائمة العناصر وتقدّم الضغط المطوّل على الشاشة.

الدوال

الدالة	النوع	الوصف
`Interact(Index)`	Callable	تتفاعل مع العنصر عند الفهرس Index. تُنفَّذ العناصر الفورية على الفور؛ أما عناصر الضغط المطوّل فتبدأ مؤقّت الضغط.
`StopInteract`	Callable	تلغي الضغط المطوّل الحالي وتعيد ضبط التقدّم. استدعِها عند تحرير الإدخال.
`IndexUp / IndexDown`	Callable	تنقل التحديد وتُطلق بداية/نهاية التمييز.
`InteractAll(bOnlyInstant)`	Callable	تتفاعل مع كل عنصر قريب. الافتراضي هو العناصر الفورية فقط.
`ClearAllInteractables`	Callable	تمسح القائمة وتلغي أي ضغط مطوّل.
`RegisterWidgetReference(Widget)`	Callable	تربط عنصر واجهة تم إنشاؤه بخانة العنصر التالي ليتمكن من إزالته بشكل صحيح لاحقًا.
`GetHoldProgress`	Pure	من ⁦0⁩ إلى ⁦1⁩. اربطها بشريط تقدّم.
`GetCurrentIndex`	Pure	الفهرس المحدَّد حاليًا.
`GetSelectedActor`	Pure	الـ Actor المحدَّد، أو null.
`IsHoldInteractionAtIndex(Index)`	Pure	تكون true إذا كان العنصر يتطلب ضغطًا مطوّلًا.
`GetUpdatedTextAtIndex(Index)`	Pure	نص التفاعل الحالي لعنصر ما.
`GetDistanceToInteractable(Index)`	Pure	المسافة من المالك إلى العنصر.

الأحداث

اربطها في Blueprint (عبر عُقد Assign) أو في C++ باستخدام AddDynamic.

الحدث	المعاملات	متى يُطلَق
`OnItemEntered`	ItemName, ItemIcon	عند دخول كائن جديد قابل للتفاعل إلى النطاق وكونه مرئيًا.
`OnItemRemoved`	WidgetRef, Index	عند خروج عنصر من النطاق أو استهلاكه. استخدمه لتدمير عنصر الواجهة.
`OnSelectionChanged`	NewSelectedIndex	عند تغيّر الفهرس المحدَّد.
`OnUpdateInteractionText`	Index, NewText	في كل إطار لكل عنصر، ليبقى النص الديناميكي متزامنًا.

إعداد واجهة المستخدم (Blueprint)

اربط OnItemEntered. أنشئ عنصر الواجهة الخاص بالإدخال (الاسم + الأيقونة) وأضِفه إلى Vertical Box.
استدعِ فورًا RegisterWidgetReference مع عنصر الواجهة ذلك. افعل ذلك مباشرةً بعد إنشائه، بواقع عنصر واجهة واحد لكل عنصر داخل.
اربط OnItemRemoved. استدعِ Remove From Parent على WidgetRef.
اربط OnSelectionChanged لتمييز الإدخال عند NewSelectedIndex.
اربط OnUpdateInteractionText لتحديث التسمية عند Index.
لإجراءات الضغط المطوّل، شغِّل شريط تقدّم من GetHoldProgress.

نصائح وأفضل الممارسات

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

استخدم مفاتيح التصحيحفعِّل bShowDebugState لترى بالضبط ما الذي يتتبّعه النظام.

النص الديناميكيأرجِع نصوصًا تراعي الحالة، مثل «افتح الباب» أو «أغلق الباب»، من ⁦GetInteractText⁩.

التمييز بأماننفِّذ أعمال التمييز فقط داخل ⁦OnHighlightStart/End⁩ ليبقى التحديد متسقًا.

الأسئلة الشائعة

كائني لا يتم اكتشافه.

تحقق من أنه يطبّق Interactable، وأنه داخل نصف القطر، وله تصادم يستجيب لقناة Visibility. كما أن الجدران بينك وبين الكائن ستحجبه أيضًا.

هل يمكنني استخدامه مع الذكاء الاصطناعي أو الـ Actors غير اللاعبين؟

نعم. يعمل المكوّن مع أي Actor؛ Interactor هو ببساطة المالك.

كيف أصنع تفاعلًا بالضغط المطوّل؟

أرجِع مدة أكبر من 0 من GetInteractionDuration. استدعِ Interact عند الضغط، وStop Interact عند الإفلات.

هل يعمل مع Enhanced Input؟

نعم. لا يحتوي المكوّن على أي كود للإدخال؛ استدعِ دوالّه من أي حدث إدخال.