دعم وحدات تحكّم الألعاب
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك تحسين تجربة المستخدم في لعبتك من خلال السماح للّاعبين باستخدام وحدات التحكّم في الألعاب. يوفر إطار عمل Android
واجهات برمجة تطبيقات لرصد إدخال المستخدم من وحدات التحكم في الألعاب ومعالجتها.
يوضِّح هذا الدليل كيفية تنسيق لعبتك بشكل متّسق مع وحدات التحكّم في الألعاب على مختلف المستويات (المستوى 9 من واجهة برمجة التطبيقات والمستويات الأعلى) وكيفية تحسين تجربة اللعب للّاعبين من خلال إتاحة استخدام عدة وحدات تحكّم في الوقت نفسه داخل تطبيقك.
ملاحظة:
إذا كنت تعمل على تطوير الألعاب أو كتابة تطبيق C++ ، استخدِم
مكتبة وحدة التحكم بالألعاب
التي تشكّل جزءًا من
مجموعة أدوات تطوير ألعاب Android (AGDK) بدلاً من ذلك.
دروس
-
التعامل مع إجراءات وحدة التحكّم
-
تعرَّف على كيفية التعامل مع إدخالات المستخدمين من عناصر الإدخال الشائعة على وحدات التحكّم في الألعاب، بما في ذلك أزرار لوحة الاتجاهات (لوحة التحكّم) وأزرار لوحة الألعاب
وذراعات التحكّم.
-
دعم وحدات التحكّم في جميع إصدارات Android
-
تعرَّف على كيفية جعل وحدات التحكّم في الألعاب تعمل بالطريقة نفسها على جميع الأجهزة
التي تعمل بإصدارات مختلفة من نظام التشغيل Android.
-
إتاحة استخدام عناصر تحكّم متعددة في الألعاب
-
تعرَّف على كيفية اكتشاف واستخدام عدة وحدات تحكم في الألعاب متصلة
في وقت واحد.
-
ميزات إضافية لوحدة التحكّم في الألعاب
-
تعرَّف على كيفية استخدام ميزات وحدة التحكُّم الإضافية.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Support game controllers\n\nYou can enhance the user experience in your game by letting\nplayers use game controllers. The Android framework\nprovides APIs for detecting and processing user input from game\ncontrollers.\n\n\nThis guide shows how to make your game work consistently with game\ncontrollers across different Android API levels (API level 9 and up) and\nhow to enhance the gaming experience for players by supporting multiple\ncontrollers simultaneously in your app.\n\n**Note:**\nIf you are developing games or writing a C++ app, use the\n[Game Controller Library](/games/sdk/game-controller)\nthat is part of the\n[Android Game Development Kit (AGDK)](/games/agdk) instead.\n\nLessons\n-------\n\n\n**[Handle controller actions](/develop/ui/views/touch-and-input/game-controllers/controller-input)**\n:\n Learn how to handle user input from common input elements on game\n controllers, including directional pad (D-pad) buttons, gamepad buttons,\n and joysticks.\n\n\n**[Support controllers across Android versions](/develop/ui/views/touch-and-input/game-controllers/compatibility)**\n:\n Learn how to make game controllers behave the same across devices\n running different versions of Android.\n\n\n**[Support multiple game controllers](/develop/ui/views/touch-and-input/game-controllers/multiple-controllers)**\n:\n Learn how to detect and use multiple game controllers that are\n simultaneously connected.\n\n\n**[Additional game controller features](/develop/ui/views/touch-and-input/game-controllers/controller-features)**\n:\n Learn how to use additional controller features."]]
