หลังจากเลิกใช้งาน API ของ Google Sign-In แล้ว เราจะนำ SDK v1 ของเกมออกในปี 2026 หลังจากเดือนกุมภาพันธ์ 2025 คุณจะเผยแพร่
เกมที่เพิ่งผสานรวมกับ SDK v1 ของ Games ใน Google Play ไม่ได้ เราขอแนะนำให้ใช้ SDK v2 ของ Games แทน
แม้ว่าเกมที่มีอยู่ซึ่งผสานรวมกับ v1 ก่อนหน้านี้จะยังทำงานได้อีก 2-3 ปี
แต่เราขอแนะนำให้คุณย้ายข้อมูลไปยัง v2
ตั้งแต่เดือนมิถุนายน 2025 เป็นต้นไป
คู่มือนี้มีไว้สำหรับการใช้ SDK บริการเกมของ Play v1 ดูข้อมูล
เกี่ยวกับ 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