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

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

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

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

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

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

• minSdkVersion เป็น 19 ขึ้นไป
• compileSdkVersion เป็น 28 ขึ้นไป

ตั้งค่าโปรเจ็กต์เกม

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

อัปเดต build.gradle

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

• ตรวจสอบว่าได้เปิดใช้ฟีเจอร์บิลด์ Prefab แล้ว

• เพิ่มการพึ่งพาสำหรับ v2 Native SDK (เบต้า) ดังนี้

  • 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

1. หากต้องการกำหนดรหัสโปรเจ็กต์บริการเกมของ 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>
   

2. สร้างทรัพยากรสตริง สำหรับรหัสโปรเจ็กต์ ซึ่งจะช่วยให้เกมเข้าถึงรหัสได้ในระหว่างบิลด์ หากต้องการสร้างทรัพยากร ให้สร้างไฟล์ 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>
   

3. สร้างและทดสอบเกม หากสำเร็จ เมื่อเปิดเกม เกมจะแสดงข้อความแจ้งให้ลงชื่อเข้าใช้หรือแบนเนอร์การลงชื่อเข้าใช้สำเร็จ

เปิดข้อความแจ้งให้ลงชื่อเข้าใช้อีกครั้ง

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

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

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

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