กำหนดการเลิกใช้งาน

เอกสารนี้แสดงรายการกำหนดการเลิกใช้งาน SDK บริการเกมของ Play v1

หลังจากเลิกใช้งาน Google Sign-in (GSI) API และ วางแผนที่จะปิดตัวลง เราจะเลิกใช้งาน SDK และ API บริการเกมของ Play v1 คุณต้องย้ายข้อมูลเกมไปยัง SDK บริการเกมของ Play v2 เพื่อรับฟีเจอร์ล่าสุด

ไทม์ไลน์การเลิกใช้งานมีดังนี้

วันที่ เหตุการณ์สำคัญในการเลิกใช้งาน
ผลกระทบ การดำเนินการของนักพัฒนาแอป
พฤษภาคม 2026 การนำ GSI API ออก หากเกมเพิ่มฟีเจอร์ใหม่ๆ เช่น LiveOps, ภารกิจ หรือแผนที่ ซึ่งไม่ได้ใช้การตรวจสอบสิทธิ์ของ Google ยกเว้นบริการเกมของ Play v1 API ฟีเจอร์เหล่านี้จะยังคงทำงานได้

หากเกมใช้ SDK ของบุคคลที่สามหรือ SDK ของ Google อื่นที่ไม่ใช่บริการเกมของ Play v1 ซึ่งต้องมีการอัปเกรดการตรวจสอบสิทธิ์ การอัปเกรดเป็น SDK เวอร์ชันล่าสุดอาจทำให้เกิดข้อผิดพลาดในการคอมไพล์
  1. ทำตามเส้นทางการแก้ปัญหาที่ระบุไว้ที่นี่เมื่อพบข้อผิดพลาดในการคอมไพล์
  2. ตรวจสอบว่าคุณได้ย้ายข้อมูลไปยังบริการเกมของ Play v2 ตามเส้นทางการแก้ปัญหาที่ระบุไว้ที่นี่ทันทีหลังจากที่เผยแพร่โซลูชันในช่วงปลายไตรมาสที่ 2 ของปี 2026
15 มิถุนายน 2026 การนำบริการเกมของ Play v1 API ออก เราจะเผยแพร่ SDK บริการเกมของ Play v1 เวอร์ชันใหม่ที่นำ GSI API ออกแล้ว โดยจะไม่มีการแก้ไขข้อบกพร่องหรืออัปเดตฟีเจอร์ที่มีอยู่ของ Play Games Services v1 อีกต่อไป
หากเกม v1 ที่มีอยู่ได้รับการอัปเกรดเป็น Play Games Services v1 เวอร์ชันล่าสุด ฟังก์ชันการทำงานของบริการเกมของ Play ในเวอร์ชันใหม่นี้จะหยุดทำงาน
  1. เกมในบริการเกมของ Play v1 ต้องไม่อัปเกรด SDK v1 เป็น com.google.android.gms:play-services-games:25.0.0 ซึ่งจะนำ v1 API ออก
  2. เกมที่ยังไม่ได้ย้ายข้อมูลไปยังบริการเกมของ Play v2 อาจพบข้อผิดพลาดในการคอมไพล์เนื่องจาก play-services-auth ไม่ได้ให้บริการ GSI อีกต่อไปตั้งแต่เดือนพฤษภาคม 2026
  3. เกมสามารถเฝ้าระวังการอัปเกรด SDK อื่นๆ และตรวจสอบว่า SDK อื่นๆ ไม่ได้ใช้ Credential Manager SDK ใหม่จนกว่าจะย้ายข้อมูลไปยังบริการเกมของ Play v2 ตามไทม์ไลน์ที่ระบุไว้ในส่วนก่อนหน้า
พฤษภาคม 2027 การปิดตัวลงของบริการเกมของ Play v1 ระบบจะบล็อกการรับส่งข้อมูลทั้งหมดจากบริการเกมของ Play v1 โดยจะไม่มีการคอมไพล์เกม

Play Games Services v1 API ที่มีอยู่จะหยุดทำงานในสภาพแวดล้อมที่ใช้งานจริง
ตัวเลือกเดียวคือการย้ายข้อมูลไปยังบริการเกมของ Play v2 ก่อนถึงกำหนดเวลาดังกล่าวเพื่อหลีกเลี่ยงการหยุดชะงักในการเริ่มต้นใช้งานและการเข้าสู่ระบบของผู้เล่น
  • หลังจากเดือนกันยายน 2025 ระบบจะเลิกใช้งาน SDK และ API v1 ของเกม เกมที่มีอยู่ซึ่งผสานรวมกับ v1 ก่อนหน้านี้จะยังทำงานได้ต่อไป Google Play จะไม่อนุญาตให้เผยแพร่เกมใหม่ที่ใช้ SDK และ API v1

  • ตั้งแต่วันที่ 15 มิถุนายน 2026 เป็นต้นไป ระบบจะนำ API ที่เลิกใช้งานแล้วออกจาก SDK

  • ตั้งแต่วันที่ 15 มิถุนายน 2027 เป็นต้นไป ระบบจะนำ SDK v1 ของเกมออก การเรียก API เหล่านี้จะล้มเหลว แม้ว่าคุณจะใช้ SDK เวอร์ชันก่อนหน้าก็ตาม

ตารางต่อไปนี้แสดงรายการเวอร์ชันของเกม v1 (SDK), วันที่เลิกใช้งาน และคำแนะนำในการย้ายข้อมูล

เวอร์ชัน SDK วันที่เผยแพร่ คำแนะนำในการย้ายข้อมูล
play-services-games:v24.0.0 12 กันยายน 2025
เลิกใช้งานแล้ว
ย้ายข้อมูลไปยัง v2(Java หรือ Kotlin)
v0.10.15 Unity 17 กันยายน 2025
เลิกใช้งานแล้ว
ย้ายข้อมูลไปยัง v2(Unity)
play-services-games:v25.0.0 15 มิถุนายน 2026
นำ Play Games Services v1 API ออกจาก SDK แล้ว
ย้ายข้อมูลไปยัง v2(Java หรือ Kotlin)

ตัวอย่างผลกระทบของการนำ GSI API ออก

พิจารณาสถานการณ์ที่ SDK, SDK1 ดึงข้อมูลรายชื่อเพื่อนจากบัญชี Google ของผู้เล่น หากต้องการใช้ฟีเจอร์นี้ ผู้เล่นต้องตรวจสอบสิทธิ์บัญชี Google โดยใช้ Google Authentication SDK

คุณอาจต้องอัปเดต Google Authentication SDK ในกรณีต่อไปนี้

  • แก้ไขข้อบกพร่องที่สำคัญในโฟลว์การตรวจสอบสิทธิ์
  • ใช้ประสบการณ์การใช้งานพาสคีย์ใหม่ที่ Credential Manager SDK มีให้

ตารางต่อไปนี้อธิบายสถานการณ์ 3 แบบสำหรับการอัปเดตการผสานรวมการตรวจสอบสิทธิ์ของเกม

  • สถานการณ์ที่ 1: SDK1 อัปเกรดเป็น Google Authentication SDK เวอร์ชันล่าสุด
  • สถานการณ์ที่ 2: SDK1 ผสานรวมกับ Credential Manager โดยไม่เปลี่ยนแปลง Google Authentication SDK
  • สถานการณ์ที่ 3: SDK1 ผสานรวมกับ Credential Manager และนำ Google Authentication SDK ออก
ฟีเจอร์ สถานการณ์ที่ 1 สถานการณ์ที่ 2 สถานการณ์ที่ 3
สถานการณ์การอัปเกรดการตรวจสอบสิทธิ์
  1. ไม่ทราบว่ามีการนำ GSI API ออก เกมจึงอัปเกรดเป็น SDK การตรวจสอบสิทธิ์เวอร์ชันล่าสุด
  2. ฟังก์ชันการตรวจสอบสิทธิ์ที่มีอยู่หยุดทำงานและ SDK1 ถูกบังคับให้ผสานรวม Credential Manager SDK
  3. เกมเผยแพร่เวอร์ชันล่าสุดด้วย SDK การตรวจสอบสิทธิ์และ Credential Manager SDK เวอร์ชันล่าสุด
ทราบว่ามีการนำ GSI API ออก SDK1 จึงไม่อัปเกรด SDK การตรวจสอบสิทธิ์ แต่ใช้ฟังก์ชันการตรวจสอบสิทธิ์ของ Google โดยใช้ Credential Manager SDK ในเวอร์ชันล่าสุด ในเวอร์ชันล่าสุด SDK1 ใช้ฟังก์ชันการตรวจสอบสิทธิ์ของ Google โดยใช้ Credential Manager SDK และนำ SDK การตรวจสอบสิทธิ์ออกอย่างสมบูรณ์
SDK บริการเกมของ Play v1 ไม่เปลี่ยนแปลง ไม่เปลี่ยนแปลง ไม่เปลี่ยนแปลง
สิ่งที่จะเกิดขึ้นเมื่อคอมไพล์เกม
  1. บริการเกมของ Play v1 ต้องมีการผสานรวม SDK การตรวจสอบสิทธิ์แยกต่างหาก -> เนื่องจาก SDK การตรวจสอบสิทธิ์ได้รับการอัปเกรดโดยไม่มี GSI API บริการเกมของ Play v1 จึงจะหยุดทำงาน
  2. เกมจะได้รับข้อผิดพลาดในเวลาคอมไพล์
  3. จากนั้นเกมจะพยายามทำตามเส้นทางการแก้ปัญหา
เกมจะได้รับข้อผิดพลาดในเวลาคอมไพล์ จากนั้นเกมจะพยายามทำตามเส้นทางการแก้ปัญหา
ประสบการณ์การใช้งานของผู้เล่นที่เป็นไปได้ ไม่มี เนื่องจากเกมคอมไพล์ไม่ได้จึงไม่สามารถเผยแพร่ได้
  1. ผู้เล่นจะเห็นตัวเลือกบัญชีบริการเกมของ Play เมื่อตรวจสอบสิทธิ์โดยใช้บริการเกมของ Play v1
  2. ผู้เล่นจะเห็น Bottom Sheet ของ Credential Manager เมื่อตรวจสอบสิทธิ์เพื่อใช้ฟีเจอร์ SDK1
  1. ผู้เล่นจะเห็นตัวเลือกบัญชีบริการเกมของ Play เมื่อตรวจสอบสิทธิ์โดยใช้บริการเกมของ Play v1
  2. ผู้เล่นจะเห็น Bottom Sheet ของ Credential Manager เมื่อตรวจสอบสิทธิ์เพื่อใช้ฟีเจอร์ SDK1
เส้นทางการแก้ปัญหาสำหรับนักพัฒนาแอปเกม
  1. ค้นหาว่า SDK ใดทำให้เกิดการอัปเกรด SDK การตรวจสอบสิทธิ์
  2. เปลี่ยน SDK1 กลับไปใช้ SDK เวอร์ชันก่อนหน้า
  3. คอมไพล์เกมอีกครั้งด้วยฟีเจอร์ของเกม
  4. หากฟีเจอร์ใหม่ของเกมต้องมีการอัปเกรดเป็น SDK1 ให้พูดคุยกับ SDK1 เพื่อใช้สถานการณ์ที่ 2 หรือ 3 สำหรับเวอร์ชันของ SDK
  1. ไม่มี
  2. อย่างไรก็ตาม หากคุณใช้ปุ่มลงชื่อเข้าใช้ด้วย Google ด้วย คุณอาจต้องใช้โฟลว์ลงชื่อเข้าใช้ด้วย Google 2 ประเภทสำหรับผู้เล่น
  1. ไม่มี
  2. อย่างไรก็ตาม หากคุณใช้ปุ่มลงชื่อเข้าใช้ด้วย Google ด้วย คุณอาจต้องใช้โฟลว์ลงชื่อเข้าใช้ด้วย Google 2 ประเภทสำหรับผู้เล่น
ผลลัพธ์สุดท้ายสำหรับบริการเกมของ Play v1 เกมไม่จำเป็นต้องอัปเกรดเป็นบริการเกมของ Play v2 แต่ SDK1 จะล้าสมัย เกมไม่จำเป็นต้องอัปเกรดจากบริการเกมของ Play v1 เป็น v2 เกมไม่จำเป็นต้องอัปเกรดจากบริการเกมของ Play v1 เป็น v2