เพื่อน

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

  • ค้นหาเพื่อนของผู้เล่นในเกม

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

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

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

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

ข้อมูลเบื้องต้น

API เหล่านี้ช่วยให้คุณทําสิ่งต่อไปนี้ได้

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

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

คุณสามารถใช้ Friends 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 คนจะเป็นชื่อในเกม (หากระบุไว้) ระบบจะแสดงชื่อเกมที่เริ่มมิตรภาพด้วย

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

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

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

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

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

โปรดทําดังนี้ก่อนเริ่มใช้ Friends API