การตรวจสอบสิทธิ์แพลตฟอร์ม

ขั้นตอนแรกในการผสานรวมเกมกับบริการเกมของ Google Play (PGS) คือการใช้การตรวจสอบสิทธิ์ของแพลตฟอร์ม คุณต้องทำเช่นนี้เพื่อเข้าถึง ฟีเจอร์อื่นๆ ทั้งหมด เช่น รางวัลพิเศษ ลีดเดอร์บอร์ด และกิจกรรม

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

แนวคิดการตรวจสอบสิทธิ์

ในบริการเกมของ Play v2 แนวคิดเรื่อง "การลงชื่อเข้าใช้" จะแยกออกเป็น 2 เลเยอร์ที่แตกต่างกัน ได้แก่ การตรวจสอบสิทธิ์ของแพลตฟอร์มและการตรวจสอบสิทธิ์ในเกม

การตรวจสอบสิทธิ์แพลตฟอร์ม

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

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

รหัสผู้เล่น

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

รหัสผู้เล่นจะตรงกันสำหรับผู้ใช้เมื่อเล่นเกมในอุปกรณ์หลายเครื่อง แต่อาจไม่ตรงกันในแต่ละเกมเสมอไป ดูข้อมูลเพิ่มเติมได้ที่รหัสผู้เล่นแบบใหม่

การตรวจสอบสิทธิ์ในเกม

คุณจัดการบัญชีในเกม (IGA) ซึ่งเป็นระบบข้อมูลประจำตัวที่เชื่อมโยงความคืบหน้าของผู้เล่น สินคงคลัง และสกุลเงินภายในเกม

• ข้อมูลประจำตัวหลัก: คุณสามารถใช้แบ็กเอนด์ของคุณเอง ลงชื่อเข้าใช้ด้วย Google (SiWG) หรือผู้ให้บริการรายอื่นๆ เป็นวิธีการลงชื่อเข้าใช้หลัก
• ความเป็นอิสระ: ผู้เล่นสามารถลงชื่อเข้าใช้บริการเกมของ Play (ข้อมูลประจำตัวของแพลตฟอร์ม) เพื่อรับความสำเร็จขณะลงชื่อเข้าใช้ IGA ใดก็ตาม (เช่น บัญชีผู้มาเยือนหรือบัญชี SiWG ที่เฉพาะเจาะจง)
• การจัดการ IGA หลายรายการ: บริการเกมของ Play จะจัดการเฉพาะ การตรวจสอบสิทธิ์แพลตฟอร์ม เกมของคุณจัดการการตรวจสอบสิทธิ์หลักของผู้เล่นใน IGA ซึ่งหมายความว่าจะไม่มีการเปลี่ยนแปลงโฟลว์ที่มีอยู่ของเกม เพื่อให้ผู้เล่นสลับไปมาระหว่าง IGA เมื่อผู้เล่นเปลี่ยนบัญชี ระบบจะยังคงตรวจสอบสิทธิ์ผู้เล่นในแพลตฟอร์ม Play Games ผ่าน PGS และคุณจะยังคงส่งข้อมูลที่เกี่ยวข้องกับความสำเร็จและฟีเจอร์อื่นๆ ของ PGS เทียบกับรหัสผู้เล่นแบบถาวรต่อไป

การทำงานต่อเนื่องแบบข้ามแพลตฟอร์มด้วย SiWG

หากต้องการช่วยให้ผู้เล่นนำความคืบหน้าไปใช้ใน Android, iOS และเว็บได้ ให้ใช้ลงชื่อเข้าใช้ด้วย Google เป็นวิธีการตรวจสอบสิทธิ์ในเกมหลัก ลองพิจารณาสิ่งต่อไปนี้

• ปุ่มลงชื่อเข้าใช้ด้วย Google: ใน PGS v1 ปุ่ม Google Play มักจะ จัดการทั้งการลงชื่อเข้าใช้แพลตฟอร์มและเกม ใน v2 กระบวนการเหล่านี้จะแยกกัน ใช้ปุ่มลงชื่อเข้าใช้ด้วย Google มาตรฐานเพื่อให้ผู้เล่น ตรวจสอบสิทธิ์และเข้าถึง IGA ของตนเอง
• SDK การลงชื่อเข้าใช้ด้วย Google:
  • สำหรับทั้ง Android และ iOS ให้ใช้ SDK การลงชื่อเข้าใช้ด้วยบัญชี Google มาตรฐานเพื่อ ตรวจสอบสิทธิ์ผู้เล่นใน IGA
  • ใช้ Google Open ID เป็นตัวระบุหลักสำหรับบัญชีในเกมของผู้เล่น
  • ใช้รหัสผู้เล่นของบริการเกมของ Play เพื่อรายงานความคืบหน้าของผู้เล่น ในฟีเจอร์ของ Play Games เช่น รางวัลพิเศษ

การผสานรวมที่แนะนำ

หากต้องการผสานรวมเกมกับบริการเกมของ Play ให้ทำตามขั้นตอนที่แนะนำต่อไปนี้

การเริ่มต้นและการตรวจสอบสิทธิ์

คุณต้องทำตามขั้นตอนนี้เพื่อเริ่มต้นและตรวจสอบสิทธิ์เกม

ใช้การตรวจสอบสิทธิ์ของแพลตฟอร์มโดยการเริ่มต้น SDK บริการเกมของ Play v2 เมื่อเริ่มต้น ดูข้อมูลเพิ่มเติมได้ที่การตรวจสอบสิทธิ์แพลตฟอร์มสำหรับเกม Android ขั้นตอนนี้จำเป็นต่อการเข้าถึงฟีเจอร์ของบริการ Play Games เช่น รางวัลพิเศษและลีดเดอร์บอร์ด

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

การสร้างโปรไฟล์

ผู้เล่นต้องมีโปรไฟล์บริการเกมของ Play เพื่อมีส่วนร่วมกับแพลตฟอร์ม ผู้เล่นบางรายอาจไม่มีโปรไฟล์บริการเกมของ Play เมื่อเริ่มเล่นเกมของคุณ ระบบจะขอให้ผู้เล่นเหล่านี้สร้างโปรไฟล์

ข้อความแจ้งการสร้างโปรไฟล์จะปรากฏขึ้นโดยอัตโนมัติตามค่าเริ่มต้นเมื่อคุณเปิดเกมโดยไม่มีโปรไฟล์บริการเกมของ Play

การตรวจสอบสิทธิ์ในเกม

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

1. หากมีเซสชันเกมที่ใช้งานอยู่บนอุปกรณ์ ให้อนุญาตให้ผู้เล่นกลับมาใช้เซสชันปัจจุบันต่อได้
2. หากไม่มีเซสชันการแข่งขันที่ใช้งานอยู่ ให้ทำดังนี้
   1. ในกรณีของการกู้คืนที่ราบรื่น ซึ่ง IGA ที่เล่นล่าสุดเชื่อมโยงกับรหัสผู้เล่น PGS ให้ดำเนินการกู้คืน IGA ที่เชื่อมโยงโดยอัตโนมัติ
   2. หรือแสดงหน้าจอเข้าสู่ระบบหรือสร้างบัญชีที่กำหนดของแอปพลิเคชันให้ผู้เล่น จากนั้นผู้เล่นจะเลือกวิธีการตรวจสอบสิทธิ์ที่ต้องการเพื่อสร้างหรือเข้าสู่ระบบ IGA ที่มีอยู่ได้

ขอบเขต OAuth

บริการเกมของ Play ใช้ระบบ OAuth เพื่ออนุญาตให้ผู้เล่นให้สิทธิ์เกมของคุณเข้าถึงบัญชีของตน บริการเกมของ Play มีขอบเขตที่ไม่ซ้ำกันสำหรับเกม (games-lite) และต้องอาศัยขอบเขตอื่น (drive.appdata) หากเกมของคุณใช้ฟีเจอร์เกมที่บันทึกไว้ ฟีเจอร์เกมที่บันทึกไว้จะให้สิทธิ์เข้าถึงบัญชี Google ไดรฟ์ของผู้ใช้ ซึ่งเป็นที่เก็บข้อมูลเกม

เมื่อใช้ SDK บริการเกมของ Play เวอร์ชัน 2 คุณจะขอขอบเขต OAuth เพิ่มเติมได้ หากต้องการขอบเขต OAuth เพิ่มเติม เราขอแนะนำให้ติดต่อ requestServerSideAccess ดูข้อมูลเพิ่มเติมได้ที่รับรหัสการให้สิทธิ์เซิร์ฟเวอร์หรือดึงรหัสการตรวจสอบสิทธิ์ของเซิร์ฟเวอร์

หลักเกณฑ์ด้านประสบการณ์ของผู้ใช้สำหรับโฟลว์การตรวจสอบสิทธิ์ที่เหมาะสม

หลักเกณฑ์ต่อไปนี้อธิบายขั้นตอนการตรวจสอบสิทธิ์ที่แนะนำด้วยการผสานรวม PGS v2 โดยครอบคลุมสถานการณ์สําหรับผู้ใช้ใหม่ ผู้ใช้ปัจจุบัน ผู้ใช้ที่กลับมา และ โหมดผู้มาเยือน

ผู้เล่นใหม่

ขั้นตอนการทำงานนี้ใช้กับผู้ใช้ที่เปิดเกมเป็นครั้งแรกในอุปกรณ์ที่ไม่มีประวัติการเล่นเกมมาก่อน

1. เมื่อเปิดตัว PGS SDK จะเริ่มต้นเพื่อตรวจสอบสิทธิ์ข้อมูลประจำตัวแพลตฟอร์มของผู้ใช้ (รหัสผู้เล่น PGS)
2. หลังจากแฮนด์เชคเบื้องหลังนี้ เกมจะแสดงตัวเลือกการสร้าง IGA แก่ผู้เล่น เช่น สร้างบัญชีใหม่ ลงชื่อเข้าใช้ด้วย Google หรือ วิธีการเข้าสู่ระบบโซเชียลอื่นๆ
3. เมื่อผู้เล่นสร้างหรือเลือก IGA แล้ว เกมจะเชื่อมโยงบัญชีนี้กับ ตัวระบุหลักที่เลือกไว้ในแบ็กเอนด์
4. เกมจะเชื่อมโยง IGA ที่เลือกนี้กับรหัสผู้เล่น PGS ด้วย ซึ่งจะทำเครื่องหมายเป็น IGA ที่เล่นล่าสุดสำหรับการกู้คืนที่ราบรื่น

ผู้เล่นที่มีเซสชันที่ใช้งานอยู่

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

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

ผู้เล่นที่เปลี่ยนบัญชี

โฟลว์นี้จะเกิดขึ้นเมื่อผู้เล่นที่มีเซสชันที่ใช้งานอยู่ไปที่การตั้งค่าเกมเพื่อเปลี่ยนบัญชี เช่น การออกจากระบบบัญชีหลักเพื่อใช้บัญชีอื่น

1. ผู้เล่นออกจาก IGA ปัจจุบัน แต่การเชื่อมต่อแพลตฟอร์ม PGS ยังคงใช้งานได้
2. เมื่อผู้เล่นเข้าสู่ระบบด้วย IGA อื่น เกมจะเชื่อมโยงบัญชีใหม่นี้กับรหัสผู้เล่น PGS ปัจจุบันเป็น IGA ที่เล่นล่าสุดเพื่อการกู้คืนที่ราบรื่นเท่านั้น

การคืนค่าที่ราบรื่นสำหรับผู้เล่นที่กลับมา

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

1. เมื่อเปิดตัว PGS จะตรวจสอบสิทธิ์ผู้ใช้และระบุรหัสผู้เล่น PGS ให้กับเกม
2. เกมจะตรวจสอบแบ็กเอนด์ของเกม (หรือโทเค็นเรียกคืนข้อมูลที่ดึงมาหากใช้ Recall API) เพื่อดูว่า IGA ที่เล่นล่าสุดลิงก์กับรหัส PGS นี้อยู่แล้วหรือไม่
3. หากพบลิงก์ เกมจะกู้คืนความคืบหน้าของผู้เล่นและเข้าสู่ระบบโดยอัตโนมัติ ซึ่งจะข้ามหน้าจอเข้าสู่ระบบด้วยตนเองไปเลย
4. มิฉะนั้น เกมจะแสดงหน้าจอเข้าสู่ระบบแก่ผู้เล่น
   1. จากนั้นผู้เล่นจะเลือกวิธีการเข้าสู่ระบบและลงชื่อเข้าใช้ IGA
   2. จากนั้นเกมจะเชื่อมโยง IGA นี้กับรหัสผู้เล่น PGS เป็น IGA ที่เล่นล่าสุด เพื่อการกู้คืนที่ราบรื่น

โหมดผู้มาเยือน

ผู้เล่นสามารถเปิดเกมและเล่นโดยใช้บัญชีผู้มาเยือนในเครื่องได้ PGS ยังคงตรวจสอบสิทธิ์ในเบื้องหลัง หากผู้เล่นเลือกบันทึก ความคืบหน้า เกมจะแปลงเซสชันผู้ใช้ชั่วคราวเป็น IGA ถาวรและเชื่อมโยง กับรหัสผู้เล่น PGS