เริ่มต้นใช้งานบริการเกมของ Play สำหรับภาษา C++ บน Android

หลังจากเลิกใช้งาน API ของ Google Sign-In แล้ว เราจะนำ SDK v1 ของเกมออกในปี 2026 หลังจากเดือนกุมภาพันธ์ 2025 คุณจะเผยแพร่ เกมที่เพิ่งผสานรวมกับ SDK v1 ของ Games ใน Google Play ไม่ได้ เราขอแนะนำให้ใช้ SDK v2 ของ Games แทน
แม้ว่าเกมที่มีอยู่ซึ่งผสานรวมกับเกมเวอร์ชัน 1 ก่อนหน้าจะยังคงทำงานได้อีก 2-3 ปี แต่เราขอแนะนำให้คุณย้ายข้อมูลไปยัง v2 ตั้งแต่เดือนมิถุนายน 2025 เป็นต้นไป
คู่มือนี้มีไว้สำหรับการใช้ SDK บริการเกมของ Play เวอร์ชัน 1 SDK สำหรับ C++ สำหรับ บริการเกมของ Play v2 ยังไม่พร้อมใช้งาน

คู่มือนักพัฒนาแอปนี้จะแสดงวิธีคอมไพล์และเรียกใช้เกม C++ ใน Android ที่ใช้ Google Play Game Services API ก่อนเริ่มต้น ให้ดาวน์โหลดและกำหนดค่าข้อกำหนดต่อไปนี้

คู่มือนักพัฒนาซอฟต์แวร์นี้ใช้ Android Native Development Kit (NDK) หากคุณไม่คุ้นเคยกับ NDK โปรดดูเอกสารประกอบและตัวอย่างของ NDK ก่อนดำเนินการต่อ

ขั้นตอนที่ 1: ตั้งค่าสภาพแวดล้อม

  1. ดาวน์โหลด Android SDK และ Android NDK แล้วแตกไฟล์ไปยังเครื่องของคุณ ใน สภาพแวดล้อม ให้ตั้งค่า SDK_ROOT เป็นตำแหน่งของโฟลเดอร์ Android SDK และ NDK_ROOT เป็นตำแหน่งของโฟลเดอร์ Android NDK
  2. ดาวน์โหลดเกมตัวอย่าง C++ คู่มือนักพัฒนาซอฟต์แวร์นี้อ้างอิงถึงตำแหน่งของตัวอย่างในเครื่องของคุณเป็น SAMPLES_DIR
  3. ดาวน์โหลด C++ SDK ของบริการเกมของ Google Play แตกไฟล์ SDK ลงในเครื่องที่ใช้พัฒนา ในสภาพแวดล้อมของคุณ ให้ตั้งค่าตัวแปร NDK_MODULE_PATH เป็น ชี้ไปยังไดเรกทอรีเหนือไดเรกทอรี gpg-cpp-sdk คุณควรมีโครงสร้างไดเรกทอรีต่อไปนี้ 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. เปิด Eclipse หากยังไม่ได้ทำ ให้บอก Eclipse ว่าคุณติดตั้ง NDK ไว้ที่ใดโดย คลิกค่ากำหนด > Android > NDK

  5. นำเข้าโปรเจ็กต์ไลบรารีบริการ Google Play ไปยังพื้นที่ทำงาน Eclipse

    1. ใน Eclipse ให้คลิก File > Import > Android > Existing Android Code into Workspace
    2. เลือก SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib where SDK_ROOT is the location of your Android SDK.
    3. คลิกเสร็จสิ้น

  6. นำเข้าโปรเจ็กต์ตัวอย่างแบบมินิมัลลงในพื้นที่ทำงาน Eclipse

    1. ใน Eclipse ให้คลิก File > Import > Android > Existing Android Code into Workspace
    2. เลือก SAMPLES_DIR/samples-android/minimalist
    3. คลิกเสร็จสิ้น

  7. คลิกขวาที่โปรเจ็กต์ MinimalistActivity แล้วคลิก Properties ในส่วน Android ให้เลื่อนลงไปที่ส่วนคลังและตรวจสอบว่าโปรเจ็กต์ google-play-services_lib มีการอ้างอิงอย่างถูกต้อง หากไม่มี ให้นำการอ้างอิงออกแล้วเพิ่มอีกครั้งจากพื้นที่ทำงาน

Eclipse จะคอมไพล์แหล่งที่มาของ Java และ Android ของโปรเจ็กต์โดยอัตโนมัติ แต่คุณต้องคอมไพล์โค้ดเนทีฟในโฟลเดอร์ jni แยกต่างหาก หากต้องการดำเนินการนี้ด้วยตนเอง ให้ไปที่โฟลเดอร์ jni แล้วเรียกใช้ ndk-build อย่าลืมทำขั้นตอนนี้หลังจากทำการเปลี่ยนแปลงในโฟลเดอร์ jni

ตอนนี้โปรเจ็กต์ควรคอมไพล์ได้แล้ว แต่จะยังใช้งานไม่ได้ คุณต้องกำหนดค่าเกม ใน Google Play Console ก่อน

ขั้นตอนที่ 2: ตั้งค่าเกมใน Google Play Console

สร้างรายการสำหรับเกมของคุณใน Google Play Console ซึ่งจะเปิดใช้บริการเกมสำหรับแอปพลิเคชันของคุณ และสร้างรหัสไคลเอ็นต์ OAuth 2.0 หากคุณยังไม่มี

  1. สร้างรายการสำหรับเกมโดยทำตามขั้นตอนที่อธิบายไว้ในการตั้งค่าบริการเกมของ Google Play
  2. ใน AndroidManifest.xml ให้เปลี่ยนแอตทริบิวต์ package ของแท็ก <manifest> เป็นชื่อแพ็กเกจที่คุณเลือกเมื่อตั้งค่า Google Play Console คุณอาจต้องแก้ไขการอ้างอิงบางอย่าง ในโปรเจ็กต์หลังจากทำการเปลี่ยนแปลงนี้ (โดยเฉพาะในคลาส R ที่สร้างขึ้น)
  3. เปิด res/values/ids.xml แล้ววางรหัสแอปของคุณ โปรดทราบว่ารหัสแอปจะไม่เหมือนกับรหัสไคลเอ็นต์ แต่จะเป็นหมายเลขข้างชื่อเกมในหน้ารายละเอียดเกมของ Google Play Console

ขั้นตอนที่ 3: เรียกใช้ตัวอย่าง

หากต้องการเรียกใช้ตัวอย่าง คุณจะต้องมีอุปกรณ์ Android จริงหรือโปรแกรมจำลองที่มี บริการ Google Play ติดตั้งอยู่

  1. เรียกใช้ ndk-build เพื่อคอมไพล์โค้ดที่มาพร้อมเครื่อง
  2. ใน Eclipse ให้คลิกเรียกใช้ > เรียกใช้เป็น > แอปพลิเคชัน Android แล้วเรียกใช้ตัวอย่างในอุปกรณ์
  3. เมื่อตัวอย่างเปิดขึ้น ให้แตะที่ใดก็ได้บนหน้าจอ คุณควรเห็นโลโก้ Google Play Games ปรากฏขึ้น หากกำหนดค่าแอปอย่างถูกต้องแล้ว ระบบจะแจ้งให้คุณลงชื่อเข้าใช้

ไม่บังคับ: สร้างโดยอัตโนมัติด้วย Eclipse

ขั้นตอนต่อไปนี้แสดงวิธีกำหนดค่า Eclipse ให้เรียกใช้ ndk-build โดยอัตโนมัติเมื่อคุณ ทำการเปลี่ยนแปลงไฟล์ในโฟลเดอร์ jni

  1. คลิกขวาที่โปรเจ็กต์ MinimalistActivity แล้วคลิก Properties ในหน้าต่างพร็อพเพอร์ตี้ ให้เลือกบานหน้าต่างเครื่องมือสร้าง
  2. คลิกใหม่เพื่อเพิ่มเครื่องมือสร้างใหม่ แล้วเลือกโปรแกรม จากนั้นคลิกตกลง
  3. ในช่องชื่อ ให้ป้อน "NDK Builder"
  4. ในส่วนตำแหน่ง ให้คลิกเรียกดูระบบไฟล์ แล้วไปที่ไดเรกทอรี NDK_ROOT และ เลือกคำสั่ง ndk-build
  5. ในส่วนไดเรกทอรีการทำงาน ให้คลิกเรียกดูพื้นที่ทำงาน แล้วเลือกโฟลเดอร์โปรเจ็กต์ MinimalistActivity
  6. คลิกแท็บรีเฟรช ตรวจสอบว่าได้เลือกช่องรีเฟรชทรัพยากรเมื่อเสร็จสมบูรณ์แล้ว
  7. เลือกปุ่มตัวเลือกทรัพยากรที่เฉพาะเจาะจง แล้วคลิกระบุทรัพยากร ในกล่องโต้ตอบที่ปรากฏขึ้น ให้เลือกโฟลเดอร์ jni ในส่วน MinimalActivity
  8. คลิกใช้ แล้วคลิกตกลงเพื่อสร้าง Builder ให้เสร็จสิ้น

ตอนนี้ทุกครั้งที่คุณแก้ไขไฟล์ภายในโฟลเดอร์ jni Eclipse จะเรียกใช้ ndk-build และพิมพ์เอาต์พุตไปยังคอนโซล Eclipse