Anzeigen:
Modul: Toplist

Mit einer Instanz von ToplistAccess kann eine App Toplist erzeugen und verwalten.

Die Instanz für die ToplistAccess erhält man über das KnuddelsServer-Objekt mit KnuddelsServer.getToplistAccess()

Methoden

createOrUpdateToplist

(
  • userPersistenceNumberKey
  • displayName
  • [parameters]
)
Toplist

Erzeugt oder aktualisiert die Toplist für den übergebenen userPersistenceNumberKey.

Parameter:

  • userPersistenceNumberKey String

    Persistenz-Key für den die Topliste erzeugt oder aktualisiert werden soll

  • displayName String

    Anzeigename der Topliste (2-50 Zeichen lang)

  • [parameters] Object optional

    Möglichkeit ein weitere Parameter zu übergeben.

    • [labelMapping] Object optional

      Mapping der gespeicherten Zahl zu einem Anzeigenamen (max. 50 Stück, je 2-50 Zeichen lang)

    • [ascending] Boolean optional

      Sortierreihenfolge ändern (default: false)

Rückgabewert:

Beispiel:

var labelMapping = {
    '1': 'Anfänger', // 1-24
    '25': 'Beginner', // 25-49
    '50': 'Profi', // 50-99
    '100': 'Genius' // ab 100
};

var toplist = toplistAccess.createOrUpdateToplist('points', 'Punkte', {

    labelMapping: labelMapping,
    ascending: false

});

getAllToplists

() Toplist[]

Liefert die Liste aller Toplisten, die diese App erzeugt hat.

Rückgabewert:

Beispiel:

var allToplists = toplistAccess.getAllToplists();

getToplist

(
  • userPersistenceNumberKey
)
Toplist

Liefert die Toplist mit dem Persistenz-Key zurück.

Parameter:

  • userPersistenceNumberKey String

Rückgabewert:

Beispiel:

var pointsToplist = toplistAccess.getToplist('points');

removeToplist

(
  • toplist
)

Löscht die übergebene Toplist oder die Toplist mit dem Persistenz-Key.

Parameter:

Beispiel:

toplistAccess.removeToplist(toplist);