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

GameActivity เป็นไลบรารี Jetpack ที่ออกแบบมาเพื่อช่วยเกม Android ในการประมวลผลคำสั่งวงจรของแอป เหตุการณ์การป้อนข้อมูล และการป้อนข้อความในโค้ด C/C++ ของแอปพลิเคชัน GameActivity เป็นผู้สืบทอดโดยตรงของ NativeActivity และใช้สถาปัตยกรรมที่คล้ายกัน ดังนี้

alt_text

ดังที่แสดงในแผนภาพก่อนหน้า GameActivity จะทำหน้าที่ต่อไปนี้

  • การโต้ตอบกับเฟรมเวิร์ก Android ผ่านคอมโพเนนต์ฝั่ง Java
  • ส่งคำสั่งวงจรของแอป เหตุการณ์อินพุต และข้อความอินพุตไปยังฝั่งเนทีฟ
  • การสร้างโมเดลซอร์สโค้ด C/C++ เป็นคอมโพเนนต์เชิงตรรกะ 3 รายการ ได้แก่
    • ฟังก์ชัน JNI ของ GameActivity ซึ่งรองรับฟังก์ชันการทำงาน Java ของ GameActivity โดยตรงและจัดคิวเหตุการณ์ไปยัง native_app_glue
    • native_app_glue ซึ่งส่วนใหญ่จะทำงานในเทรดเนทีฟของตัวเอง (แตกต่างจากเทรดหลักของแอปพลิเคชัน) และดำเนินการงานด้วย Looper
    • โค้ดเกมของแอปพลิเคชัน ซึ่งจะสำรวจและประมวลผลเหตุการณ์ที่อยู่ในคิวภายใน native_app_glue และเรียกใช้โค้ดเกมภายในเธรด native_app_glue

GameActivity ช่วยให้คุณมุ่งเน้นไปที่การพัฒนาเกมหลักและหลีกเลี่ยงการใช้เวลามากเกินไปในการจัดการกับโค้ด JNI

หากคุณคุ้นเคยกับ NativeActivity อยู่แล้ว ความแตกต่างที่สำคัญระหว่าง GameActivity กับ NativeActivity มีดังนี้

  • GameActivity จะแสดงผลเป็น SurfaceView ซึ่งช่วยให้เกมโต้ตอบกับคอมโพเนนต์ UI อื่นๆ ได้ง่ายขึ้นมาก
  • สำหรับเหตุการณ์การป้อนข้อมูลด้วยการสัมผัสและแป้นพิมพ์ GameActivity มีการใช้งานใหม่ทั้งหมดด้วยอินเทอร์เฟซ android_input_buffer ซึ่งแยกจาก InputQueue ที่ NativeActivity ใช้
  • GameActivity เป็นคลาสที่ได้มาจาก AppCompatActivity ซึ่งช่วยให้คุณใช้คอมโพเนนต์อื่นๆ ของ Jetpack ได้อย่างราบรื่น ActionBar, Fragment และอื่นๆ พร้อมให้บริการแล้ว
  • GameActivity เพิ่มฟังก์ชันการป้อนข้อความโดยผสานรวมไลบรารี GameTextInput
  • แอปที่มาจาก GameActivity ควรสร้างโค้ด C/C++ ทั้ง 3 ส่วนเป็นไลบรารีเดียว ในทางกลับกัน ฟังก์ชัน JNI ของ NativeActivity เป็นส่วนหนึ่งของเฟรมเวิร์ก (ระบบปฏิบัติการจะโหลดเสมอ) ดังนั้นจึงคาดว่าจะมีเพียง native_app_glue และโค้ด C/C++ ของแอปพลิเคชันเท่านั้นที่จะสร้างเป็นไลบรารีเดียว
  • NativeActivity เป็นส่วนหนึ่งของเฟรมเวิร์ก Android และเป็นไปตามรอบการเผยแพร่ (โดยปกติจะเป็นรายปี) GameActivity เป็นส่วนหนึ่งของไลบรารี Jetpack ซึ่งมีรอบการเปิดตัวที่ถี่กว่ามาก (โดยปกติคือทุก 2 สัปดาห์) ฟีเจอร์ใหม่และการแก้ไขข้อบกพร่องจึงพร้อมใช้งานได้เร็วกว่ามาก

สถานที่วางจำหน่าย

ไลบรารี GameActivity พร้อมใช้งานในช่องทางต่อไปนี้

โค้ด C/C++ จะอยู่ในรูปแบบซอร์สโค้ดในเวอร์ชันการเผยแพร่ทั้งหมด โดยใช้รูปแบบ Prefab GameActivity เวอร์ชัน 1.2.2 เพิ่มไลบรารีแบบคงที่ลงในการเผยแพร่ ตั้งแต่เวอร์ชันนี้เป็นต้นไป เราขอแนะนำให้คุณใช้ไลบรารีแบบคงที่แทนซอร์สโค้ด

เนื้อหาของไลบรารี Jetpack

GameActivity เปิดตัวพร้อมกับ AAR ในไลบรารี Jetpack AAR นี้ประกอบด้วยคอมโพเนนต์หลักๆ ต่อไปนี้

  • ไฟล์ JAR สำหรับโค้ด Java
  • ไลบรารีแบบคงที่ C/C++ game-activity_static รวมอยู่ใน GameActivity เวอร์ชัน 1.2.2 ขึ้นไป
  • ซอร์สโค้ด C/C++ (ในโฟลเดอร์ /prefab)

วิธีการผสานรวมที่ลิงก์จากหน้านี้ถือว่าคุณใช้ Prefab ในระบบบิลด์ได้ ไม่เช่นนั้น คุณสามารถคัดลอกซอร์สโค้ดที่แพ็กไว้ในโฟลเดอร์ prefab/modules/game-activity/include ไปยังระบบบิลด์และทำตามขั้นตอนการผสานรวมที่จำเป็นได้ โครงสร้างไฟล์ที่คล้ายกันมีอยู่สำหรับรุ่นต่างๆ ใน androidx สำหรับไลบรารี Android Jetpack โดยค่าเริ่มต้น gradle จะแตกไฟล์ AAR ในไดเรกทอรีแคช (~/.gradle/caches/...) คุณดูซอร์สโค้ด C/C++ ได้โดยค้นหา prefab/modules/game-activity/include และเลือกตำแหน่งในเวอร์ชันที่เผยแพร่ที่ต้องการ

ดูวิธีการผสานรวมโดยใช้ไลบรารี Jetpack ได้ที่หัวข้อเริ่มต้นใช้งาน GameActivity

เนื้อหาของซอร์สโค้ด AOSP

AOSP จะมีซอร์สโค้ดล่าสุดเสมอ ทำตามวิธีการสร้างเพื่อสร้างรุ่นของคุณเองหรือผสานรวมแหล่งที่มาเข้ากับสภาพแวดล้อมของบิลด์โดยตรง ซอร์สโค้ด C/C++ จะบันทึกอยู่ในโครงสร้างไฟล์ที่คล้ายกับไลบรารี Jetpack

คู่มือการผสานรวม

ทำตามคำแนะนำเหล่านั้นเพื่อผสานรวม GameActivity เข้ากับแอปพลิเคชันของคุณ

แหล่งข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมเกี่ยวกับ GameActivity ได้ที่หัวข้อต่อไปนี้

ความคิดเห็น

หากต้องการรายงานข้อบกพร่องหรือขอฟีเจอร์ใหม่สำหรับ GameActivity ให้ใช้เครื่องมือติดตามปัญหาของ GameActivity