Tài nguyên: Trình phát
Tài nguyên Người chơi.
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 ( |
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 trình phát. |
displayName |
Tên hiển thị cho người chơi. |
avatarImageUrl |
URL cơ sở của hình ảnh đại diện cho trình phát. |
bannerUrlPortrait |
URL dẫn đến hình ảnh biểu ngữ của trình phát ở chế độ dọc. |
bannerUrlLandscape |
URL dẫn đến hình ả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 vào lần đầu tiên họ đăng nhập vào trò chơi liên quan. Mã này chỉ được điền sẵn cho các lệnh gọi đến play.get cho người chơi yêu cầu, chỉ khi mã nhận dạng người chơi sau đó đã thay đổi, và chỉ những ứng dụng khách hỗ trợ gán 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 hồ sơ của người chơi có hiển thị 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. Một số người chơi có thể không thấy các trường này. |
name.familyName |
Họ của người chơi này. Ở một số nơi, đâ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. |
experienceInfo |
Đối tượng để biểu thị 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 đền đáp cho các hoạt động trong trò chơi của họ. |
friendStatus |
Trạng thái bạn bè của người chơi cụ thể, liên quan đến người yêu cầu. Chính sách này sẽ không được đặ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. |
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 ( |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
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ể được yêu cầu hay 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 |
Hiện tại, trò chơi có thể nhìn thấy danh sách bạn bè. |
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 để cho thấy hộp thoại đồng ý. |
UNAVAILABLE |
Danh sách bạn bè hiện không khả dụng cho người dùng này và không thể yêu cầu quyền truy cập vào thời điểm này, bởi vì người dùng đã từ chối vĩnh viễn hoặc tính năng bạn bè không khả dụng đối với họ. Ở 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è đều 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 ( |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
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 (giờ 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 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 } |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
level |
Cấp độ cho người dùng. |
minExperiencePoints |
Điểm kinh nghiệm tối thiểu cho cấp độ này. |
maxExperiencePoints |
Số điểm kinh nghiệm tối đa cho cấp độ này. |
FriendStatus
Xác định quan hệ bạn bè giữa những người chơi.
Enum | |
---|---|
NO_RELATIONSHIP |
Không có mối quan hệ nào 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. |
|
Lấy mã trình phát ứng dụng của 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 dưới dạng ứng dụng gọi. |
|
Truy xuất giá trị nhận dạng người chơi trong phạm vi của người dùng hiện đã được xác thực. |
|
Lấy tập hợp người chơi cho người dùng hiện đã được xác thực. |