เพื่อน

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

  • ค้นหาเพื่อนในเกมของคุณ

  • เปรียบเทียบคะแนนกับเพื่อนๆ บนลีดเดอร์บอร์ด

  • รวมรายชื่อเพื่อนใน Play Games เข้ากับรายชื่อในเกมที่มีอยู่ของ เพื่อน

  • ระบุผู้เล่นรายอื่นด้วยป๊อปอัปโปรไฟล์ในเกม ป๊อปอัปนี้แสดง ชื่อเล่นที่ผู้เล่นปัจจุบันตั้งให้เพื่อน เพื่อให้ทราบว่าใคร ที่กำลังเล่นกันอยู่

นำเข้าเพื่อน

พื้นฐาน

API เหล่านี้ช่วยให้คุณดำเนินการต่อไปนี้ได้

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

นำเข้ารายชื่อเพื่อนใน Play Games

คุณใช้ API ของเพื่อนเพื่อรับรายชื่อ Play Games ของผู้เล่นได้ และเพิ่มลงในรายชื่อเพื่อนในเกม

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

เพิ่มเพื่อนใน Play Games ในเกม

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

เมื่อใช้รายชื่อเพื่อนจากเซิร์ฟเวอร์แบ็กเอนด์ ให้โหลดอย่างปลอดภัย โดยใช้ REST API แทนการส่งผลลัพธ์ของ Android API ตรวจสอบว่า เพื่อใช้รหัสผู้เล่นที่ players.get(me) ส่งคืนใน REST API สำหรับ ผู้เล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ เนื่องจากรหัสนี้จะสอดคล้องกับรหัสที่ผู้อื่นเห็น ผู้เล่น

หากไม่ได้จัดเก็บรายชื่อเพื่อนที่เพิ่ม (แต่ใช้ในเวลา ) คุณก็ไม่ต้องดำเนินการใดๆ เพิ่มเติม

ให้สิทธิ์เข้าถึง Play Games

หากเกมของคุณยังไม่มีสิทธิ์เข้าถึง Play Games ให้ดำเนินการดังนี้ แจ้งให้ผู้ใช้ให้ความยินยอมคือเมื่อผู้ใช้ดูรายชื่อเพื่อนในเกม สำหรับ ตัวอย่างเช่น คุณอาจเพิ่มปุ่มนำเข้าเพื่อนใน Play Games แจ้งขอความยินยอมจากผู้ใช้เมื่อมีการแตะ (ตรวจสอบว่าใช้ โลโก้ Play Games บนปุ่มที่กล่าวถึงบริการ

ดูโปรไฟล์ของผู้เล่นอื่น

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

ดูโปรไฟล์ของผู้เล่นอื่น

ลีดเดอร์บอร์ดโซเชียล

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

เพื่อนในลีดเดอร์บอร์ด

ถ้าคุณใช้คอลเล็กชันลีดเดอร์บอร์ดทางสังคม การเรียกให้โหลด คะแนนในลีดเดอร์บอร์ดอาจแสดงผลข้อยกเว้นในการแก้ปัญหาซึ่งต้องได้รับความยินยอม ซึ่งคล้ายกับ จาก loadFriends() หากคุณใช้ UI ที่เป็นค่าเริ่มต้นของ Play Games (ตัวอย่างเช่น getLeaderboardIntent()), ระบบจะแก้ไขปัญหานี้ให้คุณโดยอัตโนมัติ

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

ก่อนที่จะเริ่มใช้ Friends API ให้ทำดังต่อไปนี้