- Ressource: Player
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- ProfileSettings
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FriendsListVisibility
- PlayerExperienceInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- PlayerLevel
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FriendStatus
- Methoden
Ressource: Spieler
Eine Spielerressource.
JSON-Darstellung |
---|
{ "kind": string, "playerId": string, "displayName": string, "avatarImageUrl": string, "bannerUrlPortrait": string, "bannerUrlLandscape": string, "originalPlayerId": string, "profileSettings": { object ( |
Felder | |
---|---|
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
playerId |
ID des Players |
displayName |
Der für den Player anzuzeigende Name. |
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 Bannerbild des Players im Querformat. |
originalPlayerId |
Die Spieler-ID, die für diesen Spieler bei seiner ersten Anmeldung im betreffenden Spiel verwendet wurde. Dieses Feld wird nur bei Aufrufen von player.get für den anfordernden Spieler ausgefüllt, nur dann, wenn sich die Spieler-ID anschließend geändert hat, und nur bei Clients, die die Neuzuordnung der Spieler-IDs unterstützen. |
profileSettings |
Profileinstellungen des Spielers Legt fest, ob das Profil des Spielers für andere Spieler sichtbar ist. |
name |
Eine Objektdarstellung der einzelnen Komponenten des Spielernamens. Für einige Spieler sind diese Felder möglicherweise nicht vorhanden. |
name.familyName |
Familienname dieses Spielers An einigen Stellen wird dies als Nachname bezeichnet. |
name.givenName |
Der Vorname dieses Spielers. An manchen Stellen wird dies als Vorname bezeichnet. |
experienceInfo |
Ein Objekt, das Informationen zum Spielerlebnis für den Spieler darstellt. |
title |
Der Titel des Spielers, der für seine Spielaktivitäten belohnt wird. |
friendStatus |
Der Freundschaftsstatus des Spielers im Verhältnis zum Anfragenden. Diese Einstellung ist nicht festgelegt, wenn der Spieler seine Freundesliste nicht mit dem Spiel teilt. |
gamePlayerId |
Eindeutige Spielerkennung pro Anwendung. |
ProfileSettings
Profileinstellungen
JSON-Darstellung |
---|
{
"kind": string,
"profileVisible": boolean,
"friendsListVisibility": enum ( |
Felder | |
---|---|
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. 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 ist oder angefordert werden kann. Dieses Feld wird nur für den aktuell 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 momentan nicht verfügbar und es kann derzeit keine Zugriffsanfrage gestellt werden, weil der Nutzer entweder dauerhaft abgelehnt hat oder die Funktion "Freunde" für ihn nicht verfügbar ist. In diesem Status schlagen alle Versuche, Zugriff auf die Freundesliste anzufordern, fehl. |
PlayerExperienceInfo
Selbst erhobene und Drittanbieter-Metadaten zur Erfahrung des Spielers.
JSON-Darstellung |
---|
{ "kind": string, "currentExperiencePoints": string, "lastLevelUpTimestampMillis": string, "currentLevel": { object ( |
Felder | |
---|---|
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
currentExperiencePoints |
Die aktuelle Anzahl der Erfahrungspunkte für den Spieler. |
lastLevelUpTimestampMillis |
Der Zeitstempel für den Zeitpunkt, zu dem das Level des Players erreicht wurde, in Millisekunden seit der Unix-Epoche UTC. |
currentLevel |
Der aktuelle Pegel des Players. |
nextLevel |
Das nächste Level des Players. Wenn die aktuelle Ebene die höchste ist, muss sie mit der aktuellen Ebene übereinstimmen. |
PlayerLevel
Selbst erhobene und Drittanbieter-Metadaten zur Ebene eines Nutzers.
JSON-Darstellung |
---|
{ "kind": string, "level": integer, "minExperiencePoints": string, "maxExperiencePoints": string } |
Felder | |
---|---|
kind |
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String |
level |
Das Level für den Nutzer. |
minExperiencePoints |
Die Mindestanzahl von Erfahrungspunkten für dieses Level. |
maxExperiencePoints |
Die maximalen Erfahrungspunkte für dieses Level. |
FriendStatus
definiert Freundschaftsbeziehungen zwischen Spielern.
Enums | |
---|---|
NO_RELATIONSHIP |
Es gibt keine Beziehung zwischen den Spielern. |
FRIEND |
Spieler und Anforderer sind Freunde. |
Methoden |
|
---|---|
|
Ruft die Player-Ressource mit der angegebenen ID ab. |
|
Ruft die Spieler-IDs der Anwendung für den derzeit authentifizierten Spieler für alle angeforderten Spiele vom gleichen Entwickler wie die aufrufende Anwendung ab. |
|
Ruft die Spielerkennungen mit Bereichsbereich für den aktuell authentifizierten Nutzer ab. |
|
Ruft die Sammlung der Spieler für den derzeit authentifizierten Nutzer ab. |