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

ดังที่แสดงในแผนภาพก่อนหน้า GameActivity จะทำหน้าที่ต่อไปนี้
- การโต้ตอบกับเฟรมเวิร์ก Android ผ่านคอมโพเนนต์ฝั่ง Java
- ส่งคำสั่งวงจรของแอป เหตุการณ์อินพุต และข้อความอินพุตไปยังฝั่งเนทีฟ
- การสร้างโมเดลซอร์สโค้ด C/C++ เป็นคอมโพเนนต์เชิงตรรกะ 3 รายการ ได้แก่
- ฟังก์ชัน JNI ของ GameActivity ซึ่งรองรับฟังก์ชันการทำงาน Java ของ GameActivity โดยตรงและจัดคิวเหตุการณ์ไปยัง
native_app_glue native_app_glueซึ่งส่วนใหญ่จะทำงานในเทรดเนทีฟของตัวเอง (แตกต่างจากเทรดหลักของแอปพลิเคชัน) และดำเนินการงานด้วย Looper- โค้ดเกมของแอปพลิเคชัน ซึ่งจะสำรวจและประมวลผลเหตุการณ์ที่อยู่ในคิวภายใน
native_app_glueและเรียกใช้โค้ดเกมภายในเธรดnative_app_glue
- ฟังก์ชัน JNI ของ GameActivity ซึ่งรองรับฟังก์ชันการทำงาน Java ของ GameActivity โดยตรงและจัดคิวเหตุการณ์ไปยัง
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 พร้อมใช้งานในช่องทางต่อไปนี้
- เป็นส่วนหนึ่งของไลบรารี Android Jetpack (แนะนำ)
- เป็นซอร์สโค้ด AOSP
โค้ด 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 และ AGDK
- ใช้ GameTextInput ใน GameActivity
- คำแนะนำในการย้ายข้อมูล NativeActivity
- เอกสารอ้างอิง GameActivity
- การติดตั้งใช้งาน GameActivity
ความคิดเห็น
หากต้องการรายงานข้อบกพร่องหรือขอฟีเจอร์ใหม่สำหรับ GameActivity ให้ใช้เครื่องมือติดตามปัญหาของ GameActivity