Trang này được dịch bởi Cloud Translation API.

Players

Người chơi đại diện cho người chơi trong Bảng xếp hạng và Thành tích.

Để biết danh sách phương thức cho tài nguyên này, hãy xem phần cuối của trang này.

Biểu diễn tài nguyên

Đây là mẫu JSON cho một tài nguyên của Người chơi.

{
  "kind": "games#player",
  "playerId": string,
  "displayName": string,
  "avatarImageUrl": string,
  "bannerUrlPortrait": string,
  "bannerUrlLandscape": string,
  "originalPlayerId": string,
  "lastPlayedWith": {
    "kind": "games#played",
    "timeMillis": long,
    "autoMatched": boolean
  },
  "profileSettings": {
    "kind": "games#profileSettings",
    "profileVisible": boolean,
    "friendsListVisibility": string
  },
  "name": {
    "familyName": string,
    "givenName": string
  },
  "experienceInfo": {
    "kind": "games#playerExperienceInfo",
    "currentExperiencePoints": long,
    "lastLevelUpTimestampMillis": long,
    "currentLevel": {
      "kind": "games#playerLevel",
      "level": integer,
      "minExperiencePoints": long,
      "maxExperiencePoints": long
    },
    "nextLevel": {
      "kind": "games#playerLevel",
      "level": integer,
      "minExperiencePoints": long,
      "maxExperiencePoints": long
    }
  },
  "title": string,
  "friendStatus": string
}

Tên tài sản	Giá trị	Mô tả
`avatarImageUrl`	`string`	URL cơ sở dành cho hình ảnh đại diện cho trình phát.
`bannerUrlLandscape`	`string`	URL đến hình ảnh biểu ngữ của trình phát ở chế độ ngang.
`bannerUrlPortrait`	`string`	URL đến hình ảnh biểu ngữ của trình phát ở chế độ dọc.
`displayName`	`string`	Tên hiển thị cho người chơi.
`experienceInfo`	`nested object`	Một đối tượng đại diện cho thông tin về trải nghiệm của người chơi trên Play.
`experienceInfo.currentExperiencePoints`	`long`	Số điểm kinh nghiệm hiện tại của người chơi.
`experienceInfo.currentLevel`	`nested object`	Cấp hiện tại của người chơi.
`experienceInfo.currentLevel.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định `games#playerLevel`.
`experienceInfo.currentLevel.level`	`integer`	Cấp độ cho người dùng.
`experienceInfo.currentLevel.maxExperiencePoints`	`long`	Điểm kinh nghiệm tối đa cho cấp này.
`experienceInfo.currentLevel.minExperiencePoints`	`long`	Điểm kinh nghiệm tối thiểu cho cấp này.
`experienceInfo.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định `games#playerExperienceInfo`.
`experienceInfo.lastLevelUpTimestampMillis`	`long`	Dấu thời gian khi người chơi lên cấp, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống Unix.
`experienceInfo.nextLevel`	`nested object`	Cấp độ tiếp theo của người chơi. Nếu cấp hiện tại là cấp tối đa, cấp này sẽ giống với cấp hiện tại.
`experienceInfo.nextLevel.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định `games#playerLevel`.
`experienceInfo.nextLevel.level`	`integer`	Cấp độ cho người dùng.
`experienceInfo.nextLevel.maxExperiencePoints`	`long`	Điểm kinh nghiệm tối đa cho cấp này.
`experienceInfo.nextLevel.minExperiencePoints`	`long`	Điểm kinh nghiệm tối thiểu cho cấp này.
`friendStatus`	`string`	Trạng thái bạn bè của người chơi đã cho, so với người yêu cầu. Chưa đặt nếu người chơi không chia sẻ danh sách bạn bè của họ với trò chơi. Các giá trị được chấp nhận là: "`FRIEND`" "`NO_RELATIONSHIP`"
`kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định `games#player`.
`lastPlayedWith`	`nested object`	Thông tin chi tiết về lần gần nhất người chơi này chơi một trò chơi nhiều người chơi với người chơi hiện đã được xác thực. Được điền sẵn cho các thành viên bộ sưu tập người chơi PLAY_WITH.
`lastPlayedWith.autoMatched`	`boolean`	Đúng nếu trình phát được tự động so khớp với người dùng hiện đã xác thực.
`lastPlayedWith.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định `games#played`.
`lastPlayedWith.timeMillis`	`long`	Lần cuối cùng người chơi chơi trò chơi tính bằng mili giây kể từ thời gian bắt đầu của hệ thống theo giờ UTC.
`name`	`object`	Một hình ảnh đại diện cho từng thành phần của tên người chơi. Đối với một số người chơi, những trường này có thể không xuất hiện.
`name.familyName`	`string`	Họ của người chơi này. Ở một số nơi, đây được gọi là họ.
`name.givenName`	`string`	Tên của người chơi này. Ở một số nơi, tên này được gọi là tên.
`originalPlayerId`	`string`	Mã người chơi đã dùng cho người chơi này vào lần đầu tiên họ đăng nhập vào trò chơi. Thông tin này chỉ được điền cho các lệnh gọi đến player.get cho trình phát yêu cầu, chỉ khi mã nhận dạng người chơi đã thay đổi sau đó và chỉ với các ứng dụng khách hỗ trợ việc ánh xạ lại mã nhận dạng người chơi.
`playerId`	`string`	Mã nhận dạng của người chơi.
`profileSettings`	`nested object`	Chế độ cài đặt hồ sơ của người chơi. Kiểm soát việc có thể hiển thị hồ sơ của người chơi với những người chơi khác hay không.
`profileSettings.friendsListVisibility`	`string`	Liệu danh sách bạn bè của người chơi có hiển thị trong trò chơi hay không. Các giá trị được chấp nhận là: "`REQUEST_REQUIRED`" "`UNAVAILABLE`" "`VISIBLE`"
`profileSettings.kind`	`string`	Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định `games#profileSettings`.
`profileSettings.profileVisible`	`boolean`
`title`	`string`	Tiêu đề của người chơi được thưởng cho các hoạt động trong trò chơi của họ.

Phương pháp

tải: Truy xuất tài nguyên của người chơi bằng mã nhận dạng đã cung cấp. Để truy xuất trình phát cho người dùng hiện đã được xác thực, hãy đặt playerId thành me.
list: Thu thập bộ sưu tập người chơi cho người dùng hiện đã được xác thực.