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

ขั้นตอนแรกในการผสานรวมเกมกับบริการเกมของ 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 ผ่าน PGS และคุณจะยังคงส่งข้อมูลที่เกี่ยวข้องกับความสำเร็จและฟีเจอร์อื่นๆ ของ PGS เทียบกับรหัสผู้เล่นแบบถาวร

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

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

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

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

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

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

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

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

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

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

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

ข้อความแจ้งการสร้างโปรไฟล์ที่ทริกเกอร์อัตโนมัติ

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

หยุดข้อความแจ้งการสร้างโปรไฟล์ที่ทริกเกอร์อัตโนมัติ

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

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

ลองทริกเกอร์พรอมต์โปรไฟล์ในช่วงเวลาที่แนะนำต่อไปนี้

• หลังจากดูบทแนะนำจนจบ
• ในระหว่างช่วงเวลาที่มีการให้รางวัล (เช่น ชนะการแข่งขัน เก็บไอเทมหายาก หรือทำตามเป้าหมาย)
• ในขณะที่เปิดเซสชันที่ 2

ดูข้อมูลเพิ่มเติมได้ที่ป้องกันการสร้างโปรไฟล์ที่ทริกเกอร์อัตโนมัติ (Java) และป้องกันการสร้างโปรไฟล์ที่ทริกเกอร์อัตโนมัติ (Unity)

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

เมื่อดำเนินการตรวจสอบสิทธิ์แพลตฟอร์มเรียบร้อยแล้ว นักพัฒนาแอปควรทำตามขั้นตอนต่อไปนี้เพื่อให้ผู้เล่นเข้าถึง 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 นี้เป็น IGA ที่เล่นล่าสุดสำหรับการกู้คืนที่ราบรื่น

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

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

1. เมื่อผู้เล่นเปิดแอป PGS จะตรวจสอบสิทธิ์โดยอัตโนมัติในเบื้องหลังเพื่อให้คุณมีรหัสผู้เล่นเพื่อติดตามความคืบหน้าเทียบกับความสำเร็จและฟีเจอร์อื่นๆ ของ Play Games
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 ที่เล่นล่าสุด เพื่อการกู้คืนที่ราบรื่น

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

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