คลังเกมคอนโทรลเลอร์ เป็นส่วนหนึ่งของชุดเครื่องมือพัฒนาเกม Android

ไลบรารีเกมคอนโทรลเลอร์ (หรือที่รู้จักในชื่อ "แพดเดิลโบ๊ท)" จะช่วยให้คุณใช้การสนับสนุนที่มีประสิทธิภาพ สำหรับอุปกรณ์ควบคุมเกม ไลบรารีประกอบด้วยรายการต่อไปนี้

  • การเรียกกลับสำหรับการตรวจหาการเชื่อมต่อและการตัดการเชื่อมต่อตัวควบคุม
  • ข้อมูลอุปกรณ์ตัวควบคุม รวมถึงรูปแบบและเลย์เอาต์ของปุ่ม
  • ข้อมูลอินพุตของตัวควบคุม ทำให้เป็นมาตรฐานเดียวกับตัวควบคุม Dual-Stick ที่ทันสมัย การออกแบบ
  • ฟีเจอร์เพิ่มเติมในตัวควบคุมที่รองรับ รวมถึงการสั่น แสงไฟ ข้อมูลแกนการเคลื่อนไหวและสถานะแบตเตอรี่
  • ความสามารถในการอ่านอินพุตจากอุปกรณ์เมาส์เสมือนและอุปกรณ์จริง
  • ความสามารถในการระบุข้อมูลการแมปตัวควบคุมที่กำหนดเองสำหรับอุปกรณ์ที่เฉพาะเจาะจง

ข้อกำหนดความเข้ากันได้

ไลบรารีเกมคอนโทรลเลอร์มีข้อกำหนดความเข้ากันได้ขั้นต่ำดังต่อไปนี้

  • Android 4.4 (API ระดับ 19) ขึ้นไป
  • Android NDK เวอร์ชัน 21 ขึ้นไป

ผสานการทำงาน

ไลบรารีตัวควบคุมเกมมี 2 รูปแบบด้วยกัน ได้แก่ เป็น Jetpack ไลบรารีสำหรับเกมที่ใช้ระบบบิลด์แบบ Gradle (รวมถึง Android Studio) และเป็นไฟล์ที่แยกไว้ต่างหากสำหรับเกมที่ใช้ระบบบิลด์ที่กำหนดเอง

สำหรับตัวอย่างที่ผสานรวมไลบรารีเกมคอนโทรลเลอร์ โปรดดูที่ ที่เก็บตัวอย่างเกม

ไลบรารี Jetpack

หน้า Jetpack Android Games มี คำแนะนำในการผสานรวม เพื่อเพิ่มการอ้างอิงไลบรารีของ Game Controller ลงใน build.gradle ของเกม

เกมคอนโทรลเลอร์ที่เปิดตัวไลบรารี Jetpack เป็นแบบคงที่ ที่สร้างร่วมกับไลบรารีที่ใช้ร่วมกันรันไทม์ C++

หลังจากอัปเดตไฟล์ build.gradle คุณจะต้องเพิ่มข้อมูลต่อไปนี้ ไปยังไฟล์ CMakeLists.txt หลักของเกมของคุณ:

find_package(games-controller REQUIRED CONFIG)

นอกจากนี้ คุณยังต้องเพิ่มรายการต่อไปนี้ในรายการไลบรารี ในคำสั่ง target_link_libraries ของไฟล์หลักของเกมที่แชร์ คลัง:

games-controller::paddleboat_static

ไฟล์แบบไม่ต่อเนื่อง

การเผยแพร่ที่เก็บถาวรของ Android Game Development Kit ใน .zip ประกอบด้วย ส่วนหัวและไฟล์ไลบรารีสำหรับไลบรารี Game Controller ไฟล์ต่อไปนี้ ต้องรวมอยู่ในโปรเจ็กต์ของคุณเพื่อใช้ไลบรารีเกมคอนโทรลเลอร์:

  • ไฟล์ classes.jar ที่มีส่วนไบต์โค้ด Dalvik ของ คลังเกมคอนโทรลเลอร์ ไฟล์นี้อยู่ที่ libs/classes.jar
  • ไฟล์ส่วนหัวของอินเทอร์เฟซ paddleboat.h ไฟล์นี้อยู่ที่ include/paddleboat/paddleboat.h
  • ไฟล์ไลบรารีที่ใช้ร่วมกันของ libpaddleboat.so หรือ ไฟล์ไลบรารีแบบคงที่ libpaddleboat-static.a ไฟล์ พบไฟล์เหล่านี้ ในไดเรกทอรีย่อยการกำหนดค่าบิลด์ภายในไดเรกทอรี libs

ไดเรกทอรีย่อยการกำหนดค่าบิลด์ภายใต้ไดเรกทอรีราก libs มีลักษณะดังนี้ จัดหมวดหมู่ตาม:

  • สถาปัตยกรรม ABI
  • ระดับ API ขั้นต่ำของ Android
  • เวอร์ชัน Android NDK
  • เวอร์ชันไลบรารีรันไทม์ C++
  • เผยแพร่หรือแก้ไขข้อบกพร่องของการกำหนดค่าบิลด์

ตัวอย่างเช่น ไดเรกทอรีย่อย arm64-v8a_API16_NDK21_cpp_shared_Release มีไฟล์ไลบรารีสำหรับ:

  • ARM 64 บิตของ ARM
  • ขั้นต่ำของ API ระดับ 16
  • สร้างขึ้นบน NDK เวอร์ชัน 21
  • สร้างตามรันไทม์ C++ เวอร์ชันไลบรารีที่ใช้ร่วมกัน
  • การกำหนดค่าบิลด์ของรุ่น

ไฟล์ libpaddleboat_static.a อยู่ในไดเรกทอรีย่อยโดยตรง ไฟล์ libpaddleboat.so อยู่ที่ lib/paddleboat/ ภายในไดเรกทอรีย่อย

ขั้นตอนถัดไป

ดูคำแนะนำต่อไปนี้เพื่อผสานรวมคลังเกมคอนโทรลเลอร์เข้ากับเกมต่อไป