ไลบรารี Game Controller จะดูแลฐานข้อมูลภายในของอุปกรณ์ คอนโทรลเลอร์ ซึ่งใช้เพื่อกำหนดค่าปุ่ม รูปแบบแกนการเคลื่อนไหว การแมปสำหรับ คอนโทรลเลอร์ที่รู้จัก และการแมปเริ่มต้นสำหรับคอนโทรลเลอร์ที่ไม่รู้จัก ฐานข้อมูลมีตัวควบคุมยอดนิยมมากมาย แต่อาจไม่มีอุปกรณ์ทั้งหมด ที่เกี่ยวข้องกับเกมใดเกมหนึ่ง ไลบรารีเกมคอนโทรลเลอร์รองรับการปรับแต่ง ด้วยฟังก์ชันที่ทำสิ่งต่อไปนี้ได้
- ดึงข้อมูลฐานข้อมูลการแมปปัจจุบัน
- เพิ่มรายการลงในฐานข้อมูลที่มีอยู่
- แทนที่รายการฐานข้อมูลที่มีอยู่
- แทนที่ฐานข้อมูลปัจจุบันทั้งหมดด้วยฐานข้อมูลใหม่
ระบุอุปกรณ์
ระบบจะระบุอุปกรณ์ควบคุมตามค่า productId
และ vendorId
อุปกรณ์ควบคุมที่ระบบรู้จักแต่ละเครื่องจะมีข้อมูลอย่างน้อย 1 รายการในฐานข้อมูลที่มี productId
และ vendorId
ที่ตรงกัน โครงสร้างการแมปตัวควบคุมมีฟิลด์ที่ระบุช่วง Android API ขั้นต่ำและสูงสุดที่มีสิทธิ์สำหรับรายการ รายการหลายรายการที่มี productId
และ vendorId
เดียวกันอาจอยู่ในฐานข้อมูลตราบใดที่มีช่วง API ต่ำสุดและสูงสุดที่ไม่ซ้ำกัน
อ่านข้อมูลการแมปใหม่ปัจจุบัน
ใช้ฟังก์ชัน Paddleboat_getControllerRemapTableData
เพื่อ
ดึงข้อมูลการแมปใหม่ปัจจุบัน
int32_t Paddleboat_getControllerRemapTableData(
const int32_t destRemapTableEntryCount,
Paddleboat_Controller_Mapping_Data* mappingData)
Paddleboat_getControllerRemapTableData
แสดงผลจำนวนรายการ remap ทั้งหมด
ที่มีอยู่ในฐานข้อมูลภายใน
พารามิเตอร์ | คำอธิบาย |
---|---|
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 |
โหมดการบวก
หากระบุ PADDLEBOAT_REMAP_ADD_MODE_REPLACE_ALL
ใน addMode
ระบบจะลบฐานข้อมูลที่มีอยู่และแทนที่ด้วยเนื้อหาของอาร์เรย์ใหม่
หากระบุ PADDLEBOAT_REMAP_ADD_MODE_DEFAULT
ใน addMode
ระบบจะใช้เกณฑ์ต่อไปนี้กับแต่ละองค์ประกอบในอาร์เรย์ที่ส่งใน 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 Controller
#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
}
};