وحدة تحكم أو لوحة مفاتيح معروفة ليست لعبة قابلة للعب
يقبل AnyPS5 لوحات ألعاب متوافقة مع SDL مع ربط لوحة المفاتيح والفأرة المدمج. تُستخدم أول وحدة معروفة. ضع anyps5-input.ini بجانب التنفيذي المُولَّد، أو عيّن ANYPS5_INPUT_CONFIG. هذه الصفحة تقتبس وثائق المشروع الأصلي — ولا تدّعي أن DualSense أو XInput أو عنوانًا يعمل بالكامل.
v0.1.3 · جُمع المحتوى في 21 أكتوبر 2026 من أصل INPUT_MAPPING.md في v0.1.3 ووثائق main الحالية. ليست تجربة على مضيف.
أي ملف تعيين ينطبق
يشحن v0.1.3 ملف INPUT_MAPPING.md كأصل إصدار. يضيف main الحالي لقطة الشاشة (F12) والجداول الزمنية لوحدة التحكم. اختصارات لوحة المفاتيح أدناه تطابق الاثنين. افتح ملف التعيين المرفق بأرشيفك قبل اتباع خطوات main فقط.
ما تقوله الوثائق إنه يعمل
- وحدات Xbox وأجهزة PlayStation المعرّفة عبر SDL تستخدم تخطيط أزرار PS القياسي. تُمرَّر العصي وزنادات التناظر. يمكن وصل الوحدات أو فصلها أثناء التشغيل. تُستخدم أول وحدة معروفة.
- تخطيط Xbox: A/B/X/Y إلى Cross/Circle/Square/Triangle؛ LB/RB إلى L1/R1؛ LT/RT إلى L2/R2 التناظري؛ Start إلى Options. اتجاهات D-pad ونقر العصي مدعومة.
- وحدات PlayStation التي يتعرّف عليها SDL: يُمرَّر نقر اللوحة اللمسية ومواضع حتى إصبعين. على الوحدات الأخرى يضغط View (Back) اللوحة في مركزها.
- ينطبق ربط لوحة المفاتيح والفأرة المدمج إن لم يوجد ملف إعداد. ربط وحدة التحكم يبقى تلقائيًا ولا يعاد تعيينه بتجاوزات لوحة المفاتيح أو الفأرة في anyps5-input.ini.
- سطر INI غير صالح يبلّغ عن الملف ورقم السطر ويوقف تهيئة الإدخال. مسار ANYPS5_INPUT_CONFIG المفقود خطأ. بلا أي ملف يُستخدم التعيين المدمج.
DualSense — موثّق، وليس «يعمل بالكامل»
يسمّي INPUT_MAPPING.md وحدات PlayStation التي يتعرّف عليها SDL. لا يدّعي كل ميزة DualSense على كل مضيف. يبلّغ libScePad في المشروع الأصلي عن DualSense (لوحة لمس 1920×1080) لكل عنوان، حتى إن كانت وحدة المضيف شيئًا آخر. شريط الإضاءة واللوحة اللمسية وتأثيرات الزناد تحتاج SDL2 مبنيًا مع HIDAPI؛ sdl2-compat أو البناء بلا HIDAPI لا يوفّرها. PCM الاهتزاز الذي لا يشغّله بطاقة صوت للوحدة — بما فيه DualSense عبر بلوتوث — يُقرَّب إلى اهتزاز المحرك من RMS لكل قناة؛ هذا التعيين غير مقيس على عتاد الجهاز. الزنادات التكيفية وشريط الإضاءة والاهتزاز الكامل على مضيف USB أو بلوتوث وإصدار معيّن تبقى غير محققة هنا.
XInput على Windows
اكتشاف وحدات Windows (ملاحظات دين libSceVideoOut): خلفية عصا DirectInput في SDL معطّلة افتراضيًا لأن التعداد قد يتجمّد إلى الأبد على بعض أجهزة HID للمصنّعين (المسألة #1042). تُكتشف وحدات XInput وHIDAPI؛ الوحدات التي تصل فقط عبر DirectInput لا تُكتشف. SDL_DIRECTINPUT_ENABLED=1 يعيدها على مضيفات بلا ذلك التجمّد. APS5_NO_WGI يعطّل Windows.Gaming.Input؛ عندها تُفقد عجلات السباق وعصي الآركيد أو الطيران ووحدات HID بلا HIDAPI واهتزاز زناد Xbox One/Series الذي يصل فقط عبر WGI. هذا الموقع لم يُعد اختبار تلك المسارات.
مجهول — لا تفترض
- ما إذا كانت زنادات DualSense التكيفية أو شريط الإضاءة أو الاهتزاز في عنوان معيّن تعمل على الأرشيف الرسمي.
- DualSense عبر بلوتوث بما يتجاوز احتياطي اهتزاز RMS الموثّق.
- وحدات DirectInput فقط ما لم تعيّن SDL_DIRECTINPUT_ENABLED=1 وتتأكد أن المضيف لا يتجمّد.
- أكثر من وحدة: تُستخدم أول وحدة معروفة فقط.
- دعم نقر اللوحة اللمسية ليس قراءة اللعبة لإحداثيات الأصابع لإيماءاتها.
- Shake (مفتاح X مضغوط) يصنّع حركة كل 50 مللي ثانية. لا يتحقق من سلوك حسّاس العنوان.
مثال صغير لإعداد لوحة المفاتيح
احفظه باسم anyps5-input.ini بجانب التنفيذي المُولَّد. أسماء الإجراءات لا تفرّق بين الأحرف. أول سطر لإجراء يستبدل التعيين المدمج؛ الأسطر اللاحقة تضيف بدائل. الإجراءات المحذوفة تبقى على الافتراضي. انسخ هذا من INPUT_MAPPING.md — لا تخترع أسماء إجراءات.
Cross = KEY:F Cross = KEY:Space LeftStickLeft = KEY:J LeftStickRight = KEY:L LeftStickUp = KEY:I LeftStickDown = KEY:K Square = MOUSE:Left R2 = MOUSE:Right ToggleMouse = MOUSE:Middle
ربط وحدة التحكم يبقى تلقائيًا. غيّر بضعة إجراءات في كل مرة: سطر تالف يوقف تهيئة الإدخال ويسمّي الملف والسطر.
ربط لوحة المفاتيح الافتراضي في v0.1.3 وmain الحالي
هذه الصفوف تطابق ملف التعيين المرفق بـ v0.1.3 وmain الحالي. لقطة الشاشة (F12) موثّقة في main الحالي فقط.
| الإجراء | لوحة المفاتيح / الفأرة |
|---|---|
Cross | Return, Space |
Circle | C |
Triangle | I |
Square | Left mouse button |
L1 | Q |
R1 | E, Left Alt, Right Alt |
L2 | R, Mouse button 4 (X1) |
R2 | Right mouse button |
L3 | Left Shift, Right Shift |
R3 | Left Ctrl, Right Ctrl |
Options | Escape |
Up / Right / Down / Left | Arrow keys; wheel Up / Down |
Left stick | A, D, W, S |
Right stick | F, H, T, G |
TouchLeft / TouchRight | Backspace, Tab |
Shake | X (held) |
ToggleMouse | Middle mouse, F7 |
ToggleFullscreen | F11 |
اختبر الإجراء الفعلي
افحص الحركة والكاميرا والتأكيد والإلغاء وأي لمس خاص باللعبة كلًّا على حدة. إن لم يتقدّم قائمة، سجّل طراز الوحدة وUSB أو بلوتوث والإجراء الذي جرّبته وما إذا اختلفت لوحة المفاتيح. لا تصنّف ذلك لعبًا يعمل.
الأرشيف الرسمي مقابل main الحالي
لقطة الشاشة (F12 يحفظ الإطار التالي PNG في anyps5-screenshots/ أو ANYPS5_SCREENSHOTS) والجداول الزمنية للوحة (APS5_PAD_INPUT_FILE وtools/pad_timeline.py) موثّقة في USAGE.md وINPUT_MAPPING.md على main الحالي. وهي غائبة عن ملف التعيين المرفق بـ v0.1.3. الجداول تتبع وقت الجدار وقراءات الوحدة؛ قد تفوّت أحداثًا أثناء التحميل ولا تعيد حالة اللعبة. لا تعامل F12 أو pad_timeline.py كأنهما مدعومان في كل أرشيف إصدار.
إن لم يبدأ الإدخال أصلًا
أكّد أولًا الملفين الرسميين وتخطيط app / libs / app0 — خطأ Windows 193 أو 126 ليس مشكلة تعيين إدخال. ثم راجع مسار INI والسطر على stderr. التالي: دليل الإعداد ثم استكشاف الأخطاء.
الإعداد: الملفان وتخطيط المجلد · استكشاف الأخطاء: 193 و126 وحدود المضيف