कस्टम कंट्रोलर डिवाइस मैपिंग जोड़ें

गेम कंट्रोलर लाइब्रेरी, कंट्रोलर का इंटरनल डेटाबेस बनाए रखती है डिवाइस का इस्तेमाल बटन, मोशन ऐक्सिस लेआउट, और मैपिंग को कॉन्फ़िगर करने के लिए किया जाता है मान्य कंट्रोलर और अनजान कंट्रोलर के लिए डिफ़ॉल्ट मैपिंग शामिल है. कॉन्टेंट बनाने डेटाबेस में कई लोकप्रिय कंट्रोलर शामिल हैं, लेकिन हो सकता है कि इसमें सभी डिवाइस शामिल न हों किसी गेम के हिसाब से सही होता है. 'गेम कंट्रोलर' लाइब्रेरी से, गेम को अपनी पसंद के मुताबिक बनाने की सुविधा मिलती है इस्तेमाल करते हैं, जो ये काम कर सकते हैं:

• मैपिंग का मौजूदा डेटाबेस वापस पाएं.
• मौजूदा डेटाबेस में एंट्री जोड़ें.
• मौजूदा डेटाबेस एंट्री बदलें.
• पूरे मौजूदा डेटाबेस को एक नए डेटाबेस से बदलें.

किसी डिवाइस की पहचान करें

कंट्रोलर डिवाइसों की पहचान, उनके productId और vendorId वैल्यू से की जाती है. हर पहचाने गए कंट्रोलर डिवाइस के डेटाबेस में कम से कम एक एंट्री होती है मिलती-जुलती productId और vendorId. कंट्रोलर मैपिंग स्ट्रक्चर में यह शामिल है वे फ़ील्ड जो ऐप्लिकेशन के लिए ज़रूरी कम से कम और ज़्यादा से ज़्यादा Android API रेंज तय करते हैं एंट्री. एक ही productId और vendorId वाली एक से ज़्यादा एंट्री यहां हो सकती हैं को डेटाबेस में रखा जाता है, जब तक कि उनमें कम से कम और ज़्यादा से ज़्यादा एपीआई रेंज मौजूद हों.

अपना मौजूदा रीमैप डेटा देखें

Paddleboat_getControllerRemapTableData फ़ंक्शन का इस्तेमाल करके मौजूदा रीमैप डेटा को फिर से पाएं.

int32_t Paddleboat_getControllerRemapTableData(
   const int32_t destRemapTableEntryCount,
   Paddleboat_Controller_Mapping_Data* mappingData)

Paddleboat_getControllerRemapTableData, रीमैप की कुल संख्या दिखाता है आंतरिक डेटाबेस में मौजूद एंट्री.

पैरामीटर	ब्यौरा
destRemapTableEntryCount	इसकी अरे का साइज़ Paddleboat_Controller_Mapping_Data एलिमेंट mappingData पैरामीटर में पास किया गया है.
mappingData	इसके कलेक्शन का पॉइंटर Paddleboat_Controller_Mapping_Data एलिमेंट.

अगर destRemapTableEntryCount, रीमैप एंट्री की कुल संख्या से कम है, सिर्फ़ destRemapTableEntryCount की बताई गई एंट्री कॉपी की जाती हैं mappingData में.

रीमैप डेटा जोड़ें या बदलें

जोड़ने के लिए Paddleboat_addControllerRemapData फ़ंक्शन का इस्तेमाल करें एंट्री को रीमैप करें, या मौजूदा रीमैप डेटाबेस को बदलें.

void Paddleboat_addControllerRemapData(
   const Paddleboat_Remap_Addition_Mode addMode,
   const int32_t remapTableEntryCount,
   const Paddleboat_Controller_Mapping_Data* mappingData)

पैरामीटर	ब्यौरा
addMode	कार्रवाई के लिए इस्तेमाल किए गए जोड़ के नियम. मान्य मान ये हैं PADDLEBOAT_REMAP_ADD_MODE_DEFAULT या PADDLEBOAT_REMAP_ADD_MODE_REPLACE_ALL
remapTableEntryCount	इसकी अरे का साइज़ Paddleboat_Controller_Mapping_Data एलिमेंट mappingData पैरामीटर में पास किया गया है.
mappingData	इसके कलेक्शन का पॉइंटर Paddleboat_Controller_Mapping_Data एलिमेंट.

जोड़ने के मोड

अगर addMode में PADDLEBOAT_REMAP_ADD_MODE_REPLACE_ALL के बारे में बताया गया है, तो मौजूदा डेटाबेस को मिटा दिया जाता है और उसकी जगह नए अरे के कॉन्टेंट का इस्तेमाल किया जाता है.

अगर addMode में PADDLEBOAT_REMAP_ADD_MODE_DEFAULT के बारे में बताया गया है, तो ये mappingData में पास की गई कैटगरी के हर एलिमेंट पर शर्तें लागू की जाती हैं:

• अगर Paddleboat_getControllerRemapTableData यूनीक है (दूसरे शब्दों में, vendorId और productId पहले से मौजूद नहीं हैं या मौजूद नहीं हैं, लेकिन उनके पास ओवरलैप न करने वाली minApi या maxApi रेंज), तो एंट्री को इंटरनल डेटाबेस.
• अगर Paddleboat_getControllerRemapTableData यूनीक नहीं है (vendorId और productId मौजूद है और minApi या maxApi ओवरलैप है), तो यह इंटरनल डेटाबेस में मौजूदा एंट्री को बदल देता है.

Paddleboat_Controller_Mapping_Data का स्ट्रक्चर:

typedef struct Paddleboat_Controller_Mapping_Data {
    int16_t minimumEffectiveApiLevel; /** Min. API level for this entry */
    int16_t maximumEffectiveApiLevel; /** Max. API level, 0 = no max */
    int32_t vendorId; /** VendorID of the controller device for this entry */
    int32_t productId; /** ProductID of the controller device for this entry */
    int32_t flags; /** Flag bits, will be ORed with
                     * Paddleboat_Controller_Info.controllerFlags */

    /** AMOTION_EVENT_AXIS value for the corresponding Paddleboat control axis,
     *  or PADDLEBOAT_AXIS_IGNORED if unsupported. */
    uint16_t axisMapping[PADDLEBOAT_MAPPING_AXIS_COUNT];
    /** Button to set on positive or negative axis value,
     *  PADDLEBOAT_AXIS_BUTTON_IGNORED if none. */
    uint8_t axisPositiveButtonMapping[PADDLEBOAT_MAPPING_AXIS_COUNT];
    uint8_t axisNegativeButtonMapping[PADDLEBOAT_MAPPING_AXIS_COUNT];
    /** AKEYCODE_ value corresponding with the corresponding Paddleboat button.
     *  PADDLEBOAT_BUTTON_IGNORED if unsupported. */
    uint16_t buttonMapping[PADDLEBOAT_BUTTON_COUNT];
} Paddleboat_Controller_Mapping_Data;

मैपिंग का उदाहरण

यहां अपने-आप भरे गए Paddleboat_Controller_Mapping_Data को दिखाया गया है Google Stadia कंट्रोलर के बारे में बताएं:

#define PADDLEBOAT_AXIS_BUTTON_DPAD_UP 0
#define PADDLEBOAT_AXIS_BUTTON_DPAD_LEFT 1
#define PADDLEBOAT_AXIS_BUTTON_DPAD_DOWN 2
#define PADDLEBOAT_AXIS_BUTTON_DPAD_RIGHT 3
#define PADDLEBOAT_AXIS_BUTTON_L2 9
#define PADDLEBOAT_AXIS_BUTTON_R2 12

static const Paddleboat_Controller_Mapping_Data stadia_controller_map[] = {
    16, 0, 0x18d1, 0x9400, PADDLEBOAT_CONTROLLER_LAYOUT_STANDARD,
    {
        /* LX */ AMOTION_EVENT_AXIS_X,
        /* LY */ AMOTION_EVENT_AXIS_Y,
        /* RX */ AMOTION_EVENT_AXIS_Z,
        /* RY */ AMOTION_EVENT_AXIS_RZ,
        /* L1 */ PADDLEBOAT_AXIS_IGNORED,
        /* L2 */ AMOTION_EVENT_AXIS_BRAKE,
        /* R1 */ PADDLEBOAT_AXIS_IGNORED,
        /* R2 */ AMOTION_EVENT_AXIS_GAS,
        /* HX */ AMOTION_EVENT_AXIS_HAT_X,
        /* HY */ AMOTION_EVENT_AXIS_HAT_Y,
    },
    {
        /* LX */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* LY */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* RX */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* RY */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* L1 */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* L2 */ PADDLEBOAT_AXIS_BUTTON_L2,
        /* R1 */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* R2 */ PADDLEBOAT_AXIS_BUTTON_R2,
        /* HX */ PADDLEBOAT_AXIS_BUTTON_DPAD_RIGHT,
        /* HY */ PADDLEBOAT_AXIS_BUTTON_DPAD_DOWN,
    },
    {
        /* LX */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* LY */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* RX */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* RY */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* L1 */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* L2 */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* R1 */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* R2 */ PADDLEBOAT_AXIS_BUTTON_IGNORED,
        /* HX */ PADDLEBOAT_AXIS_BUTTON_DPAD_LEFT,
        /* HY */ PADDLEBOAT_AXIS_BUTTON_DPAD_UP,
    },
    {
        /* UP     */ AKEYCODE_DPAD_UP,
        /* LEFT   */ AKEYCODE_DPAD_LEFT,
        /* DOWN   */ AKEYCODE_DPAD_DOWN,
        /* RIGHT  */ AKEYCODE_DPAD_RIGHT,
        /* A      */ AKEYCODE_BUTTON_A,
        /* B      */ AKEYCODE_BUTTON_B,
        /* X      */ AKEYCODE_BUTTON_X,
        /* Y      */ AKEYCODE_BUTTON_Y,
        /* L1     */ AKEYCODE_BUTTON_L1,
        /* L2     */ AKEYCODE_BUTTON_L2,
        /* L3     */ AKEYCODE_BUTTON_THUMBL,
        /* R1     */ AKEYCODE_BUTTON_R1,
        /* R2     */ AKEYCODE_BUTTON_R2,
        /* R3     */ AKEYCODE_BUTTON_THUMBR,
        /* SELECT */ AKEYCODE_BUTTON_SELECT,
        /* START  */ AKEYCODE_BUTTON_START,
        /* SYSTEM */ AKEYCODE_BUTTON_MODE,
        /* TOUCHP */ PADDLEBOAT_BUTTON_IGNORED,
        /* AUX1   */ PADDLEBOAT_BUTTON_IGNORED,
        /* AUX2   */ PADDLEBOAT_BUTTON_IGNORED,
        /* AUX3   */ PADDLEBOAT_BUTTON_IGNORED,
        /* AUX4   */ PADDLEBOAT_BUTTON_IGNORED
    }
};