หลังจากเลิกใช้งาน API ของ Google Sign-In แล้ว เราจะนำ SDK v1 ของเกมออกในปี 2026 หลังจากเดือนกุมภาพันธ์ 2025 คุณจะเผยแพร่
เกมที่เพิ่งผสานรวมกับ SDK v1 ของ Games ใน Google Play ไม่ได้ เราขอแนะนำให้ใช้ SDK v2 ของ Games แทน
แม้ว่าเกมที่มีอยู่ซึ่งผสานรวมกับเกมเวอร์ชัน 1 ก่อนหน้าจะยังคงทำงานได้อีก 2-3 ปี
แต่เราขอแนะนำให้คุณย้ายข้อมูลไปยัง v2
ตั้งแต่เดือนมิถุนายน 2025 เป็นต้นไป
คู่มือนี้มีไว้สำหรับการใช้ SDK บริการเกมของ Play เวอร์ชัน 1 ดูข้อมูล
เกี่ยวกับ SDK เวอร์ชันล่าสุดได้ที่
เอกสารประกอบ v2
การลงชื่อเข้าใช้บริการเกมของ Play จะช่วยให้คุณทราบตัวตนในการเล่นเกมของผู้เล่น ซึ่งเป็นตัวตนระดับแพลตฟอร์มที่เฉพาะเจาะจงสำหรับการเล่นเกมสำหรับผู้เล่น Android ซึ่งจะช่วยสร้างความสัมพันธ์ระหว่างเกมกับผู้เล่น ผู้เล่นเต็มใจที่จะใช้ข้อมูลประจำตัวนี้เพื่อลงชื่อเข้าใช้มากกว่าระบบส่วนกลางอื่นๆ
นอกจากนี้ การลงชื่อเข้าใช้ยังช่วยให้คุณมีตัวระบุที่สอดคล้องและเชื่อถือได้ ซึ่งคุณสามารถใช้เป็นคีย์สำหรับ ระบบการบันทึกในระบบคลาวด์ การบันทึกในระบบคลาวด์มีคุณค่าอย่างยิ่ง เนื่องจากช่วยให้ผู้เล่นทำสิ่งต่อไปนี้ได้
- เล่นต่อจากที่ค้างไว้หากผู้ใช้เปลี่ยนหรือรีเซ็ตอุปกรณ์
- เล่นเกมบนอุปกรณ์หลายเครื่อง (เช่น บนโทรศัพท์เครื่องอื่นหรือ Chromebook)
- ถอนการติดตั้งเกมแล้วติดตั้งอีกครั้งในภายหลัง
คุณสามารถใช้ข้อมูลประจำตัวของบริการเกม Play เป็นคีย์สำหรับโซลูชันการบันทึกในระบบคลาวด์ของคุณเอง หรือจะใช้บริการเกมที่บันทึกไว้แบบฟรีก็ได้
บริการเกมของ Play (PGS) รองรับการลงชื่อเข้าใช้โดยอัตโนมัติ ซึ่งเป็นวิธีที่ราบรื่นในการ ลงชื่อเข้าใช้ของผู้เล่น รวมถึงการลงชื่อเข้าใช้ด้วยตนเอง ซึ่งเป็นกระบวนการแบบคลิกเดียว เอกสารนี้อธิบายวิธีการลงชื่อเข้าใช้แบบต่างๆ เหล่านี้
ขั้นตอนการลงชื่อเข้าใช้ที่แนะนำ
หากต้องการให้ผู้เล่นลงชื่อเข้าใช้เกมได้สำเร็จ ให้ใช้ขั้นตอนการลงชื่อเข้าใช้ต่อไปนี้
- ในระหว่างลำดับการเริ่มต้นของเกม ให้ลองใช้การลงชื่อเข้าใช้โดยอัตโนมัติ เพื่อลงชื่อเข้าใช้ให้ผู้เล่นโดยอัตโนมัติ
- หากการลงชื่อเข้าใช้โดยอัตโนมัติใช้ไม่ได้และอุปกรณ์ของผู้ใช้ออนไลน์อยู่ ให้ลองการลงชื่อเข้าใช้ด้วยตนเอง
- หากการลงชื่อเข้าใช้ด้วยตนเองถูกปฏิเสธ ให้จดจำตัวเลือกของผู้ใช้และไม่แสดง การลงชื่อเข้าใช้ด้วยตนเองอีก แต่ให้ลองใช้การลงชื่อเข้าใช้โดยอัตโนมัติต่อไปเมื่อเริ่มต้นระบบ
นอกจากนี้ คุณควรตรวจสอบว่าผู้ใช้สามารถลงชื่อเข้าใช้เกมด้วย บัญชีบริการเกมของ Play โดยใช้ปุ่มเฉพาะที่ค้นหาได้ง่าย
ลงชื่อเข้าใช้โดยอัตโนมัติ
การลงชื่อเข้าใช้โดยอัตโนมัติช่วยให้ผู้ใช้ลงชื่อเข้าใช้เกมของคุณได้อย่างราบรื่นโดยอัตโนมัติ หากเกมขอให้ผู้ใช้ลงชื่อเข้าใช้และเปิดใช้การตั้งค่าการลงชื่อเข้าใช้อัตโนมัติ (ในแอป Google Play Games) คุณจะได้รับ ข้อมูลเข้าสู่ระบบระบุตัวตน PGS ของผู้ใช้ และผู้ใช้จะเห็นประสบการณ์การลงชื่อเข้าใช้ PGS
การลงชื่อเข้าใช้โดยอัตโนมัติเป็นการตั้งค่าที่ผู้ใช้ควบคุมได้ ผู้ใช้เลือกที่จะ ลงชื่อเข้าใช้เกมทั้งหมดโดยอัตโนมัติหรือรับคำขอทุกครั้งได้
ลงชื่อเข้าใช้ด้วยตนเอง
หากผู้ใช้ไม่ได้ลงชื่อเข้าใช้เกมโดยอัตโนมัติ คุณสามารถขอให้ผู้ใช้ลงชื่อเข้าใช้ด้วยตนเองได้ ผู้ใช้สามารถลงชื่อเข้าใช้ได้ในคลิกเดียวจากกล่องโต้ตอบที่แสดงที่ด้านบน ของเกม
อนุญาตป๊อปอัป PGS เพื่อให้ได้รับประสบการณ์การลงชื่อเข้าใช้ที่ถูกต้อง
เมื่อใช้ PGS ผู้ใช้ต้องทราบว่าตนเองลงชื่อเข้าใช้แล้ว โดยการแสดงประสบการณ์การลงชื่อเข้าใช้ PGS
หากต้องการแสดงประสบการณ์การลงชื่อเข้าใช้ ให้เรียกใช้เมธอด
setViewForPopups()
ของคลาส GamesClient ระหว่างการเริ่มต้นเกม ซึ่งเป็นสิ่งสำคัญในการ
มอบประสบการณ์ที่ถูกต้องให้แก่ผู้ใช้
ขอบเขต OAuth และ PGS
PGS ใช้ระบบ OAuth เพื่ออนุญาตให้ผู้ใช้ ให้สิทธิ์เกมของคุณเข้าถึงบัญชีของตน ขอบเขต OAuth คือสิทธิ์ที่คุณในฐานะนักพัฒนาแอปขอได้ หากได้รับสิทธิ์เหล่านี้ เกมจะเรียก API บางอย่างในนามของผู้ใช้ได้ และคุณจะได้รับสิทธิ์เข้าถึงส่วนต่างๆ ของบัญชี Google ของผู้ใช้ด้วย
PGS มีขอบเขตที่ไม่ซ้ำกันสำหรับเกม (games-lite) และต้องอาศัยขอบเขตอื่น
(drive.appdata) หากเกมของคุณใช้ฟีเจอร์เกมที่บันทึกไว้ ฟีเจอร์เกมที่บันทึกไว้
จะให้สิทธิ์เข้าถึงบัญชี Google ไดรฟ์ของผู้ใช้ ซึ่งเป็นที่เก็บข้อมูล
เกม
เกมของคุณขอขอบเขตใดก็ได้ที่จำเป็นต่อการสร้างประสบการณ์การเล่นเกมที่ยอดเยี่ยม สำหรับผู้ใช้ เกมของคุณสามารถขอขอบเขตทั้งหมดที่ต้องการได้ในแพ็กเกจเดียว ซึ่งจะจำกัดจำนวนคำขอเข้าถึงบัญชี Google อย่างไรก็ตาม วิธีนี้มีข้อเสียที่สำคัญ หากคุณขอขอบเขตที่มากกว่าขอบเขตเฉพาะของ PGS การลงชื่อเข้าใช้โดยอัตโนมัติจะไม่สำเร็จ การลงชื่อเข้าใช้โดยอัตโนมัติเป็นวิธีที่ดีที่สุดในการให้ ผู้เล่นลงชื่อเข้าใช้เกมของคุณ
แนวทางปฏิบัติแนะนำคือการใช้คำขอขอบเขตที่เพิ่มขึ้น เกมของคุณควรถามขอบเขตที่ใช้ได้กับ PGS เท่านั้นก่อนในคำขอเริ่มต้น และขอขอบเขตอื่นๆ แยกกันในเวลาที่เกี่ยวข้องมากขึ้น
ระบบจะให้สิทธิ์เข้าถึง OAuth โดยใช้หน้าจอที่แตกต่างกันสำหรับแต่ละขอบเขต ซึ่งจะช่วยให้ ผู้ใช้ตัดสินใจได้ว่าจะให้สิทธิ์เข้าถึงขอบเขตใดบ้างอย่างละเอียด การใช้ การลงชื่อเข้าใช้โดยอัตโนมัติที่มีเฉพาะขอบเขต PGS จะช่วยให้ผู้ใช้ไม่ต้องโต้ตอบกับข้อความแจ้ง OAuth ใดๆ ซึ่งจะช่วยลดปัญหาในการลงชื่อเข้าใช้
รองรับวิธีการลงชื่อเข้าใช้หลายวิธี
PGS ระบุตัวตนในการเล่นเกมสำหรับผู้เล่น Android แต่ไม่จำเป็นต้องเป็นตัวตนเดียวที่เชื่อมต่อกับผู้ใช้ คุณสามารถให้ผู้เล่นลงชื่อเข้าใช้โดยใช้ PGS, รหัสเครือข่ายโซเชียล และระบบรหัสในเกมของคุณเองได้พร้อมกัน แต่ละระบบมีคุณค่าเฉพาะสำหรับทั้งคุณและผู้เล่น และทั้งหมดสามารถทำงานร่วมกันเพื่อมอบประสบการณ์ที่ยอดเยี่ยมแก่ผู้เล่น Android
ดึงข้อมูลและยืนยันตัวตนของผู้เล่นอย่างปลอดภัยเพื่อการผสานรวมกับแบ็กเอนด์
คุณขอรหัสการให้สิทธิ์เซิร์ฟเวอร์เพื่อเปิดใช้เซิร์ฟเวอร์ ให้สื่อสารกับเซิร์ฟเวอร์บริการเกมของ Play โดยตรงผ่าน REST API ด้วย สิทธิ์ของผู้เล่นที่ลงชื่อเข้าใช้ได้ ซึ่งจะช่วยให้เข้าถึง รหัส โปรไฟล์ และข้อมูลอื่นๆ ของผู้เล่นได้โดยตรง (เช่น รายชื่อเพื่อน หากได้รับอนุญาต) หากคุณจัดเก็บรหัสผู้เล่น รหัสเพื่อน หรือข้อมูลอื่นๆ ที่เกี่ยวข้องไว้ในแบ็กเอนด์ คุณต้องใช้วิธีนี้เพื่อป้องกันไม่ให้มีการดัดแปลงฟิลด์เหล่านี้ในอุปกรณ์
นอกจากนี้ สำหรับเกมและผู้เล่นบางรายที่เก่ากว่า รหัสผู้เล่นที่ SDK ของ Android แสดงผลสำหรับผู้เล่นอาจไม่ใช่รหัสเดียวกับที่ผู้เล่นคนอื่นๆ เห็นเมื่อดูผู้เล่นรายนั้นในเกมเดียวกัน ซึ่งเกี่ยวข้องอย่างยิ่งเมื่อใช้รายชื่อเพื่อน อย่างไรก็ตาม player_id ที่แสดงใน REST API จะสอดคล้องกันเสมอและจะเป็นรหัสที่ผู้เล่นคนอื่นๆ เห็นเสมอ
ดูข้อมูลเพิ่มเติมได้ที่ การเข้าถึงแบบออฟไลน์และเอกสารประกอบเกี่ยวกับ REST API
การติดตั้งใช้งานฝั่งไคลเอ็นต์
ดูวิธีรองรับการลงชื่อเข้าใช้ใน Android ได้ที่การลงชื่อเข้าใช้ในเกม Android