ทรัพยากร: ผู้เล่น
ทรัพยากรของโปรแกรมเล่น
การแสดง JSON |
---|
{ "kind": string, "playerId": string, "displayName": string, "avatarImageUrl": string, "bannerUrlPortrait": string, "bannerUrlLandscape": string, "originalPlayerId": string, "profileSettings": { object ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
playerId |
รหัสของโปรแกรมเล่น |
displayName |
ชื่อที่จะแสดงสำหรับโปรแกรมเล่น |
avatarImageUrl |
URL ฐานสำหรับรูปภาพที่แสดงถึงโปรแกรมเล่น |
bannerUrlPortrait |
URL ไปยังรูปภาพแบนเนอร์ของโปรแกรมเล่นในโหมดแนวตั้ง |
bannerUrlLandscape |
URL ไปยังรูปภาพแบนเนอร์ของโปรแกรมเล่นในโหมดแนวนอน |
originalPlayerId |
รหัสผู้เล่นที่ใช้สำหรับผู้เล่นรายนี้ในครั้งแรกที่พวกเขาลงชื่อเข้าใช้เกมที่เป็นปัญหา ค่านี้จะแสดงก็ต่อเมื่อมีการเรียก Player.get สำหรับโปรแกรมเล่นที่ส่งคำขอ ต่อเมื่อมีการเปลี่ยนรหัสโปรแกรมเล่นในภายหลัง และจะเกิดขึ้นเฉพาะกับไคลเอ็นต์ที่รองรับรหัสผู้เล่นที่แมปใหม่เท่านั้น |
profileSettings |
การตั้งค่าโปรไฟล์ของผู้เล่น ควบคุมว่าจะแสดงโปรไฟล์ของผู้เล่นคนอื่นๆ หรือไม่ |
name |
ตัวแทนออบเจ็กต์ของคอมโพเนนต์แต่ละรายการของชื่อผู้เล่น สำหรับผู้เล่นบางคน ช่องเหล่านี้อาจไม่มีอยู่ |
name.familyName |
นามสกุลของผู้เล่นรายนี้ ในบางแห่ง อาจเรียกว่านามสกุล |
name.givenName |
ชื่อจริงของผู้เล่นนี้ ในบางแห่ง อาจเรียกว่าชื่อจริง |
experienceInfo |
ออบเจ็กต์ที่แสดงข้อมูลประสบการณ์ Play Games ของผู้เล่น |
title |
ชื่อของผู้เล่นได้รับรางวัลจากกิจกรรมเกม |
friendStatus |
สถานะเพื่อนของผู้เล่นที่ระบุสัมพันธ์กับผู้ขอ ระบบจะยกเลิกการตั้งค่านี้หากผู้เล่นไม่ได้แชร์รายชื่อเพื่อนกับเกม |
gamePlayerId |
ตัวระบุโปรแกรมเล่นที่ไม่ซ้ำกันสำหรับแต่ละแอปพลิเคชัน |
ProfileSettings
การตั้งค่าโปรไฟล์
การแสดง JSON |
---|
{
"kind": string,
"profileVisible": boolean,
"friendsListVisibility": enum ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
profileVisible |
โปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในปัจจุบันจะเห็นโปรไฟล์ของผู้เล่นหรือไม่ |
friendsListVisibility |
|
FriendsListVisibility
รายชื่อเพื่อนของผู้เล่นจะเห็นในเกมนี้หรือขอได้ ช่องนี้จะมีข้อมูลสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในปัจจุบันเท่านั้น
Enum | |
---|---|
VISIBLE |
รายชื่อเพื่อนจะปรากฏให้เห็นในเกม |
REQUEST_REQUIRED |
นักพัฒนาซอฟต์แวร์ไม่มีสิทธิ์เข้าถึงรายชื่อเพื่อน แต่เรียกใช้ Android API เพื่อแสดงกล่องโต้ตอบความยินยอมได้ |
UNAVAILABLE |
ขณะนี้ รายชื่อเพื่อนไม่สามารถใช้ได้สำหรับผู้ใช้รายนี้ และไม่สามารถขอสิทธิ์การเข้าถึงได้ในขณะนี้ เนื่องจากผู้ใช้ได้ปฏิเสธอย่างถาวรแล้ว หรือพวกเขาไม่สามารถใช้งานคุณลักษณะเพื่อนได้ ในสถานะนี้ ความพยายามขอเข้าถึงรายชื่อเพื่อนจะไม่ประสบความสำเร็จ |
PlayerExperienceInfo
ข้อมูลเมตาของบุคคลที่หนึ่ง/บุคคลที่สามเกี่ยวกับประสบการณ์ของผู้เล่น
การแสดง JSON |
---|
{ "kind": string, "currentExperiencePoints": string, "lastLevelUpTimestampMillis": string, "currentLevel": { object ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
currentExperiencePoints |
จำนวนคะแนนประสบการณ์ปัจจุบันของผู้เล่น |
lastLevelUpTimestampMillis |
การประทับเวลาเมื่อผู้เล่นเลื่อนระดับเป็นมิลลิวินาทีตั้งแต่ Unix Epoch UTC |
currentLevel |
ระดับปัจจุบันของโปรแกรมเล่น |
nextLevel |
ระดับถัดไปของผู้เล่น หากระดับปัจจุบันเป็นระดับสูงสุด ควรเท่ากับระดับปัจจุบัน |
PlayerLevel
ข้อมูลเมตาของบุคคลที่หนึ่ง/บุคคลที่สามเกี่ยวกับระดับของผู้ใช้
การแสดง JSON |
---|
{ "kind": string, "level": integer, "minExperiencePoints": string, "maxExperiencePoints": string } |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ |
level |
ระดับสำหรับผู้ใช้ |
minExperiencePoints |
คะแนนประสบการณ์ขั้นต่ำสำหรับระดับนี้ |
maxExperiencePoints |
คะแนนประสบการณ์สูงสุดสำหรับระดับนี้ |
FriendStatus
กำหนดความสัมพันธ์แห่งมิตรภาพระหว่างผู้เล่น
Enum | |
---|---|
NO_RELATIONSHIP |
ผู้เล่นไม่ได้มีความสัมพันธ์กัน |
FRIEND |
ผู้เล่นและผู้ส่งคำขอเป็นเพื่อนกัน |
วิธีการ |
|
---|---|
|
เรียกข้อมูลทรัพยากรโปรแกรมเล่นด้วยรหัสที่กำหนด |
|
รับรหัสโปรแกรมเล่นของแอปพลิเคชันสำหรับโปรแกรมเล่นที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบันสำหรับเกมที่ขอทั้งหมดโดยนักพัฒนาซอฟต์แวร์รายเดียวกันกับแอปพลิเคชันการโทร |
|
เรียกข้อมูลตัวระบุโปรแกรมเล่นที่กำหนดขอบเขตสำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน |
|
รับคอลเล็กชันโปรแกรมเล่นสำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน |