ตั้งค่า C หรือ C++ ดั้งเดิมเวอร์ชัน 2

เอกสารนี้จะช่วยคุณตั้งค่าโปรเจ็กต์ C++ สำหรับ C หรือ C++ ดั้งเดิมเวอร์ชัน 2 และยืนยันบริการตรวจสอบสิทธิ์

ก่อนจะเริ่มต้น

คุณต้องตั้งค่าบริการเกมของ Play ใน Google Play Console

ข้อกำหนดเบื้องต้นของแอป

ตรวจสอบว่าไฟล์บิลด์ของแอปใช้ค่าต่อไปนี้

minSdkVersion ตั้งแต่ 19 ขึ้นไป
compileSdkVersion ตั้งแต่ 28 ขึ้นไป

สร้างโปรเจ็กต์เกม

ทำตามขั้นตอนต่อไปนี้เพื่อตั้งค่าโปรเจ็กต์เกม

อัปเดต build.gradle

ในไฟล์ build.gradle ระดับแอป ให้ทำดังนี้

ตรวจสอบว่าได้เปิดใช้ฟีเจอร์บิลด์ Prefab แล้ว
เพิ่มการอ้างอิงสำหรับ Native SDK v2 (เบต้า)
- com.google.android.gms:play-services-games-v2-native-c:21.0.0-beta1

ตัวอย่างเช่น

  android {
    ...
    buildFeatures {
      prefab true
    }
    ...
  }
  dependencies {
    ...
    implementation "com.google.android.gms:play-services-games-v2-native-c:21.0.0-beta1"
  }

อัปเดต CMakeLists.txt

เพิ่มโค้ดต่อไปนี้ในไฟล์ CMakeLists.txt

  find_package(com.google.android.gms.games.v2.c REQUIRED CONFIG)

  // link games_static for -DANDROID_STL=c++_static or default
  // link games_shared for -DANDROID_STL=c++_shared
  target_link_libraries(
    app PUBLIC com.google.android.gms.games.v2.c::games_static)

อัปเดต AndroidManifest.xml

หากต้องการกำหนดรหัสโปรเจ็กต์บริการเกมของ Play ในไฟล์ AndroidManifest.xml ให้เพิ่มบรรทัดต่อไปนี้
```
<manifest>
  <application>
    <meta-data android:name="com.google.android.gms.games.APP_ID"
               android:value="@string/game_services_project_id"/>
  </application>
</manifest>
```
สร้างทรัพยากรสตริง สำหรับรหัสโปรเจ็กต์ ซึ่งจะช่วยให้เกมเข้าถึงรหัสได้ในเวลาบิลด์ หากต้องการสร้างทรัพยากร ให้สร้างไฟล์ project_root/app/src/main/res/values/games-ids.xml แล้วเพิ่มข้อมูลต่อไปนี้
```
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="game_services_project_id"
            translatable="false">add your Project ID here</string>
</resources>
```
สร้างและทดสอบเกม หากสำเร็จ เมื่อคุณเปิดเกม เกมจะแสดงข้อความแจ้งให้ลงชื่อเข้าใช้หรือแบนเนอร์การลงชื่อเข้าใช้ที่สำเร็จ

หากผู้เล่นปฏิเสธข้อความแจ้งให้ลงชื่อเข้าใช้บริการเกมของ Play ครั้งแรกซึ่งจะ แสดงโดยอัตโนมัติเมื่อเกมเปิดตัว ผู้เล่นอาจเปลี่ยนใจ ในระหว่างเซสชันเกม คุณเปิดใช้ข้อความแจ้งให้ลงชื่อเข้าใช้อีกครั้งได้โดยการเรียกใช้ PgsGamesSignInClient_signIn ตราบใดที่ไม่มีผู้เล่นที่ได้รับการตรวจสอบสิทธิ์

การให้สิทธิ์เซิร์ฟเวอร์เกม

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

ดูข้อมูลเพิ่มเติมได้ที่คำแนะนำในการเข้าถึงเซิร์ฟเวอร์