ภาพรวมการย้ายข้อมูล

บริการเกมของ Google Play และ SDK v1 ของเกมใช้ Google Sign-In สำหรับ Android ซึ่งเลิกใช้งานแล้วและจะนำออกจาก SDK การตรวจสอบสิทธิ์ของบริการ Google Play (com.google.android.gms:play-services-auth) ในปี 2025 แอปเกมใหม่จะใช้ Games v1 ได้จนถึงปี 2025 การนำ Google Sign-In ออก จะทำให้เกิดปัญหาการขึ้นต่อกันสำหรับแอปเกมที่มีอยู่ การย้ายข้อมูลเกม แอปที่มีอยู่จาก SDK v1 ของเกม ไปยัง SDK v2 ของเกม จะช่วยแก้ปัญหาเกี่ยวกับ Dependency ที่เกิดจากการนำ Google Sign-In ออก

เอกสารนี้จะช่วยให้คุณเข้าใจการโต้ตอบระหว่างแอปพลิเคชันเกมกับ SDK ต่างๆ เอกสารนี้ยังเปรียบเทียบฟีเจอร์ของแอปพลิเคชันกับฟีเจอร์ของ SDK บริการเกมของ Play เวอร์ชัน 1 และ SDK ของเกมเวอร์ชัน 2 ด้วย

การโต้ตอบของ SDK

แผนภาพแสดงการโต้ตอบระหว่างแอปพลิเคชันเกมบน Android, Google Mobile Services (GMS) Core, บริการเกมของ Play และเซิร์ฟเวอร์เกมของบุคคลที่สาม (3P) โดยจะเน้นวิธีที่แอปพลิเคชันใช้บริการของ Google สำหรับการตรวจสอบสิทธิ์และฟีเจอร์เกม รวมถึงการโต้ตอบกับระบบของบุคคลที่สามที่แยกต่างหาก

เกม v2 (ปัจจุบัน)

การโต้ตอบระหว่างแอปพลิเคชันเกมใน
    Android, GMS Core, บริการเกมของ Play
    และเซิร์ฟเวอร์เกมของบุคคลที่สาม (3P)
การโต้ตอบระหว่างแอปพลิเคชันเกมบน Android, GMS Core, บริการเกมของ Play และเซิร์ฟเวอร์เกมของบุคคลที่สาม (3P) (คลิกเพื่อขยาย)

เกม v1 (เดิม)

การโต้ตอบระหว่างแอปพลิเคชันเกมใน
    Android, GMS Core, บริการเกมของ Play
    และเซิร์ฟเวอร์เกมของบุคคลที่สาม (3P)
การโต้ตอบระหว่างแอปพลิเคชันเกมใน Android, GMS Core, บริการเกมของ Play และเซิร์ฟเวอร์เกมของบุคคลที่สาม (3P) (คลิกเพื่อขยาย)

ภาพรวมคร่าวๆ ของคอมโพเนนต์และ SDK มีดังนี้

  • แอปพลิเคชันเกม
    • ซึ่งแสดงถึงแอปพลิเคชันเกมของผู้ใช้ที่ทำงานบนอุปกรณ์ที่ใช้ระบบ Android
    • ซึ่งประกอบด้วยคอมโพเนนต์หลัก 2 รายการ ดังนี้
      • SDK v1 หรือ v2 ของ Games SDK ฝั่งไคลเอ็นต์ ที่รับผิดชอบในการโต้ตอบกับบริการเกมของ Play
      • SDK การตรวจสอบสิทธิ์ Auth SDK ของบริการ Google Play มีหน้าที่จัดการ ขั้นตอนการตรวจสอบสิทธิ์และการให้สิทธิ์ผู้ใช้ในเกม v1
    • ทั้ง 2 SDK สื่อสารกันโดยใช้ AIDL (ภาษาที่ใช้สื่อสารข้อมูลระหว่างคอมโพเนนต์ของ Android) ซึ่งบ่งบอกรูปแบบการสื่อสารระหว่างกระบวนการหรือบริการต่างๆ
  • GMS Core หรือที่เรียกว่าบริการ Google Play
    • นี่คือเลเยอร์ที่เป็นกรรมสิทธิ์ของ Google ใน Android
    • แอปพลิเคชันเกมใช้โมดูล GMS Core 2 โมดูล ได้แก่
      • โมดูลเกมมีฟีเจอร์เฉพาะเกม เช่น ลีดเดอร์บอร์ด รางวัลพิเศษ และการจัดการสถานะเกม
      • Auth Module จัดการการตรวจสอบสิทธิ์ผู้ใช้และ การดำเนินการให้สิทธิ์
    • SDK ของเกมและการตรวจสอบสิทธิ์ในแอปพลิเคชันเกมจะสื่อสารกับ โมดูลที่เกี่ยวข้องโดยใช้ อินเทอร์เฟซ AIDL ซึ่งบ่งบอกถึงการสื่อสารระหว่างกระบวนการ (IPC)

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

การเปรียบเทียบฟีเจอร์

ตารางนี้แสดงการเปรียบเทียบฟีเจอร์ระหว่าง SDK ของ Games v1 กับ Games v2


ฟีเจอร์

SDK v1 ของเกม

SDK v2 ของ Games

การตรวจสอบสิทธิ์

ต้องผสานรวมกับ play-services-auth

เรียบง่ายและมีประสิทธิภาพ ไม่ต้องใช้play-services-auth

การให้สิทธิ์

รหัสเพิ่มเติมสำหรับความสำเร็จ ความล้มเหลว และการลองใหม่

จัดการโดย SDK

โทเค็นเพื่อการเข้าถึงเซิร์ฟเวอร์

ขอ ขอบเขต OAuth 2.0 เพิ่มเติมได้ด้วย GoogleSigninClient

โค้ดเพิ่มเติมสำหรับการจัดการข้อผิดพลาดระหว่างการตรวจสอบสิทธิ์

ขอขอบเขตข้อมูลประจำตัว OAuth 2.0 พื้นฐาน 3 รายการได้ด้วย GamesSignInClient เมื่อ ขอสิทธิ์เข้าถึงฝั่งเซิร์ฟเวอร์ไปยัง Web API ของบริการเกมของ Play

ดูข้อมูลเพิ่มเติมได้ที่ การเข้าถึง Play Games Services ทางฝั่งเซิร์ฟเวอร์และ เรียกข้อมูลรหัสการตรวจสอบสิทธิ์ของเซิร์ฟเวอร์


ขั้นตอนการลงชื่อเข้าใช้

การใช้งาน GoogleSigninClient

โค้ดเพิ่มเติมสำหรับการจัดการโค้ดมาตรฐานสำหรับการตรวจสอบสิทธิ์อัตโนมัติ และการจัดการข้อผิดพลาด

การใช้งาน GamesSignInClient

SDK จัดการโค้ดมาตรฐาน การตรวจสอบสิทธิ์อัตโนมัติ และการจัดการข้อผิดพลาด

ป๊อปอัปต้อนรับ

ต้องใช้รหัสเพิ่มเติม
นักพัฒนาแอปสามารถควบคุมตำแหน่งและเวลาที่แสดงได้

ไม่ต้องใช้โค้ดเพิ่มเติม อินเทอร์เฟซผู้ใช้ที่สอดคล้องกันในเกมทั้งหมดที่กำหนดค่าด้วย SDK v2 ของ Games

การอ้างอิง

ต้องระบุ play-services-auth

โมดูลเกมจะจัดการการให้สิทธิ์และการตรวจสอบสิทธิ์ คุณไม่จำเป็นต้อง เพิ่มการอ้างอิงใดๆ
ออกจากระบบ

ใช้ GoogleSignInClient.signOut

ไม่รองรับ API การออกจากระบบ

บัญชีบริการเกมของ Play หลายบัญชีและการตั้งค่าต่อเกม

คุณจัดการบัญชีได้ภายในเกม

ผู้ใช้สามารถเปลี่ยนโปรไฟล์บริการ Play Games ได้ในการตั้งค่าอุปกรณ์เคลื่อนที่ ดูข้อมูลเพิ่มเติมได้ที่ วิธีเปลี่ยนโปรไฟล์ Play Games บนอุปกรณ์เคลื่อนที่