เพื่อน

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

  • ค้นหาเพื่อนในเกม

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

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

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

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

พื้นฐาน

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

  • โหลดข้อมูลเพื่อน: คุณตรวจสอบได้ว่าโปรแกรมเล่นอนุญาตให้เกมเข้าถึงข้อมูลรายชื่อเพื่อนหรือไม่ หากมีสิทธิ์เข้าถึง คุณจะได้รับรายการออบเจ็กต์ของผู้เล่นที่ตรงกับเพื่อนของผู้เล่นที่ลงชื่อเข้าใช้
  • เปิดมุมมองโปรไฟล์ 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 สําหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ เนื่องจากจะสอดคล้องกับรหัสที่ผู้เล่นคนอื่นเห็น

หากไม่ได้เก็บรายชื่อเพื่อนที่เป็น Augmented ไว้ (แต่เพิ่งใช้ขณะดู) ก็ไม่จําเป็นต้องดําเนินการใดๆ เพิ่มเติม

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

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

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

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

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

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

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

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

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

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

ก่อนที่จะเริ่มใช้ Friends API ให้ทําตามขั้นตอนต่อไปนี้