كيفية الانتقال من Input Manager القديم في Unity إلى Input System دون كسر عناصر التحكم
باختصار
انقل مشروع Unity 6 من Input Manager القديم إلى Input System دون كسر عناصر التحكم لدى اللاعب أو الواجهة أو استدعاءات Input المتبقية في الشيفرة.
تقوم بتثبيت Input System، ثم تضغط على Play، فيظهر خطأ من Unity: أنت تحاول قراءة المدخلات باستخدام كلاس UnityEngine.Input، لكن Active Input Handling يشير بالفعل إلى حزمة Input System. أو يبدأ Play Mode، ولكن قائمة الإيقاف المؤقت لم تعد تستقبل نقرة واحدة.
يوضح هذا المقال ترتيباً آمناً لنقل مشروع Unity 6 موجود من Input Manager القديم إلى Input System الجديد دون كسر عناصر التحكم أو الواجهة. أبقِ كلا النظامين مفعّلين، استبدل استدعاءات Input الخاصة بك، أصلح EventSystem، ثم أوقف المدير القديم فقط عندما يعمل كل شيء. تتبع الخطوات التوثيق الرسمي لـ Input System اعتباراً من 20 نوفمبر 2026. ثبّت حزمة Input System الحالية من Package Manager. لا تحدد إصدار حزمة من هذا المقال، لأن إصدارات أحدث ستتبع.
لماذا الانتقال في Unity 6
دليل Unity يعامل الآن Input Manager المدمج كميزة قديمة. إنه مهمل، وغير موصى به للمشاريع الجديدة، وتقول Unity أنه سيتم إزالته في إصدار مستقبلي من المحرر. يظل المدير القديم متاحاً حتى تستمر المشاريع الموجودة في العمل. التبديل المخطط له لا يزال أفضل من الانتظار حتى يزيل تحديث مستقبلي النظام القديم نيابة عنك.
أبقِ كلا النظامين مفعّلين أثناء الانتقال
إذا لم يتضمن مشروعك Input System، افتح Window > Package Manager، انتقل إلى Unity Registry، وثبّت حزمة Input System. من Unity 6.1 فصاعداً، بعض قوالب المشاريع تضيفه بالفعل. المشاريع الفارغة غالباً لا تفعل ذلك.
أثناء التثبيت، يسألك Unity ما إذا كنت تريد تفعيل أنظمة Input System الخلفية وتعطيل أنظمة Input Manager الخلفية. إذا اخترت Yes، يعيد المحرر التشغيل مع تفعيل النظام الجديد فقط. كل استدعاء Input.GetAxis أو Input.GetButton متبقٍ يفشل حينها، وقوائم uGUI التي لا تزال تستخدم وحدة الإدخال القديمة تفشل معها.
حدد النظام الخلفي بنفسك بدلاً من ذلك. اذهب إلى Edit > Project Settings > Player، افتح Other Settings، واضبط Active Input Handling على Both. سيعيد المحرر التشغيل. في هذا الوضع، يعرّف Unity كلاً من ENABLE_LEGACY_INPUT_MANAGER و ENABLE_INPUT_SYSTEM، لذا يمكن للكود القديم والجديد العمل جنباً إلى جنب.
#if ENABLE_INPUT_SYSTEM
// New Input System backends are enabled.
#endif
#if ENABLE_LEGACY_INPUT_MANAGER
// Old Input Manager backends are enabled.
#endif
تعامل مع Both كجسر. أبقه مفعّلاً حتى تنتقل سكريبتاتك الخاصة وEventSystem وأي أصول من طرف ثالث. انتقل إلى Input System Package (New) فقط بعد أن يعمل Play Mode والبناء دون استثناء ومع واجهة تعمل.
استبدل GetAxis وGetButton بـ Actions
سير العمل الموصى به هو قراءة إجراءات مسماة، وليس أزرار الجهاز الخام. ما لم تحتج لأكثر من أصل إجراء واحد، عيّن أصلاً واحداً كإجراءات على مستوى المشروع.
افتح Edit > Project Settings > Input System Package وأنشئ أو عيّن الإجراءات الافتراضية على مستوى المشروع إذا لم يتم تعيين أي منها. الإعدادات الافتراضية تتضمن خريطة Player وخريطة UI، مع إجراءات مثل Move (قيمة Vector2) وJump، مربوطة بالفعل للوحة المفاتيح والفأرة وGamepad واللمس وXR. تصل إليها عبر InputSystem.actions. إنها مفعّلة افتراضياً ومحمّلة مسبقاً عند بدء التشغيل، وفي المحرر في كل مرة تدخل فيها Play Mode.
اعثر على كل إجراء مرة واحدة، ثم اقرأه كل إطار. البحث عن الإجراء بالاسم في كل مرة، كما فعل Input.GetAxis("Horizontal")، هو المسار البطيء في الـ API الجديد.
using UnityEngine;
using UnityEngine.InputSystem;
public class PlayerMovement : MonoBehaviour
{
InputAction moveAction;
InputAction jumpAction;
void Start()
{
moveAction = InputSystem.actions.FindAction("Move");
jumpAction = InputSystem.actions.FindAction("Jump");
}
void Update()
{
Vector2 move = moveAction.ReadValue<Vector2>();
if (jumpAction.WasPressedThisFrame())
{
// jump
}
}
}
الأسماء في مساحة الاسم UnityEngine.InputSystem تطابق الاستدعاءات القديمة على النحو التالي:
Input.GetAxis("Horizontal")وInput.GetAxis("Vertical")تصبحmoveAction.ReadValue<Vector2>()Input.GetButton("Jump")تصبحjumpAction.IsPressed()Input.GetButtonDownتصبحWasPressedThisFrame()Input.GetButtonUpتصبحWasReleasedThisFrame()Input.GetKey(KeyCode.Space)تصبحKeyboard.current.spaceKey.isPressedInput.GetMouseButton(0)تصبحMouse.current.leftButton.isPressedInput.mousePositionتصبحMouse.current.position.ReadValue()
تفصيلان مهمان إذا كنت تريد أن تبدو عناصر التحكم متماثلة. إجراء Move الافتراضي هو قيمة ثنائية الأبعاد، لذا يصبح محورا Horizontal وVertical القديمان متجهاً واحداً، وليس عددين عشريين. وReadValue لا يطبق تنعيم Gravity وSensitivity القديم، لذا يصل مفتاح أو زر إلى قيمته الكاملة فوراً. إذا كانت حركتك تعتمد على ذلك المنحدر، ستحتاج إلى إعادة إنشائه عمداً. Input.GetAxisRaw ليس له مكافئ مباشر. ReadUnprocessedValue() يختلف فقط عن ReadValue عندما تكون المعالجات مرفقة بالإجراء.
قراءات الجهاز المباشرة مثل Keyboard.current هي بديل سريع، وليست سير العمل طويل الأمد، ويمكن أن يكون الجهاز الحالي null عندما يكون ذلك العتاد مفقوداً.
بعض ميزات Input Manager القديمة لا تزال تعتمد على إصدار Unity الخاص بك. من Unity 6.4 فصاعداً، دوال أحداث الفأرة في MonoBehaviour مثل OnMouseDown تعمل مع Input System. في إصدارات Unity 6 الأقدم قد لا تفعل شيئاً بمجرد أن يكون النظام الخلفي الجديد فقط نشطاً. إذا كان مشروعك يستخدم الموقع أو البوصلة أو اتجاه الجهاز، تحقق من توثيق Input System لمحررك قبل إيقاف المدير القديم. IMGUI (OnGUI) غير متوافق مع Input System، لذا قد تحتاج قائمة التصحيح المبنية بهذه الطريقة للبقاء على Both.
أبقِ الواجهة تعمل
إذا كنت تستخدم Unity UI (uGUI)، تحتاج دائماً إلى وحدة إدخال على EventSystem لتغذية Input System في الواجهة. StandaloneInputModule الأقدم لا يزال يتحدث إلى Input Manager القديم. عندما يتم ضبط Active Input Handling على الحزمة الجديدة فقط، تلك الوحدة هي مصدر متكرر لاستثناء UnityEngine.Input.
حدد EventSystem في المشهد. إذا كانت حزمة Input System مثبتة، يوفر Inspector زراً يستبدل StandaloneInputModule بـ InputSystemUIInputModule. الوحدة الجديدة تأتي مهيأة مسبقاً بإجراءات واجهة افتراضية. عندما يكون Active Input Handling مضبوطاً بالفعل على الحزمة الجديدة أو على Both، يضيف Unity أيضاً الوحدة الجديدة تلقائياً إذا وضعت عنصر uGUI جديد في المشهد.
UI Toolkit مختلف. من Unity 2023.2 فصاعداً، والذي يتضمن Unity 6، يمكن لـ UI Toolkit قراءة إجراءات الواجهة من إجراءاتك على مستوى المشروع دون وحدة إضافية. تحتاج إلى InputSystemUIInputModule بالإضافة إلى EventSystem عندما يتشارك UI Toolkit وuGUI نفس المشهد.
إذا كنت تستخدم أيضاً مكون PlayerInput، عيّن نفس أصل الإجراء لـ PlayerInput ولـ InputSystemUIInputModule، واضبط حقل UI Input Module على PlayerInput. ثم نفس تعيين الجهاز يقود كلاً من اللاعب والواجهة. إذا كانت سكريبتاتك تقرأ الإجراءات بينما PlayerInput قيد الاستخدام، اقرأ PlayerInput.actions، وليس InputSystem.actions، لأن PlayerInput يحتفظ بنسخة مفلترة لجهاز كل لاعب.
الاستثناء واستدعاءات Input المتبقية
خطأ وقت التشغيل عادة يقول: InvalidOperationException: You are trying to read Input using the UnityEngine.Input class, but you have switched active Input handling to Input System package in Player Settings. يظهر عندما يكون Active Input Handling مضبوطاً على Input System Package (New) وشيء ما لا يزال يستدعي UnityEngine.Input.
اقرأ تتبع المكدس قبل أن تغير سكريبتات عشوائية. غالباً يبدأ في StandaloneInputModule أو BaseInput.GetButtonDown، وليس في كلاس الحركة الخاص بك. بعد إصلاح EventSystem، ابحث في كودك الخاص عن Input.GetAxis وInput.GetButton وInput.GetKey وInput.GetMouseButton وInput.mousePosition. ثم تحقق من الأصول والإضافات من طرف ثالث. ضبط Active Input Handling مرة أخرى على Both هو خطوة مؤقتة صالحة. الإصلاح الدائم هو نقل المستدعي أو تحديث الإضافة.
متى يكون PlayerInput يستحق ذلك
مكون PlayerInput اختياري. أضفه عندما تريد Send Messages (OnJump، OnMove(InputValue value))، أو Invoke Unity Events، أو PlayerInputManager للعب متعدد اللاعبين محلي. لعبة لاعب واحد تستطلع بالفعل في Update يمكنها البقاء مع FindAction وReadValue.
قائمة فحص قصيرة للانتقال
- ثبّت حزمة Input System الحالية من Package Manager، ثم اضبط Active Input Handling على Both.
- أنشئ أو عيّن الإجراءات الافتراضية على مستوى المشروع.
- استبدل استدعاءات
Inputالخاصة بك. اعثر على كل إجراء مرة واحدة، ثم اقرأه كل إطار. - إذا كنت تستخدم uGUI، استبدل
StandaloneInputModuleبـInputSystemUIInputModuleوانقر عبر القوائم بلوحة مفاتيح وGamepad. - تحقق من أحداث
OnMouseواللمس والموقع والبوصلة وIMGUI مقابل إصدار Unity الخاص بك. - حدّث الإضافات التي لا تزال تستدعي
UnityEngine.Input، أو أبقِ Both مفعّلاً حتى يوجد إصلاح. - عندما يعمل Play Mode والبناء دون استثناء ومع واجهة تعمل، اضبط Active Input Handling على Input System Package (New).
قبل أن تقلب ذلك المفتاح الأخير، العب خلال الحركة والقوائم والأزرار على الشاشة. الإدخال هو موضوع محرك من جانب العميل. horizOn هو خادم خلفي للعبة مع Unity SDK للحسابات والحفظ السحابي ولوحات المتصدرين والأخبار داخل اللعبة. نقل Input System لا يغير كيفية استخدامك لذلك الـ SDK، ولا يستبدل أو يلف مجموعة إدخال Unity.