Knuddels User Apps - API Dokumentation

  • Dokumentation für Version 20240419-122957 (ChatServer: 20240419-122957)

    • Knuddels
    User App Entwicklung
    API Dokumentation
    KnuddelPot

    KnuddelPot Klasse

    Modul: Knuddel

    Diese Klasse ist veraltet.

    Repräsentiert einen KnuddelPot. Ein KnuddelPot kann nur durch Factory-Methoden des KnuddelsServer erzeugt werden: createKnuddelPot.

    Wird die App heruntergefahren, so werden alle KnuddelPots, die nicht gesealt sind automatisch refunded.

    KnuddelPot wurde abgeschafft. Deprecation Hinweis beachten!
    Diese Klasse wird nicht mehr unterstützt, da KnuddelAccounts abgeschafft wurden. Alle Methoden sind als veraltet markiert und sollten nicht mehr verwendet werden.

    • Der Aufruf von Methoden dieser Klasse führt keine Logik mehr aus und gibt immer null oder ein leeres Array zurück.

    Übersicht

    Methoden

    Methoden

    addWinner

    (
    • user
    • [weight]
    )
    Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Fügt einen Gewinner in die Liste der Gewinner hinzu. Der zweite Parameter ist die Gewichtung mit der ausgezahlt werden soll. Wird der Parameter weggelassen, so ist er automatisch 1.

    Parameter:

    • user User
    • [weight] Number optional
      • 1, wenn nicht übergeben

    Beispiel:

    var participants = knuddelPot.getParticipants();

var winner = RandomOperations.getRandomObject(participants);

knuddelPot.addWinner(winner);

var reason = 'Das Spiel ist vorbei. ' + winner + ' ist als Sieger daraus hervorgegangen.'

knuddelPot.payout(reason);

    getFeeMultiplier

    () Number Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Liefert den mit setFee gesetzten Multiplikator der Gebühr.

    Rückgabewert:

    Number:

    Beispiel:

    var feeMultiplier = knuddelPot.getFeeMultiplier(); // i.e.: 0.05

    getFeeUser

    () User Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Liefert den mit setFee gesetzten BotUser an den die Gebühr ausbezahlt wird.

    Rückgabewert:

    User:

    Beispiel:

    var feeUser = knuddelPot.getFeeUser(); // i.e.: User:MyAppBot

    getId

    () Number Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Liefert die id des KnuddelPot.

    Rückgabewert:

    Number:

    id

    Beispiel:

    var potId = knuddelPot.getId(); // i.e.: 11

    getKnuddelAmountPerParticipant

    () KnuddelAmount Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Liefert den beim Kreieren des KnuddelPots festgelegten KnuddelAmount, den jeder Teilnehmer zahlen muss.

    Rückgabewert:

    KnuddelAmount:

    Beispiel:

    var knuddelAmount = knuddelPot.getKnuddelAmountPerParticipant();

    getKnuddelAmountTotal

    () KnuddelAmount Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Liefert den KnuddelAmount, der bisher insgesamt in den KnuddelPot eingezahlt wurde.

    Rückgabewert:

    KnuddelAmount:

    Beispiel:

    var getKnuddelAmountTotal = knuddelPot.getKnuddelAmountTotal();

    getMaxFeeMultiplier

    () Number Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Liefert den höchsten Multiplikator, der gültig ist.

    Rückgabewert:

    Number:

    Beispiel:

    var maxFeeMultiplier = knuddelPot.getMaxFeeMultiplier(); // i.e. 0.25

var botUser = KnuddelsServer.getDefaultBotUser();

knuddelPot.setFee(botUser, maxFeeMultiplier);

    getParticipants

    () User[] Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Liefert die Liste der Teilnehmer, die bisher in den KnuddelPot eingezahlt haben.

    Rückgabewert:

    User[]:

    Beispiel:

    var participants = knuddelPot.getParticipants();

participants.forEach(function(user) 
{
    participants.sendPrivateMessage('Das Spiel wurde gestartet.');
});

    getState

    () KnuddelPotState Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Liefert den Status des KnuddelPot.

    Rückgabewert:

    KnuddelPotState:

    state

    Beispiel:

    var state = knuddelPot.getState(); // i.e.: KnuddelPotState.Open

    payout

    (
    • [text]
    )
    Veraltet asynchron

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Zahlt den KnuddelPot an die mit addWinner gesetzten Gewinner aus.

    Parameter:

    Beispiel:

    var participants = knuddelPot.getParticipants();

var winner = RandomOperations.getRandomObject(participants);

knuddelPot.addWinner(winner);

var reason = 'Das Spiel ist vorbei. ' + winner + ' ist als Sieger daraus hervorgegangen.'

knuddelPot.payout(reason);

    refund

    (
    • [reason]
    )
    Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Bezahlt alle Einsätze an die Teilnehmer zurück und informiert mit dem übergeben Text über den Grund.

    Parameter:

    Beispiel:

    knuddelPot.refund('Die App fährt gleich für ein Update herunter.');

    seal

    () Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Versiegelt den KnuddelPot, sodass keine weiteren Einzahlungen vorgenommen werden können und Gewinne ausgeschüttet werden können.

    Beispiel:

    var state = knuddelPot.getState();

if (state == KnuddelPotState.Open)
{
    knuddelPot.seal();
}
else
{
    // Bereits versiegelt oder ausgezahlt...
}

    setFee

    (
    • feeUser
    • feeMultiplier
    )
    Veraltet

    Veraltet: Diese Methode ist veraltet und sollte nicht mehr verwendet werden.

    Setzt den BotUser, der den Anteil der Einzahlungen nach dem Spiel erhält und den Anteil, vom Gesamtpot, den er erhalten soll.

    Parameter:

    Beispiel:

    var bot = KnuddelsServer.getDefaultBotUser();
var fee = 0.1;

knuddelPot.setFee(bot, fee);