ขั้นตอนแรกในการผสานรวมเกมกับบริการเกมของ 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 เวอร์ชัน 1 ปุ่ม Google Play มักจะจัดการทั้งการลงชื่อเข้าใช้แพลตฟอร์มและเกม ใน v2 การดำเนินการเหล่านี้เป็นกระบวนการแยกกัน ใช้ปุ่มลงชื่อเข้าใช้ด้วย Google มาตรฐานเพื่อให้ผู้เล่นตรวจสอบสิทธิ์และเข้าถึง IGA ของตน
- SDK ของ Google Sign-In
- สำหรับทั้ง Android และ iOS ให้ใช้ SDK มาตรฐานของ Google Sign-In เพื่อตรวจสอบสิทธิ์ผู้เล่นใน IGA
- ใช้ Google OpenID เป็นตัวระบุหลักสำหรับบัญชีในเกมของผู้เล่น
- ใช้รหัสผู้เล่นของบริการเกมของ Play เพื่อรายงานความคืบหน้าของผู้เล่นในฟีเจอร์ของ Play Games เช่น รางวัลพิเศษ
การผสานรวมที่แนะนำ
หากต้องการผสานรวมเกมกับบริการเกมของ Play ให้ทำตามขั้นตอนที่แนะนำต่อไปนี้
การเริ่มต้นและการตรวจสอบสิทธิ์
ขั้นตอนนี้จำเป็นสำหรับการเริ่มต้นและตรวจสอบสิทธิ์เกมของคุณ
ใช้การตรวจสอบสิทธิ์ของแพลตฟอร์มโดยการเริ่มต้น SDK บริการเกมของ Play v2 เมื่อเริ่มต้นระบบ ดูข้อมูลเพิ่มเติมได้ที่การตรวจสอบสิทธิ์แพลตฟอร์มสำหรับเกม Android คุณต้องทำขั้นตอนนี้เพื่อเข้าถึงฟีเจอร์ของบริการเกมของ Play เช่น รางวัลพิเศษและลีดเดอร์บอร์ด
การตรวจสอบสิทธิ์จะทำงานเป็นกระบวนการเบื้องหลังแบบเงียบๆ ระหว่างการเปิดเกม ผู้ใช้บริการเกมของ Play ในปัจจุบันจะเห็นข้อความต้อนรับหลังจากการตรวจสอบสิทธิ์สำเร็จ ผู้ใช้ที่ไม่มีโปรไฟล์บริการเกมของ Play จะได้รับข้อความแจ้งให้สร้างโปรไฟล์ในระหว่างการเริ่มต้น SDK

การสร้างโปรไฟล์
ผู้เล่นต้องมีโปรไฟล์บริการเกมของ Play เพื่อมีส่วนร่วมกับแพลตฟอร์ม ผู้เล่นบางรายอาจไม่มีโปรไฟล์บริการเกมของ Play เมื่อเริ่มเล่นเกมของคุณ ระบบจะขอให้ผู้เล่นเหล่านี้สร้างโปรไฟล์ คุณเลือกประสบการณ์การใช้งานที่เหมาะสมสำหรับผู้ใช้ได้โดยเลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
ข้อความแจ้งการสร้างโปรไฟล์ที่เรียกให้แสดงโดยอัตโนมัติ
ข้อความแจ้งการสร้างโปรไฟล์จะปรากฏขึ้นโดยอัตโนมัติตามค่าเริ่มต้นเมื่อคุณเปิดเกมโดยไม่มีโปรไฟล์บริการเกมของ Play
หยุดข้อความแจ้งให้สร้างโปรไฟล์ที่เรียกให้แสดงโดยอัตโนมัติ
ปิดใช้ข้อความแจ้งโปรไฟล์เมื่อเปิดแอปโดยกำหนดค่าไฟล์ Manifest เพื่อป้องกันไม่ให้ข้อความแจ้งทำงานโดยอัตโนมัติ ซึ่งจะช่วยให้ผู้ใช้ที่ไม่มีโปรไฟล์บริการเกมของ Play โหลดเกมต่อไปได้โดยไม่ต้องได้รับข้อความแจ้งให้สร้างโปรไฟล์บริการเกมของ Play
แม้ว่าผู้ใช้จะลงชื่อเข้าใช้ด้วยผู้ให้บริการข้อมูลประจำตัวรายใดก็ได้ แต่คุณควรแสดงข้อความแจ้งให้สร้างโปรไฟล์เพื่อกระตุ้นให้ผู้ใช้ตรวจสอบสิทธิ์ด้วยการตรวจสอบสิทธิ์ของแพลตฟอร์ม Play Games แสดงข้อความแจ้งนี้ตามความจำเป็น แต่ต้องแสดงก่อนที่ผู้ใช้จะมีความคืบหน้าอย่างมากในฟีเจอร์ต่างๆ เช่น รางวัลพิเศษและลีดเดอร์บอร์ด
ลองเรียกใช้ข้อความแจ้งให้สร้างโปรไฟล์ในช่วงเวลาที่แนะนำต่อไปนี้
- หลังจากดูบทแนะนำจนจบ
- ระหว่างช่วงเวลาที่ได้รับรางวัล (เช่น ชนะการแข่งขัน เก็บไอเทมหายาก หรือบรรลุเป้าหมาย)
- เมื่อเปิดเซสชันที่ 2
ดูข้อมูลเพิ่มเติมได้ที่ป้องกันการสร้างโปรไฟล์ที่เรียกให้แสดงโดยอัตโนมัติ (Java) และป้องกันการสร้างโปรไฟล์ที่เรียกให้แสดงโดยอัตโนมัติ (Unity)
การตรวจสอบสิทธิ์ในเกม
เมื่อดำเนินการตรวจสอบสิทธิ์ของแพลตฟอร์มเรียบร้อยแล้ว นักพัฒนาแอปควรทำตามขั้นตอนต่อไปนี้เพื่อให้ผู้เล่นเข้าถึง IGA ของตนได้ ทั้งนี้ขึ้นอยู่กับสถานะปัจจุบันของเกม
- หากมีเซสชันเกมที่ใช้งานอยู่ในอุปกรณ์ ให้อนุญาตให้ผู้เล่นกลับมาเล่นเซสชันปัจจุบันต่อได้
- หากไม่มีเซสชันเกมที่ใช้งานอยู่ ให้ทำดังนี้
- ในกรณีที่เกิดสถานการณ์การกู้คืนที่ราบรื่นซึ่ง IGA ที่เล่นล่าสุดเชื่อมโยงกับรหัสผู้เล่น PGS ให้ดำเนินการกู้คืน IGA ที่เชื่อมโยงโดยอัตโนมัติ
- หรือแสดงหน้าจอการเข้าสู่ระบบหรือการสร้างบัญชีที่กำหนดของแอปพลิเคชันให้ผู้เล่นเห็น จากนั้นผู้เล่นจะเลือกวิธีการตรวจสอบสิทธิ์ที่ต้องการเพื่อสร้างหรือเข้าสู่ระบบ IGA ที่มีอยู่ได้
ขอบเขต OAuth
บริการเกมของ Play ใช้ระบบ OAuth
เพื่ออนุญาตให้ผู้เล่นให้สิทธิ์เกมของคุณเข้าถึงบัญชีของตน บริการเกมของ Play
มีขอบเขตที่ไม่ซ้ำกันสำหรับเกม (games-lite) และต้องอาศัยขอบเขตอื่น
(drive.appdata) หากเกมของคุณใช้ฟีเจอร์เกมที่บันทึกไว้ ฟีเจอร์เกมที่บันทึกไว้จะให้สิทธิ์เข้าถึงบัญชี Google ไดรฟ์ของผู้ใช้ ซึ่งเป็นที่เก็บข้อมูลเกม
เมื่อใช้ SDK บริการเกมของ Play เวอร์ชัน 2 คุณจะขอขอบเขต OAuth เพิ่มเติมได้
หากต้องการขอบเขต OAuth เพิ่มเติม เราขอแนะนำให้ติดต่อ requestServerSideAccess
ดูข้อมูลเพิ่มเติมได้ที่รับรหัสการให้สิทธิ์เซิร์ฟเวอร์หรือดึงรหัสการตรวจสอบสิทธิ์ของเซิร์ฟเวอร์
หลักเกณฑ์ด้านประสบการณ์ของผู้ใช้สำหรับขั้นตอนการตรวจสอบสิทธิ์ที่เหมาะสมที่สุด
หลักเกณฑ์ต่อไปนี้อธิบายขั้นตอนการตรวจสอบสิทธิ์ที่แนะนำเมื่อผสานรวม PGS v2 โดยครอบคลุมสถานการณ์สำหรับผู้ใช้ใหม่ ผู้ใช้ปัจจุบัน ผู้ใช้ที่กลับมา และโหมดผู้มาเยือน
ผู้เล่นใหม่
ขั้นตอนการทำงานนี้ใช้กับผู้ใช้ที่เปิดเกมเป็นครั้งแรกในอุปกรณ์ที่ไม่มีประวัติการเล่นเกมมาก่อน
- เมื่อเปิดตัว PGS SDK จะเริ่มต้นเพื่อตรวจสอบสิทธิ์ข้อมูลประจำตัวแพลตฟอร์มของผู้ใช้ (รหัสผู้เล่น PGS)
- หลังจากแฮนด์เชคในเบื้องหลังนี้แล้ว เกมจะแสดงตัวเลือกการสร้าง IGA แก่ผู้เล่น เช่น สร้างบัญชีใหม่ ลงชื่อเข้าใช้ด้วย Google หรือวิธีการเข้าสู่ระบบผ่านโซเชียลอื่นๆ
- เมื่อผู้เล่นสร้างหรือเลือก IGA แล้ว เกมจะเชื่อมโยงบัญชีนี้กับตัวระบุหลักที่เลือกไว้ในแบ็กเอนด์
- นอกจากนี้ เกมยังผูก IGA ที่เลือกนี้กับรหัสผู้เล่น PGS โดยทำเครื่องหมายเป็น IGA ที่เล่นล่าสุดเพื่อการกู้คืนที่ราบรื่น
ผู้เล่นที่มีเซสชันที่ใช้งานอยู่
สถานการณ์นี้อธิบายถึงผู้เล่นที่เปิดเกมในอุปกรณ์ที่มีเซสชันที่ใช้งานอยู่แล้ว เป้าหมายคือการมอบประสบการณ์การเข้าใช้งานที่ราบรื่น
- เมื่อผู้เล่นเปิดแอป PGS จะตรวจสอบสิทธิ์ในเบื้องหลังโดยไม่แจ้งให้ทราบ เพื่อให้รหัสผู้เล่นแก่คุณเพื่อติดตามความคืบหน้าเทียบกับรางวัลพิเศษและฟีเจอร์อื่นๆ ของ Play Games
- ในขณะเดียวกัน หากเป็นไปได้ เกมจะข้ามหน้าจอเข้าสู่ระบบและลงชื่อเข้าใช้เซสชัน IGA ที่ใช้งานอยู่ของผู้เล่นหรือ IGA ที่เล่นล่าสุดซึ่งเชื่อมโยงกับรหัสผู้เล่นทันที เพื่อให้ผู้เล่นกลับมาเล่นเกมต่อได้ทันที
ผู้เล่นเปลี่ยนบัญชี
ขั้นตอนนี้จะเกิดขึ้นเมื่อผู้เล่นที่มีเซสชันที่ใช้งานอยู่ไปยังการตั้งค่าเกมเพื่อเปลี่ยนบัญชี เช่น การออกจากระบบบัญชีหลักเพื่อใช้บัญชีอื่น
- ผู้เล่นออกจากระบบ IGA ปัจจุบัน แต่การเชื่อมต่อแพลตฟอร์ม PGS ยังคงทำงานอยู่
- เมื่อผู้เล่นเข้าสู่ระบบด้วย IGA อื่น เกมจะเชื่อมโยงบัญชีใหม่นี้กับรหัสผู้เล่น PGS ปัจจุบันเป็น IGA ที่เล่นล่าสุดเพื่อการกู้คืนที่ราบรื่นเท่านั้น
การกู้คืนที่ราบรื่นสำหรับผู้เล่นที่กลับมา
สถานการณ์นี้จะเกิดขึ้นเมื่อผู้เล่นเปิดเกมหลังจากที่ไม่ได้ใช้งานเป็นระยะเวลาหนึ่ง ติดตั้งใหม่ หรือเปิดในอุปกรณ์ใหม่ทั้งหมด ขอแนะนำให้เกมใช้การกู้คืนที่ราบรื่น
- เมื่อเปิดตัว PGS จะตรวจสอบสิทธิ์ผู้ใช้และให้รหัสผู้เล่น PGS แก่เกม
- เกมจะตรวจสอบแบ็กเอนด์ (หรือโทเค็นเรียกคืนข้อมูลที่ดึงมาหากใช้ Recall API) เพื่อดูว่า IGA ที่เล่นล่าสุดลิงก์กับรหัส PGS นี้แล้วหรือยัง
- หากพบลิงก์ เกมจะกู้คืนความคืบหน้าของผู้เล่นและเข้าสู่ระบบให้โดยอัตโนมัติ โดยข้ามหน้าจอการเข้าสู่ระบบด้วยตนเองไปเลย
- ไม่เช่นนั้น เกมจะแสดงหน้าจอเข้าสู่ระบบให้ผู้เล่นเห็น
- จากนั้นผู้เล่นจะเลือกวิธีการเข้าสู่ระบบและลงชื่อเข้าใช้ IGA
- จากนั้นเกมจะเชื่อมโยง IGA นี้กับรหัสผู้เล่น PGS เป็น IGA ที่เล่นล่าสุดเพื่อการกู้คืนที่ราบรื่น
โหมดผู้มาเยือน
ผู้เล่นสามารถเปิดเกมและเล่นโดยใช้บัญชีผู้ใช้ชั่วคราวในเครื่องได้ บริการเกมของ Play จะยังคงตรวจสอบสิทธิ์ผู้เล่นในเบื้องหลัง หากผู้เล่นเลือกบันทึกความคืบหน้า เกมจะแปลงเซสชันผู้มาเยือนเป็น IGA ถาวรและเชื่อมโยงกับรหัสผู้เล่น ดูข้อมูลเพิ่มเติมเกี่ยวกับการแก้ปัญหาความขัดแย้งได้ที่บัญชีผู้ใช้ชั่วคราว
ทดสอบเกม
ตรวจสอบว่าเกมทำงานได้ตามที่ออกแบบไว้โดยการทดสอบ การทดสอบที่คุณทำจะขึ้นอยู่กับฟีเจอร์ของเกม
ต่อไปนี้คือรายการการทดสอบทั่วไปที่ควรทำ
ลงชื่อเข้าใช้สำเร็จ
การลงชื่อเข้าใช้โดยอัตโนมัติทำงานได้ ผู้ใช้ควรลงชื่อเข้าใช้บริการเกมของ Play เมื่อเปิดเกม
ป๊อปอัปต้อนรับจะปรากฏขึ้น
ตัวอย่างป๊อปอัปต้อนรับ (คลิกเพื่อขยาย) ข้อความในบันทึกที่สำเร็จจะปรากฏขึ้น เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล
adb logcat | grep com.google.android.
ข้อความในบันทึกที่สำเร็จจะแสดงในตัวอย่างต่อไปนี้
[
$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup. [CONTEXT service_id=1 ]
ตรวจสอบความสอดคล้องกันของคอมโพเนนต์ UI
ป๊อปอัป ลีดเดอร์บอร์ด และรางวัลพิเศษจะแสดงอย่างถูกต้องและสอดคล้องกันในขนาดและการวางแนวหน้าจอต่างๆ ในอินเทอร์เฟซผู้ใช้ (UI) ของบริการเกมของ Play
ตัวเลือกการออกจากระบบจะไม่แสดงใน UI ของบริการเกมของ Play
ตรวจสอบว่าคุณสามารถดึงข้อมูลรหัสผู้เล่นได้สำเร็จ และความสามารถฝั่งเซิร์ฟเวอร์ทำงานตามที่คาดไว้ (หากมี)
หากเกมใช้การตรวจสอบสิทธิ์ฝั่งเซิร์ฟเวอร์ ให้ทดสอบขั้นตอน
requestServerSideAccessอย่างละเอียด ตรวจสอบว่าเซิร์ฟเวอร์ได้รับรหัสการให้สิทธิ์และสามารถแลกเปลี่ยนเป็นโทเค็นเพื่อการเข้าถึงได้ ทดสอบทั้งสถานการณ์ที่สำเร็จและไม่สำเร็จสำหรับข้อผิดพลาดเกี่ยวกับเครือข่าย สถานการณ์ที่ไม่ถูกต้องclient ID
หากเกมของคุณใช้ฟีเจอร์ต่อไปนี้ ให้ทดสอบฟีเจอร์เหล่านั้นเพื่อให้แน่ใจว่าทำงานเหมือนเดิมก่อนการย้ายข้อมูล
- ลีดเดอร์บอร์ด: ส่งคะแนนและดูลีดเดอร์บอร์ด ตรวจสอบการจัดอันดับและการแสดงชื่อและคะแนนของผู้เล่นที่ถูกต้อง
- รางวัลพิเศษ: ปลดล็อกรางวัลพิเศษและยืนยันว่าระบบบันทึกและแสดงรางวัลพิเศษอย่างถูกต้องใน UI ของ Play Games
- เกมที่บันทึกไว้: หากเกมใช้เกมที่บันทึกไว้ ให้ตรวจสอบว่าการบันทึกและการโหลดความคืบหน้าของเกมทำงานได้อย่างราบรื่น ซึ่งสำคัญอย่างยิ่งต่อการทดสอบในอุปกรณ์หลายเครื่องและหลังจากการอัปเดตแอป