Das hier ist ein Tutorial für UserApp-Entwickler. Allgemeine Artikel zum Knuddelaccount sind der Artikel Knuddelaccount und der Artikel /knuddelaccount.
Wieso KnuddelAccount verwenden?
Der Knuddelaccount ermöglicht es UserApp-Entwicklern und MyChannel-Betreibern u. a., Knuddelgebühren zu sparen, da Nutzer der UserApp einen gewissen Betrag Knuddel zur freien Verfügung stellen können, ohne ihn direkt an den AppBot zu überweisen. Außerdem können Nutzer so einen besseren Überblick über ihre Knuddel behalten und die Betreiber sind besser vor Schaden geschützt (bspw. vor Nutzern, die durch häufige Ein- und Auszahlungen schaden wollen).
Hook "onAccountReceivedKnuddel"
Die UserApps-API funktioniert derzeit so, dass sie ihr Verhalten bzgl. Knuddelaccounts ändert, wenn der Entwickler die Hook onAccountReceivedKnuddel implementiert hat.
Wenn ein Nutzer mit /appknuddel Knuddel an einen AppBot überweist, geht der Betrag normalerweise direkt an den AppBot. Ist aber die Hook vorhanden, wird der Betrag zunächst auf den KnuddelAccount des Users überwiesen. Der Bot kann dann jederzeit mit KnuddelAccount.use() Knuddel von dem KnuddelAccount tatsächlich auf den Bot transferieren. Zugriff auf den KnuddelAccount eines Users erhält man über User.getKnuddelAccount()
Standard (ohne "onAccountReceivedKnuddel"-Hook):
Mit "onAccountReceivedKnuddel"-Hook:
Wichtige Funktionen in der API
- KnuddelAccount.use(): KnuddelAccount → Bot
- BotUser.transferKnuddel(): Bot → User / KnuddelAccount
- User.getKnuddelAccount()