Tài nguyên: Người chơi
Tài nguyên Trình phát.
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "playerId": string, "displayName": string, "avatarImageUrl": string, "bannerUrlPortrait": string, "bannerUrlLandscape": string, "originalPlayerId": string, "profileSettings": { object ( |
Các trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
playerId |
Mã nhận dạng của người chơi. |
displayName |
Tên hiển thị cho trình phát. |
avatarImageUrl |
URL cơ sở cho hình ảnh đại diện cho trình phát. |
bannerUrlPortrait |
URL đến ảnh biểu ngữ của trình phát ở chế độ dọc. |
bannerUrlLandscape |
URL đến ảnh biểu ngữ của trình phát ở chế độ ngang. |
originalPlayerId |
Mã nhận dạng người chơi được dùng cho người chơi này trong lần đầu tiên họ đăng nhập vào trò chơi có liên quan. Mã này chỉ được điền sẵ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 sau đó thay đổi, và chỉ cho các ứng dụng hỗ trợ tính năng ánh xạ lại mã nhận dạng người chơi. |
profileSettings |
Chế độ cài đặt hồ sơ của người chơi. Kiểm soát việc có hiển thị hồ sơ của người chơi với những người chơi khác hay không. |
name |
Một đối tượng đại diện cho các thành phần riêng lẻ trong tên người chơi. Đối với một số người chơi, các trường này có thể không xuất hiện. |
name.familyName |
Họ của người chơi này. Ở một số nơi, tên này được gọi là họ. |
name.givenName |
Tên của người chơi này. Ở một số nơi, đây được gọi là tên đầu tiên. |
experienceInfo |
Một đối tượng thể hiện thông tin về trải nghiệm của người chơi trên Play Trò chơi. |
title |
Danh hiệu của người chơi được tặng thưởng cho các hoạt động của họ trong trò chơi. |
friendStatus |
Trạng thái bạn bè của người chơi đã cho, so với người yêu cầu. Chế độ này sẽ không được thiết lập nếu người chơi không chia sẻ danh sách bạn bè của họ với trò chơi đó. |
gamePlayerId |
Giá trị nhận dạng người chơi duy nhất cho mỗi ứng dụng. |
ProfileSettings
Cài đặt hồ sơ
Biểu diễn dưới dạng JSON |
---|
{
"kind": string,
"profileVisible": boolean,
"friendsListVisibility": enum ( |
Các trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
profileVisible |
Liệu hồ sơ của người chơi có hiển thị với người chơi hiện đang đăng nhập hay không. |
friendsListVisibility |
|
FriendsListVisibility
Liệu danh sách bạn bè của người chơi có hiển thị với trò chơi này hay không hoặc có thể yêu cầu được không. Trường này chỉ được điền sẵn cho người chơi hiện đang đăng nhập.
Enum | |
---|---|
VISIBLE |
Danh sách bạn bè hiện đang hiển thị với trò chơi. |
REQUEST_REQUIRED |
Nhà phát triển không có quyền truy cập vào danh sách bạn bè nhưng có thể gọi API Android để hiển thị hộp thoại đồng ý. |
UNAVAILABLE |
Danh sách bạn bè hiện không khả dụng đối với người dùng này và không thể yêu cầu quyền truy cập tại thời điểm này, do người dùng đã vĩnh viễn từ chối hoặc tính năng bạn bè của họ không hoạt động. Ở trạng thái này, mọi nỗ lực yêu cầu quyền truy cập vào danh sách bạn bè sẽ không thành công. |
PlayerExperienceInfo
Siêu dữ liệu của bên thứ nhất/bên thứ ba về trải nghiệm của người chơi.
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "currentExperiencePoints": string, "lastLevelUpTimestampMillis": string, "currentLevel": { object ( |
Các trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
currentExperiencePoints |
Số điểm kinh nghiệm hiện tại của người chơi. |
lastLevelUpTimestampMillis |
Dấu thời gian khi người chơi được 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 (UTC). |
currentLevel |
Cấp độ hiện tại của người chơi. |
nextLevel |
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, thì cấp này phải giống với cấp hiện tại. |
PlayerLevel
Siêu dữ liệu của bên thứ nhất/bên thứ ba về cấp độ của người dùng.
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "level": integer, "minExperiencePoints": string, "maxExperiencePoints": string } |
Các trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định |
level |
Cấp độ của người dùng. |
minExperiencePoints |
Điểm kinh nghiệm tối thiểu để đạt được cấp độ này. |
maxExperiencePoints |
Điểm kinh nghiệm tối đa cho cấp này. |
FriendStatus
Xác định mối quan hệ bạn bè giữa những người chơi.
Enum | |
---|---|
NO_RELATIONSHIP |
Không có mối quan hệ với nhau giữa những người chơi. |
FRIEND |
Người chơi và người yêu cầu là bạn bè. |
Phương thức |
|
---|---|
|
Truy xuất tài nguyên Trình phát bằng mã nhận dạng cho trước. |
|
Lấy mã nhận dạng người chơi ứng dụng cho người chơi hiện đã được xác thực trên tất cả các trò chơi được yêu cầu bởi cùng một nhà phát triển giống như ứng dụng gọi. |
|
Truy xuất giá trị nhận dạng người chơi trong phạm vi cho người dùng hiện đã xác thực. |
|
Nhận bộ sưu tập người chơi cho người dùng hiện đã được xác thực. |