Ressource: Player
Eine Spielerressource.
JSON-Darstellung |
---|
{ "kind": string, "playerId": string, "displayName": string, "avatarImageUrl": string, "bannerUrlPortrait": string, "bannerUrlLandscape": string, "originalPlayerId": string, "profileSettings": { object ( |
Felder | |
---|---|
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
playerId |
ID des Spielers |
displayName |
Der Name, der für den Player angezeigt werden soll. |
avatarImageUrl |
Die Basis-URL für das Bild, das den Player repräsentiert. |
bannerUrlPortrait |
Die URL zum Bannerbild des Players im Hochformat |
bannerUrlLandscape |
Die URL zum Player-Bannerbild im Querformat. |
originalPlayerId |
Die Spieler-ID, die für diesen Spieler bei der ersten Anmeldung in dem betreffenden Spiel verwendet wurde. Dieses Feld wird nur bei Aufrufen von „player.get“ für den anfordernden Spieler ausgefüllt, wenn sich die Spieler-ID später geändert hat, und nur bei Clients, die die Neuzuordnung von Spieler-IDs unterstützen. |
profileSettings |
Profileinstellungen des Spielers Mit dieser Einstellung legen Sie fest, ob das Profil des Spielers für andere Spieler sichtbar ist. |
name |
Objektdarstellung der einzelnen Komponenten des Spielernamens Bei einigen Spielern sind diese Felder möglicherweise nicht vorhanden. |
name.familyName |
Familienname dieses Spielers An einigen Stellen wird das auch als Nachname bezeichnet. |
name.givenName |
Name dieses Spielers In manchen Ländern wird er auch als Vorname bezeichnet. |
experienceInfo |
Ein Objekt zur Darstellung von Play-Spiel-Informationen für den Spieler. |
title |
Der Titel des Spielers wurde für seine Spieleaktivitäten belohnt. |
friendStatus |
Der Freundschaftsstatus des angegebenen Spielers, relativ zum Anfragenden. Diese Option ist nicht konfiguriert, wenn der Spieler seine Freundesliste nicht mit dem Spiel teilt. |
gamePlayerId |
Eindeutige Spieler-ID pro App. |
ProfileSettings
Profileinstellungen
JSON-Darstellung |
---|
{
"kind": string,
"profileVisible": boolean,
"friendsListVisibility": enum ( |
Felder | |
---|---|
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
profileVisible |
Gibt an, ob das Profil des Spielers für den derzeit angemeldeten Spieler sichtbar ist |
friendsListVisibility |
|
FriendsListVisibility
Gibt an, ob die Freundesliste des Spielers für dieses Spiel sichtbar oder angefordert werden kann Dieses Feld wird nur für den derzeit angemeldeten Spieler ausgefüllt.
Enums | |
---|---|
VISIBLE |
Die Freundesliste ist derzeit für das Spiel sichtbar. |
REQUEST_REQUIRED |
Der Entwickler hat keinen Zugriff auf die Freundesliste, kann aber die Android API aufrufen, um einen Dialog zur Einholung von Einwilligungen anzuzeigen. |
UNAVAILABLE |
Die Freundesliste ist für diesen Nutzer derzeit nicht verfügbar und kann im Moment keinen Zugriff anfordern, da der Nutzer entweder dauerhaft abgelehnt hat oder die Freundesfunktion für ihn nicht verfügbar ist. In diesem Status schlagen alle Versuche, den Zugriff auf die Freundesliste anzufordern, fehl. |
PlayerExperienceInfo
Eigene/Drittanbieter-Metadaten zum Erlebnis des Players.
JSON-Darstellung |
---|
{ "kind": string, "currentExperiencePoints": string, "lastLevelUpTimestampMillis": string, "currentLevel": { object ( |
Felder | |
---|---|
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
currentExperiencePoints |
Die aktuelle Anzahl der Erfahrungspunkte für den Spieler. |
lastLevelUpTimestampMillis |
Der Zeitstempel, zu dem der Spieler das nächste Level erreicht hat, in Millis seit der Unix-Epoche UTC. |
currentLevel |
Das aktuelle Level des Spielers. |
nextLevel |
Das nächste Level des Spielers. Wenn die aktuelle Pegel die höchste Stufe ist, sollte diese mit der aktuellen Pegel übereinstimmen. |
PlayerLevel
Eigene/Drittanbieter-Metadaten zur Ebene eines Nutzers.
JSON-Darstellung |
---|
{ "kind": string, "level": integer, "minExperiencePoints": string, "maxExperiencePoints": string } |
Felder | |
---|---|
kind |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String |
level |
Die Ebene für den Nutzer. |
minExperiencePoints |
Die minimale Erfahrungspunkte für dieses Level. |
maxExperiencePoints |
Die maximalen Erfahrungspunkte für dieses Level. |
FriendStatus
Definiert Freundschaftsbeziehungen zwischen Spielern.
Enums | |
---|---|
NO_RELATIONSHIP |
Es besteht keine Beziehung zwischen den Spielern. |
FRIEND |
Spieler und Anfragender sind Freunde. |
Methoden |
|
---|---|
|
Ruft die Spielerressource mit der angegebenen ID ab. |
|
Ruft die Spieler-IDs der Anwendung für den derzeit authentifizierten Player für alle Spiele vom selben Entwickler wie die aufrufende Anwendung ab. |
|
Ruft Spieler-IDs für den aktuell authentifizierten Nutzer ab. |
|
Ruft die Sammlung der Spieler für den aktuell authentifizierten Nutzer ab. |