API การเรียกคืน

Recall API ช่วยให้เกมใช้บริการเกมของ Play (PGS) เป็นส่วนเสริมร่วมกับ กลไกการลงชื่อเข้าใช้ที่มีอยู่ เช่น Google Sign-In และการซิงค์อย่างราบรื่น ของผู้เล่น ข้อมูลการลงชื่อเข้าใช้ในอุปกรณ์ต่างๆ เพื่อลดการเลิกใช้งานการเริ่มต้นใช้งาน และเพิ่มการคงผู้ใช้ไว้ 1 วัน API จัดการการลิงก์ระหว่างบัญชีบริการเกมของ Play (PGS) ของผู้ใช้กับ บัญชีในเกมโดยการจัดเก็บโทเค็น Recall ด้วยเซิร์ฟเวอร์ของ Google ต่อไปนี้คือ สถานการณ์ตัวอย่างเกี่ยวกับวิธีใช้ Recall API

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

   

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

   

3. ตอนนี้ผู้ใช้ตัดสินใจเล่นเกมใน Google Play Games บน PC สำหรับครั้งแรก ผู้ใช้จะลงชื่อเข้าใช้โดยอัตโนมัติด้วยบัญชี PGS และ ไคลเอ็นต์เกมจะตรวจสอบเพื่อดูว่า PGS นี้มีความคืบหน้าหรือไม่ ผู้ใช้ จากนั้นเซิร์ฟเวอร์เกมจะสืบค้น Google เพื่อดูว่ามีโทเค็นสำหรับ บัญชี PGS นี้ เนื่องจากมี Google จะส่งโทเค็น Recall กลับมา และ เซิร์ฟเวอร์เกมจะใช้โทเค็นนั้นเพื่อค้นหาบัญชีที่เชื่อมโยงของผู้ใช้ Racer94 จากนั้นจึงคืนค่าความคืบหน้า เนื่องจากการลงชื่อเข้าใช้ด้วย PGS เป็น เพื่อประสบการณ์ที่ราบรื่น แอปกู้คืนความคืบหน้าของผู้ใช้ได้ ผู้ใช้ต้องป้อนชื่อผู้ใช้หรือรหัสผ่าน นอกจากนี้ นักพัฒนาซอฟต์แวร์ ใช้การลงชื่อเข้าใช้ PGS ด้วยระบบข้อมูลประจำตัวที่มีอยู่และอาศัย Google เพื่อจัดเก็บลิงก์ระหว่างความคืบหน้าของผู้เล่นกับบัญชี PGS

   

ดังที่เห็นในตัวอย่างข้างต้น มีการดำเนินการหลักๆ 2 อย่างซึ่งทำโดย Recall API

• การจัดเก็บโทเค็นกับ Google เมื่อผู้ใช้เข้าสู่ระบบด้วยหนึ่งในเกม บัญชี
• ดึงข้อมูลโทเค็นให้ผู้ใช้เพื่อกู้คืนในเกม บัญชี

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

หมายเหตุ: สตริงที่ใช้สำหรับโทเค็น Recall และลักษณะตัวตนต้องเป็นแบบทึบและไม่คลุมเครือ มีข้อมูลที่ละเอียดอ่อนหรือข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (ซึ่งรวมถึง จำกัดเฉพาะชื่อ อีเมล และข้อมูลประชากร) เกมต้องใช้สมรรถนะสูง สำหรับการเข้ารหัสโทเค็นการเรียกคืนและลักษณะตัวตน

กฎ Cardinality

Recall API บังคับใช้ความสัมพันธ์แบบ 1:1 ระหว่างโปรไฟล์ PGS กับในเกม (หรือที่เรียกว่ากฎ Cardinality) ที่จะมี 1 ลักษณะตัวตนเท่านั้น ลิงก์กับโปรไฟล์ PGS 1 โปรไฟล์ และโปรไฟล์ PGS 1 โปรไฟล์ลิงก์กับโปรไฟล์ PGS ได้เพียงรายการเดียวเท่านั้น ลักษณะตัวตน ลักษณะตัวตนจะใช้เป็นตัวระบุแบบคงที่สำหรับบัญชีในเกม เนื่องจากโทเค็น Recall อาจมีการเปลี่ยนแปลงเมื่อเวลาผ่านไป

ลักษณะตัวตนที่ลิงก์กับโปรไฟล์ PGS อาจเปลี่ยนแปลงได้เมื่อเวลาผ่านไป (เพราะ บัญชีในเกมจะลิงก์กับโปรไฟล์ PGS)

ขั้นตอนทางเทคนิคโดยละเอียดสำหรับการจัดเก็บและ กำลังดึงข้อมูลโทเค็น Recall

ส่วนนี้จะครอบคลุมขั้นตอนด้านเทคนิคระหว่างไคลเอ็นต์เกม เซิร์ฟเวอร์เกม และเซิร์ฟเวอร์ของ Google เมื่อจัดเก็บและเรียกโทเค็น Recall

ขั้นตอนที่ 1: ลงชื่อเข้าใช้ผู้ใช้ PGS และเรียกข้อมูลรหัสเซสชัน

เกมจะเริ่มต้น PGS SDK และพยายามให้ผู้ใช้ลงชื่อเข้าใช้ด้วย PGS

สมมติว่าผู้ใช้ลงชื่อเข้าใช้แล้ว ให้ขอรหัสเซสชันจาก Games SDK ใน เกม และขอโทเค็น OAuth 2.0 จากแบ็กเอนด์ OAuth ของ Google ใช้รหัสเซสชันและโทเค็น OAuth 2.0 เพื่อสื่อสารกับ Google Games แบ็กเอนด์

ขั้นตอนที่ 2: ดึงข้อมูลโทเค็น Recall ที่พร้อมใช้งาน

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

ขั้นตอนที่ 3ก: หากมีโทเค็น ให้กู้คืนความคืบหน้า

หากมีโทเค็นอยู่ ให้เรียกและถอดรหัสโทเค็น รวมทั้งกู้คืนข้อมูลผู้ใช้

ขั้นตอนที่ 3ข: หากไม่มีโทเค็น ให้จัดเก็บโทเค็น

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

หมายเหตุ: นี่ไม่ใช่การลงชื่อเข้าใช้ด้วย PGS (ซึ่งทำไปแล้ว) แต่ใช้ ระบบข้อมูลประจำตัวของนักพัฒนาแอปที่อยู่นอก PGS

สร้างโทเค็นการเรียกคืนที่เข้ารหัสซึ่งจะเข้ารหัสบัญชีในเกมของผู้ใช้ และ ส่งไปยัง Google พร้อมกับรหัสเซสชันและโทเค็น OAuth 2.0 ในจุดนี้ Google สร้างการเชื่อมโยงระหว่างโทเค็น Recall ที่ส่งไป กับ บัญชี PGS ของผู้เล่น

ขั้นตอนสำหรับผู้ใช้ที่ไม่มีโปรไฟล์ PGS

คุณสามารถจัดเก็บโทเค็น Recall สําหรับผู้ใช้ที่ยังไม่ได้สร้างโปรไฟล์ PGS ได้โดย โดยใช้โหมดไร้โปรไฟล์ อย่างไรก็ตาม มีข้อควรระวังที่สำคัญ 2 ประการดังนี้

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

จัดเก็บโทเค็นและคู่ลักษณะตัวตน

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

เปิดตัวเกมในอุปกรณ์เครื่องใหม่

1. ผู้ใช้ที่ไม่มีโปรไฟล์ PGS จะเปิดเกมที่เปิดใช้การจดจำแบบไม่โปรไฟล์ บนอุปกรณ์
2. เกมจะบันทึกโทเค็น Recall ที่ไม่มีโปรไฟล์ตามที่อธิบายไว้ในจัดเก็บโทเค็น และลักษณะตัวตน
3. ผู้ใช้เปิดเกมเดียวกันในอุปกรณ์เครื่องอื่นที่มีบัญชีเดียวกัน การตั้งค่า
4. Games SDK จะทริกเกอร์การสร้างโปรไฟล์ ผู้ใช้ตรวจสอบและปฏิเสธได้ โทเค็น Recall ที่จัดเก็บไว้ก่อนหน้านี้ ผู้ใช้สร้างโปรไฟล์ PGS ในตอนนี้
5. การลงชื่อเข้าใช้ PGS โดยอัตโนมัติเสร็จสมบูรณ์ และเกมจะได้รับ สถานะตรวจสอบสิทธิ์แล้ว
6. เกมจะเรียกโทเค็น Recall ให้กับผู้ใช้ตามปกติ

ขั้นตอนถัดไป

ในการผสานรวม Recall API กับไคลเอ็นต์และเซิร์ฟเวอร์เกมของคุณ ให้ทำตาม คู่มือการใช้งานนี้