หลังจากเลิกใช้งาน 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