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

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

คำศัพท์

เอกสารนี้ใช้คำศัพท์ต่อไปนี้

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

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

สถานการณ์ตัวอย่าง

ต่อไปนี้เป็นสถานการณ์ตัวอย่างของการใช้ Recall API

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

   

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

   

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

   

ดังที่เห็นในตัวอย่างก่อนหน้านี้ Recall API จะดำเนินการหลักๆ 2 อย่าง ได้แก่

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

• เรียก โทเค็นสำหรับผู้ใช้เพื่อกู้คืนบัญชีในเกม

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

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

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

ขั้นตอนที่ 1: ตรวจสอบสิทธิ์ผู้ใช้ PGS และเรียกข้อมูลรหัสเซสชัน

เกมจะเริ่มต้น SDK ของ PGS และพยายามตรวจสอบสิทธิ์ผู้ใช้ด้วย PGS

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

ขั้นตอนที่ 2: เรียกโทเค็นเรียกคืนข้อมูลที่มีอยู่

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

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

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

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

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

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

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

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

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

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