Knuddels-Wiki - Benutzerbeiträge [de]

User App:Frontend/Environment

2019-11-05T17:31:02Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

Es gibt bei der HTML-UI ein paar Besonderheiten bzw. Anpassungen die ihr bei einer unveränderten Browser-Umgebung nicht hättet. Hier werden diese näher erleutert.

== UserApps Client-API ==

Die [https://developer.knuddels.de/docs/modules/HTMLUI.html Client-API] (alle APIs dort mit `Client.<xxx>`) sind zusätzlich verfügbar. diese stellen euch ein paar Hilfs-Methoden zur Verfügung und sind die Schnittstelle um Events an den Server zu schicken und von diesem zu empfangen.

== Erzwungene Client-Updates ==

Öffnet sich beim Nutzer eine HTML-UI (auch von SystemApps - also von Knuddels selbst veröffentlichen Features) und wir erkennen dass der Nutzer einen veralteten Chat-Client verwendet der für die zu öffnende HTML-UI nicht geeignet ist, dann wird dem Nutzer statt der HTML-UI ein Migrations/Update-Hinweis angezeigt. Dies betrifft vor allem Nutzer mit einer veralteten PC-App von Knuddels.

== Neuer AppLoader ==

Seit dem 17.07.2018 gibt es für HTML-UIs eine neue Loader Architektur, der neue "AppLoader". Dieser bringt einige neue Möglichkeiten, Features und Änderungen an APIs mit sich. Auf diese wird in den folgenden Abschnitten eingegangen.

== Polyfills (API-Patches die wir automatisch einspielen) ==

Es liegt leider in der Natur der Browser, dass nicht alle (Firefox, Chrome, Edge, Safari, Chrome for Android, jxBrowser [Desktop App], Internet Explorer) das gleiche Set an Features und API unterstützen. Manchmal haben bestimmte Implementierungen auch Bugs. Daher patchen wir den Browser bevor die erste Zeile eures Codes ausgeführt wird. Wir patchen folgende APIs:

* [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise Promise] (API für asynchrone Programmierung)
* [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/assign Object.assign] (Manipulation von Javascript-Objekten)
* [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol Symbol] (hier benutzen wir das NPM Package 'core-js/modules/es6.symbol')
* [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/iterator Symbol.interator] (hier benutzen wir das NPM Package 'core-js/fn/symbol/iterator.js')
* [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/startsWith String.prototype.startsWith]

Ihr müsst diese Patches/Polyfills also nicht mehr selbst einbinden, falls ihr diese API/Features benutzen wollt.

== Sandbox <iframe> ==

Eure HTML-UI wird innerhalb eines [https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe <iframe>] das in einer [https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe#Attributes Sandbox (siehe "sandbox"-Attribute)] ausgeführt wird geladen. Das bringt ein paar Einschränkungen mit sich, die ihr in der verlinkten Dokumentation zum sandbox-Attribut nachlesen könnt. Auch Zugriff zu Kamera und Mikrofon sind nicht möglich.
Es sind folgendes allow-* Flags gesetzt: allow-forms, allow-orientation-lock, allow-pointer-lock, allow-same-origin, allow-scripts

== Veränderungen von Web-APIs ==

Wir haben auch einige wenige normale Web-APIs verändert. Das haben wir vor allem getan da diese technische Probleme provozieren können oder konnten oder weil sie die User-Experience stark negativ beeinflussen können.

* ''alert()'' erzeugt jetzt ein Warning und wird sonst ersetzt durch [https://developer.mozilla.org/en-US/docs/Web/API/Console/log console.log()]
* ''prompt()'' erzeugt jetzt ein Warning und macht sonst nichts
* ''confirm()'' erzeugt jetzt ein Warning und macht sonst nichts
* [https://developer.mozilla.org/en-US/docs/Web/API/Window/history window.history] ist komplett deaktiviert

== Änderungen an bestehenden APIs ==

Mit dem neuen AppLoader haben wir kleine Anpassungen an bestehenden APIs vorgenommen die vor allem der Natur sind, dass sie technische Probleme oder Lücken fixen oder verhindern.

* [https://developer.knuddels.de/docs/classes/Client.html#method_addEventListener Client.addEventListener(type, callback)]: `type` muss nun vom Typ `string` sein
* [https://developer.knuddels.de/docs/classes/Client.html#method_removeEventListener Client.removeEventListener(type)]: Funktioniert jetzt wieder und entfernt alle Listener des entsprechenden Typs (durch einen Fehler wurde der Listener nie entfernt)
* (NEU) [https://developer.knuddels.de/docs/classes/Client.html#method_removeEventListener Client.removeEventListener(type, callback)]: entfernt einen bestimmten Listener für ein bestimmtes Event
* Nutzeraktivitätsmessung: Der Mechanismus der die Aktivät des Nutzers in der HTML-UI misst wurde überarbeitet und funktioniert jetzt wie gewollt (das heißt der "/dice"-Hack ist nicht mehr nötig)

== Deprecation Notice (veraltete APIs) ==

Im alten AppLoader gab es aus historischen Gründen noch einige APIs die seit Jahren nicht mehr zur offiziellen Dokumentation und damit API gehört haben. Diese haben wir nun entweder entfernt (da sie sowieso nur für interne Verwendung gedacht waren). Andere APIs, die aktuell noch immer von vielen Apps genutzt werden, haben wir mit Warnungen versehen und dazu Migrations-Hinweise veröffentlicht. Auf diese gehen wir nun etwas näher ein.

Wir werden diese APIs zu einem noch nicht definierten Zeitpunkt in der Zukunft entfernen. Wir kündigen das dann rechtzeitig an.

'''Für euch heißt das''': Bitte passt eure Apps an und tauscht die veralteten APIs mit der entsprechenden aktuellen API aus! (siehe Warnings)

=== document.addEventListener("eventReceived", function() {...}) ===

'''Warning''': ''You are using a deprecated API (document event listener for "eventReceived"). Please use "Client.addEventListener()" instead. See: https://developer.knuddels.de/docs/classes/Client.html#method_addEventListener''

Es gab in den Anfangszeiten [https://forum.knuddels.de/ubbthreads.php?ubb=showflat&Number=2909131#Post2909131 wie hier erwähnt] kurzzeitig diese Variante um Events vom Server zu empfangen. In dieser Zeit ist auch die Ziegenphobie-Demo-App entstanden. Wir haben nach wenigen Monaten die alte API als "Deprecated" markiert, und sie war auch niemals offiziell dokumentiert. Da wir aber versäumt haben die HTML-UI-Demo-App (Ziegenphobie) an die neuen APIs anzupassen hat sich die Verwendung dieser API stark verbreitet. Die Demo-Apps mit HTML-UI sind jetzt auf die aktuellsten APIs aktualisiert worden.

=== Client.onSendEventReceived() ===

'''Warning''': ''You are using "Client.onSendEventReceived()" which is an internal API. Please use "Client.dispatchEvent()" instead. See: https://developer.knuddels.de/docs/classes/Client.html#method_dispatchEvent''

Diese API war nie öffentlich oder offiziell. Allerdings hat sie mindestens den Weg in ein beliebtes Framework geschafft und sich dadurch weit verbreitet. Aus diesem Grund können wir sie nicht ohne Weiteres entfernen. Es ist generell immer der empfohlene und richtige Weg ausschließlich APIs zu verwenden die in der offiziellen Dokumentation auch entsprechend dokumentiert sind.

== Weiterführende Informationen ==

Wir haben für die Entwicklung von Webseiten und vor allem Apps mit Web-Technologien einen [https://docs.google.com/document/d/1W9hguLt7ScQkKpOJ_sDlKXjJVyqpi7oO1iBmG066g0c/edit Web-Client Coding Guide] geschrieben. Dort findet ihr sehr viele weitere Infos und Guidelines für erfolgreiches Entwickeln im Web Frontend.
Hinweis: Dieser Guide ist für Fortgeschrittene!

[[Kategorie:UserApp-Entwicklung]]

User App:Backend/Environment

2019-11-05T17:30:41Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

[Dies ist vorerst eine sporadische Version dieses Artikels. Ausführlicher Artikel folgt.]

== UserApps Server ==

Der Server-Teil einer UserApp läuft auf einem Server von Knuddels. Der Server-Teil besteht ausschließlich aus einer Config ("app.config") und einer "main.js" als Einstiegspunkt. Die Umgebung in der die UserApp ausgeführt wird ist eine [https://developer.mozilla.org/en-US/docs/Mozilla/Projects/Rhino Rhino-Instanz].

Was diese Rhino-Instanz an JavaScript-Features hat kann man in dieser [https://kangax.github.io/compat-table/es6/ Compatibility Table] nachschlagen.

== Schwierigkeiten ==

Da die aktuell verwendete JavaScript Runtime (Rhino) nicht sonderlich auf der Höhe der Zeit ist muss man einige sonst üblichen Features patchen (Polyfill) oder Transpiler einsetzen. Hier eine kleine Übersicht:

* [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/const const] wird nicht unterstützt ([https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/let let] hingegen schon)
* [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise Promise] muss man polyfillen (aus Kompatibilitätsgründen empfehlen wir NPM Package "es6-promise" version "4.1.0")

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials

2019-08-09T10:26:39Z

Tom Unterwegs: Link auf Knuddels Blog geändert

Hier ist eine Sammlung aller Tutorials zur UserApp-Entwicklung.

== Für Anfänger ==
Lerne Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Einstieg]]
* [[UserApp-Entwicklung/Tutorials/HTML-UI|HTML-UI (grafische Oberfläche)]]

== Für Fortgeschrittene ==

* [[UserApp-Entwicklung/Tutorials/UserApps_teilen|UserApps installieren und freigeben]]
* [[UserApp-Entwicklung/Tutorials/Newsletter-Versand|Newsletter-Versand]]
* [[UserApp-Entwicklung/Tutorials/AppBot-Profilbild|AppBot-Profilbild]]
* [[UserApp-Entwicklung/Tutorials/KnuddelAccount|KnuddelAccount]]

Du kannst dich auf Discord an fortgeschrittene UserApp-Entwickler wenden. Den Link zum Discord-Channel findest du unter '''/apps developer'''.

== Weitere Tutorials ==

* [https://blog.knuddels.de/user-app-tutorials/ blog.knuddels.de] - hier gibt es viele Tutorials!
* [[User_Apps/Tutorial|Hallo Welt]]

== Meta ==

Tutorial über das Schreiben von UserApp-Tutorials: [[UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta|UserApp-Tutorials-Meta]]

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials

2019-08-09T10:25:55Z

Tom Unterwegs: Link auf Knuddels Blog geändert

Hier ist eine Sammlung aller Tutorials zur UserApp-Entwicklung.

== Für Anfänger ==
Lerne Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Einstieg]]
* [[UserApp-Entwicklung/Tutorials/HTML-UI|HTML-UI (grafische Oberfläche)]]

== Für Fortgeschrittene ==

* [[UserApp-Entwicklung/Tutorials/UserApps_teilen|UserApps installieren und freigeben]]
* [[UserApp-Entwicklung/Tutorials/Newsletter-Versand|Newsletter-Versand]]
* [[UserApp-Entwicklung/Tutorials/AppBot-Profilbild|AppBot-Profilbild]]
* [[UserApp-Entwicklung/Tutorials/KnuddelAccount|KnuddelAccount]]

Du kannst dich auf Discord an fortgeschrittene UserApp-Entwickler wenden. Den Link zum Discord-Channel findest du unter '''/apps developer'''.

== Weitere Tutorials ==

* [https://blog.knuddels.de/user-app-tutorials/] - hier gibt es viele Tutorials!
* [[User_Apps/Tutorial|Hallo Welt]]

== Meta ==

Tutorial über das Schreiben von UserApp-Tutorials: [[UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta|UserApp-Tutorials-Meta]]

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials

2019-08-09T10:24:52Z

Tom Unterwegs: Struktur geändert und Link auf Knuddels Blog hinzugefügt

Hier ist eine Sammlung aller Tutorials zur UserApp-Entwicklung.

== Für Anfänger ==
Lerne Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Einstieg]]
* [[UserApp-Entwicklung/Tutorials/HTML-UI|HTML-UI (grafische Oberfläche)]]

== Für Fortgeschrittene ==

* [[UserApp-Entwicklung/Tutorials/UserApps_teilen|UserApps installieren und freigeben]]
* [[UserApp-Entwicklung/Tutorials/Newsletter-Versand|Newsletter-Versand]]
* [[UserApp-Entwicklung/Tutorials/AppBot-Profilbild|AppBot-Profilbild]]
* [[UserApp-Entwicklung/Tutorials/KnuddelAccount|KnuddelAccount]]

Du kannst dich auf Discord an fortgeschrittene UserApp-Entwickler wenden. Den Link zum Discord-Channel findest du unter '''/apps developer'''.

== Weitere Tutorials ==

* [https://blog.knuddels.de/user-app-tutorials/#Tutorial blog.knuddels.de] - hier gibt es viele Tutorials!
* [[User_Apps/Tutorial|Hallo Welt]]

== Meta ==

Tutorial über das Schreiben von UserApp-Tutorials: [[UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta|UserApp-Tutorials-Meta]]

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials

2019-08-08T14:18:41Z

Tom Unterwegs: Fehler in Link korrigiert

Hier ist eine Sammlung aller Tutorials zur UserApp-Entwicklung.

== Für Anfänger ==
Lerne Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Einstieg]]
* [[UserApp-Entwicklung/Tutorials/HTML-UI|HTML-UI (grafische Oberfläche)]]
* [[UserApp-Entwicklung/Tutorials/UserApps_teilen|UserApps installieren und freigeben]]
* [[UserApp-Entwicklung/Tutorials/Newsletter-Versand|Newsletter-Versand]]
* [[UserApp-Entwicklung/Tutorials/AppBot-Profilbild|AppBot-Profilbild]]
* [[UserApp-Entwicklung/Tutorials/KnuddelAccount|KnuddelAccount]]

== Für Fortgeschrittene ==

''Es gibt leider noch keine Tutorials für Fortgeschrittene.''

Du kannst dich auf Discord an fortgeschrittene UserApp-Entwickler wenden. Den Link zum Discord-Channel findest du unter '''/apps developer'''.

== Weitere Tutorials ==

* [[User_Apps/Tutorial|Hallo Welt]]

== Meta ==

Tutorial über das Schreiben von UserApp-Tutorials: [[UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta|UserApp-Tutorials-Meta]]

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials/KnuddelAccount

2019-08-08T14:17:58Z

Tom Unterwegs: Die Seite wurde neu angelegt: „Das hier ist ein Tutorial für UserApp-Entwickler. Allgemeine Artikel zum Knuddelaccount sind der Artikel Knuddelaccount und der Artikel [[/knuddelaccount]…“

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ühr]]en 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 [[UserApp-Entwicklung/Doku/Hook|Hook]] [https://developer.knuddels.de/docs/classes/App.html#method_onAccountReceivedKnuddel onAccountReceivedKnuddel] implementiert hat.

Wenn ein Nutzer mit <function>/appknuddel</function> 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 [https://developer.knuddels.de/docs/classes/KnuddelAccount.html#method_use KnuddelAccount.use()] Knuddel von dem KnuddelAccount tatsächlich auf den Bot transferieren. Zugriff auf den KnuddelAccount eines Users erhält man über [https://developer.knuddels.de/docs/classes/User.html#method_getKnuddelAccount User.getKnuddelAccount()]

=== Standard (ohne "onAccountReceivedKnuddel"-Hook): ===

[[Datei:knuddeaccount_no_hook.png|560px|Knuddel-Fluss mit onAccountReceivedKnuddel-Hook]]

=== Mit "onAccountReceivedKnuddel"-Hook: ===

[[Datei:knuddeaccount_hook.png|560px|Knuddel-Fluss mit onAccountReceivedKnuddel-Hook]]

== Wichtige Funktionen in der API ==

* [https://developer.knuddels.de/docs/classes/KnuddelAccount.html#method_use KnuddelAccount.use()]: KnuddelAccount → Bot
* [https://developer.knuddels.de/docs/classes/BotUser.html#method_transferKnuddel BotUser.transferKnuddel()]: Bot → User / KnuddelAccount
* [https://developer.knuddels.de/docs/classes/User.html#method_getKnuddelAccount User.getKnuddelAccount()]

[[Kategorie:UserApp-Entwicklung]]

Datei:knuddeaccount no hook.png

2019-08-08T13:45:41Z

Tom Unterwegs: Hinweis auf Tutorial hinzugefügt

== Beschreibung ==

Gehört zum Tutorial [[UserApp-Entwicklung/Tutorials/KnuddelAccount]].

[[Kategorie:UserApp-Entwicklung]]

Datei:knuddeaccount no hook.png

2019-08-08T13:44:57Z

Tom Unterwegs: Kategorie:UserApp-Entwicklung

== Beschreibung ==
[[Kategorie:UserApp-Entwicklung]]

Datei:knuddeaccount hook.png

2019-08-08T13:21:56Z

Tom Unterwegs: Kategorie Verlinkung repariert

== Beschreibung ==

Gehört zum Tutorial [[UserApp-Entwicklung/Tutorials/KnuddelAccount]].

[[Kategorie:UserApp-Entwicklung]]

Datei:knuddeaccount hook.png

2019-08-08T13:20:34Z

Tom Unterwegs: [[Kategorie:UserApp-Entwicklung]

== Beschreibung ==
[[Kategorie:UserApp-Entwicklung]

UserApp-Entwicklung/Doku/Hook

2019-08-08T09:10:14Z

Tom Unterwegs: Die Seite wurde neu angelegt: „ == Was sind Hooks? == Aus Wikipedia<ref>https://de.wikipedia.org/wiki/Hook_(Informatik)</ref>: ::'''Hook''' (englisch für Haken, auch Einschubmethode genan…“

== Was sind Hooks? ==

Aus Wikipedia<ref>https://de.wikipedia.org/wiki/Hook_(Informatik)</ref>:

::'''Hook''' (englisch für Haken, auch Einschubmethode genannt) bezeichnet in der Programmierung eine Schnittstelle, mit der fremder Programmcode in eine bestehende Anwendung integriert werden kann, um diese zu erweitern, deren Ablauf zu verändern oder um bestimmte Ereignisse abzufangen.

Solche Hooks gibt es auch in der [[API|UserApps-API]], nämlich für das [https://developer.knuddels.de/docs/classes/App.html App-Objekt]. Bei der Ausführung des Codes wird getestet, ob die entsprechende Funktion (z.B. onUserJoined, mayShowPublicMessage etc.) vorliegt; Die Funktion wird dann bei den entsprechenden Aktionen aufgerufen - egal welchen Code der Entwickler in diese Funktion geschrieben hat.

 

[[Kategorie:UserApp-Entwicklung]]

Kategorie:UserApp-Entwicklung

2019-08-08T08:45:59Z

Tom Unterwegs: Link auf Startseite "UserApp-Entwicklung" hinzugefügt

[[UserApp-Entwicklung|Startseite "UserApp-Entwicklung"]]

Die '''Kategorie "UserApp-Entwicklung''' enthält alle Artikel zu [[User_App|UserApps]], die für '''UserApp-Entwickler''' gedacht sind - also [[UserApp-Entwicklung/Tutorials|Tutorials]], technische Dokumentation usw. 
Im Gegensatz dazu enthält die andere [https://knuddels-wiki.de/index.php?title=Kategorie:User_App Kategorie "User App"] Artikel, die für gewöhnliche Nutzer gedacht sind.

UserApp-Entwicklung/Doku/AppId

2019-08-08T08:44:40Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

= AppId =
=== Was ist die AppId? ===
Die '''AppId''' ist eine eindeutige Zuordnung einer App zu seinem Entwickler. Sie wird benötigt um gleichnamige Apps voneinander zu unterscheiden.
=== Woraus setzt sich die AppId zusammen? ===
Die '''AppId''' setzt sich aus folgenden Teilen zusammen: 
     <FUNCTION>knuddelsDEV</FUNCTION>  .  <FUNCTION><FTP-Benutzername></FUNCTION>  .  
<FUNCTION><Ordner-Name></FUNCTION>
=== Wie kann ich die AppId auslesen? ===
Um die '''AppId''' auszulesen kannst du folgenden Coden nutzen:
<PRE>KnuddelsServer.getAppAccess().getOwnInstance().getRootInstance().getAppInfo().getAppId();</PRE>
* [https://developer.knuddels.de/docs/classes/AppInfo.html#method_getAppId AppInstance.getAppId()]

[[Kategorie:UserApp-Entwicklung]]

/knuddelaccount

2019-08-08T08:41:08Z

Tom Unterwegs: zu Kategorie "User App" hinzugefügt

[[Datei:Vorschau - Knuddelaccount (Kontenübersicht).jpg|thumb|250px|Vorschau der Funktion]]

==Allgemeines==
Mit der [[Funktion]] <function>/knuddelaccount</function> ruft man im Java-[[Chat]] eine Übersicht seiner Knuddelkonten auf. Diese Konten beziehen sich auf die Userapps in [[MyChannel]]n.

==Voraussetzungen==
Jedes Mitglied, welches im Chat Java-Chat online ist, kann die Funktion <function>/knuddelaccount</function> nutzen.

==Syntax==

===/knuddelaccount===
Öffnet im Chat ein Fenster, welches eine Übersicht der vorhanden Knuddelkonten zeigt.
Über die gewählten Aktionen kann man sich vom Konto die Kontoauszüge zeigen lassen, oder die vorhandenen Knuddel Auszahlen lassen. Dies geht jeweils über die Links im Aktions Menü.

==Weiterführende Informationen==
* [[Liste der Chatfunktionen]] - Hier befindet sich eine Übersicht aller vorhandenen Chatfunktionen
* [[Knuddelaccount]] - Informationen zum Knuddelaccount

[[Kategorie:Chatfunktion|knuddelaccount]] [[Kategorie:User_App]]

Knuddelaccount

2019-08-08T08:40:01Z

Tom Unterwegs: zu Kategorie "User App" hinzugefügt

==Allgemeines==
Der '''Knuddelaccount''' oder auch einfacher gesagt die Übersicht der Knuddelkonten für die [[User Apps]] wurde am 24.07.[[2015]] ins Knuddelsystem eingepflegt. Die Übersicht zeigt in erster Linie eine bessere Kontoübersicht der Konten aus den MyChannel-Apps. Die [[Funktion]] dient aber nicht nur den Usern, sondern auch dem Knuddelssystem. Die Knuddel, die ein User von der App erhält, werden demnach auch ab sofort versteuert. Dies bedeutet, dass die App, aber auch jeder User, bei einer Knuddelüberweisung die [[Knuddelgebühr]] an das System zu entrichten hat. Die Gebühr wird automatisch an das System übermittelt.

Eine Übersicht der Konten erhält man jeder Zeit im Chat, sobald man dort den [[Befehl]] [[/knuddelaccount]] eingibt.

==Vorschau==
<gallery>
Vorschau - Knuddelaccount (Kontenübersicht).jpg‎|Kontenübersicht
Vorschau - Knuddelaccount (Kontoauszug).jpg|Kontoauszug
</gallery>

==Weiterführende Informationen==
*[[Liste der Chatfunktionen]] - Übersicht aller Chatfunktionen
*[[User Apps]] - Alle Infos zu den von Nutzer für Knuddels entwickelten Apps in MyChanneln
*[[/knuddelaccount]] - Detaillierte Erklärung der Funktion

[[Kategorie:User_App]]

Limits

2019-08-08T08:38:46Z

Tom Unterwegs: auch zu Kategorie "UserApp-Entwicklung" hinzugefügt

== Allgemeines ==
Innerhalb des Chats gibt es einige (technische) Begrenzungen. Diese dienen unter Anderem der Vermeidung von [[Spam]] oder Missbrauch der Dienste. Eine der bekanntesten Limits betrifft wohl die Anzahl der Smileys pro Chatnachricht.

== Limitierungen ==

=== Chat allgemein ===
==== Nachrichten ====
[[/m|Postfach]]-Nachricht: 2.000 Zeichen

Öffentliche Nachricht: 1.000 Zeichen

Private Nachricht: 2.000 Zeichen

Zeilenumbrüche pro Nachricht: 4

=== User App Entwicklung ===
Für die Entwicklung und den Betrieb einer [[User App]] gelten einige besondere Beschränkungen. Dies ist notwendig, da pro Server-Instanz mehrere User Apps laufen. Durch die Beschränkungen kann sichergestellt werden, dass keine User App übermäßig hohe Ressourcen beansprucht.

Um eine Abschaltung oder Einschränkung der User App zu verhindern, sollte auf eine Einhaltung der Limits geachtet werden.

In Einzelfällen können, für besonders große/aktive [[Channel]], bestimmte Beschränkungen durch das [[Knuddelsteam]] manuell angepasst werden. Hierzu bedarf es einer Kontaktaufnahme durch den Channelbesitzer.

==== Externe Kommunikation ====
Alle hier genannten Daten gelten inklusive der Header-Daten.

Request size Limit: 10kB

Response size Limit: 50kB

Maximale Anzahl gleichzeitige Requests: 50

Daten-Limit: 50MB pro 10min

Request-Limit: 100 Requests pro 10min

==== Knuddel-Transfer-Reason ====
Maximale Länge für displayReasonText: 2000 Zeichen

==== Persistence ====
Maximale Länge: 102.400 Zeichen

==== Server zu UI | UI zu Server ====
Maximale Länge: 10.000 Zeichen

==== Nachrichten ====

Öffentliche Nachrichten: 30 in 15s 
Private Nachrichten: 45 in 15s 
AppInstance.sendAppEvent(): 50 in 5s 

[[Kategorie:User App]] [[Kategorie:UserApp-Entwicklung]] [[Kategorie:Begriffserklärung]]

UserApp-Entwicklung/Tutorials

2019-08-08T08:32:23Z

Tom Unterwegs:

Hier ist eine Sammlung aller Tutorials zur UserApp-Entwicklung.

== Für Anfänger ==
Lerne Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Einstieg]]
* [[UserApp-Entwicklung/Tutorials/HTML-UI|HTML-UI (grafische Oberfläche)]]
* [[UserApp-Entwicklung/Tutorials/UserApps_teilen|UserApps installieren und freigeben]]
* [[UserApp-Entwicklung/Tutorials/Newsletter-Versand|Newsletter-Versand]]
* [[UserApp-Entwicklung/Tutorials/AppBot-Profilbild|AppBot-Profilbild]]
* [[UserApp-Entwicklung/Tutorials/Knuddelaccount|Knuddelaccount]]

== Für Fortgeschrittene ==

''Es gibt leider noch keine Tutorials für Fortgeschrittene.''

Du kannst dich auf Discord an fortgeschrittene UserApp-Entwickler wenden. Den Link zum Discord-Channel findest du unter '''/apps developer'''.

== Weitere Tutorials ==

* [[User_Apps/Tutorial|Hallo Welt]]

== Meta ==

Tutorial über das Schreiben von UserApp-Tutorials: [[UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta|UserApp-Tutorials-Meta]]

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials/AppBot-Profilbild

2019-07-23T09:28:12Z

Tom Unterwegs: kleine Verbesserungen

== Einführung ==

Wenn du mit deinem [[UserApp-Entwicklung/Doku/AppBot|AppBot]] [https://developer.knuddels.de/docs/classes/User.html#method_sendPrivateMessage Privatnachrichten] an deine Besucher schickst, möchtest du wahrscheinlich, dass dein AppBot ein eigenes Profilbild hat. Das ist auch möglich!

== Bild erstellen ==

Im Gegensatz zu Profilbildern normaler Nutzer muss auf dem Profilbild eines AppBots keine reale Person abgebildet sein (auf sonstigen Profilbildern muss der Besitzer abgebildet sein). Ansonsten gelten hier aber [[Allgemeine_Geschäftsbedingungen/Fotos|die selben Regeln wie für Profilbilder normaler Nutzer]].

== Passwort für den AppBot ==

Du weißt das Passwort deines AppBots zunächst nicht. Allerdings kannst du es neu setzen, da der AppBot mit der selben E-Mail-Adresse registriert ist wie dein Hauptnick. Geh also auf [https://www.knuddels.de www.knuddels.de], klicke auf ''Passwort vergessen'', gib den Nick deines AppBots ein und bestätige. Jetzt solltest du eine E-Mail erhalten und kannst ein neues Passwort wählen.

== Profilbild hochladen ==

Logge dich jetzt in der Fotogalerie unter [https://photo.knuddels.de/photos-login.html photo.knuddels.de] mit dem Nick und dem Passwort deines AppBots ein und lade dort das Bild hoch.

Fertig!

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta

2019-07-23T08:29:09Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

Tipps und Konventionen für das Schreiben von Tutorials zu UserApps.

== Erstellen des Wiki-Artikels ==

* [[Knuddels-Wiki:Tutorial01|Registriere dich zunächst im Wiki und logge dich ein.]] 
* [[Knuddels-Wiki:Tutorial03|Hier wird erklärt, wie du neue Artikel erstellst.]]

Wichtig: Der '''Titel''' deines Tutorials sollte mit '''UserApp-Entwicklung/Tutorials/''' beginnen!
Artikel, die kein Tutorial sind, sondern lediglich etwas dokumentieren, sollten mit '''UserApp-Entwicklung/Doku/''' beginnen.

Beispiele:
* Tutorial: [[UserApp-Entwicklung/Tutorials/HTML-UI]]
* Doku: [[UserApp-Entwicklung/Doku/AppId]]

== Code-Beispiele einfügen ==

=== <pre>-Tag ===

Code ist auf dem Knuddels-Wiki am besten in einem '''<pre>'''-Tag aufgehoben. 
Allerdings gibt es auch hier noch Probleme mit der Formatierung, zum Beispiel werden Whitespaces am Anfang der Zeile entfernt.

=== Whitespaces ===

Die Whitespaces am Anfang der Zeile (oder einfach alle) können durch '''&nbsp;''' (geschütztes Leerzeichen) ersetzt werden, damit sie trotzdem angezeigt werden. 

In Python sähe das so aus:
<pre>
>>> s = """... hier der Quellcode ...
... noch mehr Quellcode ...
..."""
>>> print(s.replace(" ", "&nbsp;")
</pre>

=== HTML-Quellcode ===

Bei Verwendung von XML-Tags sollte der Quellcode außerdem zuerst einmal durch dieses Tool "escaped" werden: https://mothereff.in/html-entities

=== Syntax-Highlighting ===

Das Knuddels-Wiki hat derzeit leider kein Syntax-Highlighting.

=== Quellcode sichern ===

Das Ergebnis ist durch diese Änderungen im Bearbeitungsfeld im Wiki nicht mehr gut lesbar. Um für spätere Änderungen noch die originale Version des Code-Beispiels zu erhalten, kann es in einem XML-Kommentar gesichert werden:

<pre>

<pre>
hier die "escapte" Version
</pre>
</pre>

=== Zusammenfassung ===

# Code in einem Kommentar '''''' sichern
# Falls XML-Tags im Code vorkommen, durch dieses Tool jagen: https://mothereff.in/html-entities
# alle Leerzeichen (eigentlich nur am Anfang jeder Zeile) durch '''&nbsp;''' ersetzen
# das Ergebnis in einem '''<pre></pre>'''-Tag einfügen

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials/AppBot-Profilbild

2019-07-23T08:28:39Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

== Einführung ==

Das Profilbild deines [[UserApp-Entwicklung/Doku/AppBot|AppBots]] sieht standardmäßig ziemlich unoriginell aus. Aber wenn du beispielsweise deinen AppBot Besuchern [https://developer.knuddels.de/docs/classes/User.html#method_sendPrivateMessage Privatnachrichten] schicken lässt, möchtest du wahrscheinlich, dass dein AppBot ein eigenes Profilbild hat. Das ist auch möglich!

== Bild erstellen ==

Im Gegensatz zu Profilbildern normaler Nutzer muss auf dem Profilbild eines AppBots keine Person abgebildet sein. Ansonsten gelten hier aber [https://www.knuddels.de/info/foto-rules.html die selben Regeln wie für Profilbilder normaler Nutzer].

== Passwort für den AppBot ==

Du weißt das Passwort deines AppBots zunächst nicht. Allerdings kannst du es neu setzen, da der AppBot mit der selben E-Mail-Adresse registriert ist wie dein Hauptnick. Geh also auf [https://www.knuddels.de www.knuddels.de], klicke auf ''Passwort vergessen'', gib den Nick deines AppBots ein und bestätige. Jetzt solltest du eine E-Mail erhalten und kannst ein neues Passwort wählen.

== Profilbild hochladen ==

Das Bild muss im '''.jpg'''- oder '''.gif'''-Format vorliegen, damit du es hochladen kannst.

Logge dich jetzt in der Fotogalerie unter [https://photo.knuddels.de/photos-login.html photo.knuddels.de] mit dem Nick und dem Passwort deines AppBots ein und lade dort das Bild hoch.

Fertig!

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials/UserApps teilen

2019-07-23T08:28:25Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

= UserApps installieren und freigeben =
=== Eine UserApp installieren ===

Um eine UserApp bei sich im Channel zu installieren, benötigt man die dazugehörige [[UserApp-Entwicklung/Doku/AppId|AppId]], diese erhält man in der Regel vom [[UserApp-Entwicklung/Doku/AppDeveloper|AppDeveloper]].

es gibt nun 2 Möglichkeiten eine App zu installieren:
===== Installation per Chat-Befehl =====
Um eine App zu installieren benötigt man folgenden Befehl: 
 
     <function>/apps install [knuddelsDEV.]<FTP-Benutzername>.<Ordner-Name></function> 
 
     <FUNCTION>knuddelsDEV</FUNCTION> ist eine optionale Angabe und nicht erforderlich 
     <FUNCTION><FTP-Benutzername></FUNCTION> ist der Benutzername für den FTP-Server, des AppEntwicklers, dessen App ihr installieren wollt. 
     <FUNCTION><Ordner-Name></FUNCTION> Ist der Name des Ordners der App, welche installiert werden soll. 
     Weitere informationen sind unter [[UserApp-Entwicklung/Doku/AppId|AppId]] zu finden.


===== Installation per HTML-UI =====

- folgt -

=== Eigene UserApp für andere Nutzer freigeben ===
Die Installationsrechte für die App werden über den Eintrag [[UserApp-Entwicklung/Doku/mayBeInstalledBy|mayBeInstalledBy]] in der Datei [[UserApp-Entwicklung/Doku/app.config|app.config]] geregelt. 

Möchten wir die App nun für andere Freigeben, müssen wir den Eintrag entsprechend ändern. Hier gibt es nun verschiedene Möglichkeiten der Freigabe:
{| class="wikitable"
|-
! Eintrag !! Auswirkung
|-
| mayBeInstalledBy.1 = *.* || Jeder Nutzer kann deine App installieren. Hierbei spielt keine Rolle ob auf dem DEV-Server oder dem Live-Server.
|-
| mayBeInstalledBy.1 = *.knuddelsDE || Jeder Nutzer kann kann deine App auf dem LIVE-Server installieren
|-
| mayBeInstalledBy.1 = *.knuddelsDEV || Jeder Nutzer kann kann deine App auf dem DEV-Server installieren
|-
| mayBeInstalledBy.1 = rmpg.* || Nur '''rmpg''' kann die App installieren. Hierbei spielt keine Rolle ob auf dem DEV-Server oder dem Live-Server.
|-
| mayBeInstalledBy.1 = rmpg.knuddelsDE mayBeInstalledBy.2 = [[James]].knuddelsDEV || '''rmpg''' kann die App auf dem LIVE-Server installieren, James hingegen nur auf dem DEV-Server.
|-
|}

Für die Installation der App wird noch die [[UserApp-Entwicklung/Doku/AppId|AppId]] benötigt.

Um die App dann nun zu installieren kann man entweder den Chatbefehl dafür eingeben<PRE>/apps install APPID</PRE>, oder über /apps in der UI auf '''App installieren''' klicken und dort die [[UserApp-Entwicklung/Doku/AppId|AppId]] eingeben.

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials/HTML-UI

2019-07-23T08:28:02Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

== Einleitung ==

In diesem Tutorial lernst du, wie du eine grafische Oberfläche in deinen UserApps verwenden kannst, um z.B. grafische Spiele für Knuddels zu programmieren. Du solltest schon einmal etwas mit HTML und JavaScript gemacht haben, um folgen zu können.

== Der Server ==

Der Server-Code deiner UserApp steht in der '''main.js'''. Wenn du nur in der '''main.js''' programmierst, läuft der ganze Code deiner UserApp ausschließlich auf den Servern von Knuddels. 
Damit kann man zwar schon viel machen, aber für mehr Interaktionsmöglichkeiten brauchst du eine grafische Oberfläche.

== Der Client ==

Der Code für den Client befindet sich im '''www'''-Unterordner deiner UserApp.
Den Einstieg bildet eine HTML-Datei, die du nennen kannst, wie du willst. Dort kannst du dann auch JavaScript-Dateien einbinden, um Code auf dem Gerät deines Besuchers auszuführen.

Die Struktur deiner UserApp könnte dann so aussehen:


<pre>
KnuddelJumper/
    www/
        game.html
        game.js
        player.png
        enemy.png
    main.js
</pre>

Die HTML-Datei kann dann z.B. so eine Struktur haben:


<pre>
<html>
    <head>
        <script src="game.js"/>
    </head>
    <body>
        <button>Hier klicken</button>
    </body>
</html>
</pre>

Während der Entwicklung wirst du allerdings oft Änderungen an deinem Script machen. Da Knuddels dein Script zwischenspeichert, wenn du es einfach mit dem '''<script>'''-Tag einbindest, werden deine Änderungen oft nicht übernommen. Um Knuddels dazu zu zwingen immer die aktuellste Version deines Scripts zu laden, musst du das Knuddels stattdessen mit [https://developer.knuddels.de/docs/classes/Client.html#method_includeJS Client.includeJS()] mitteilen:


<pre>
<html>
    <head>
        <script>
            Client.includeJS("game.js");
        </script>
    </head>
    <body>
        <button>Hier klicken</button>
    </body>
</html>
</pre>

== Kommunikation zwischen Server und Client ==

=== AppContent senden ===

Die HTML-Datei und der restliche Inhalt des '''www'''-Unterordners wird [https://developer.knuddels.de/docs/classes/AppContent.html AppContent] genannt. Das ist die grafische Oberfäche deiner UserApp. 
Der AppContent erscheint aber nicht automatisch bei dem Besucher deines Channels! Du musst den AppContent erst an den Besucher (den Client) senden.
In der Regel macht man das direkt wenn der Besucher den Channel betritt, also in '''App.onUserJoined''':


<pre>
var App = (new function() {

    let htmlFile = new HTMLFile("game.html");
    let appContent = AppContent.overlayContent(htmlFile, 640, 480);

    this.onUserJoined = function(user) {
        user.sendAppContent(appContent);
    }
}());
</pre>

Der [https://developer.knuddels.de/docs/classes/AppContent.html AppContent] wird so nur einmal von der App geladen und dann einfach an jeden Besucher mit [https://developer.knuddels.de/docs/classes/User.html#method_sendAppContent User.sendAppContent()] gesendet. 

Hinweis: [https://developer.knuddels.de/docs/classes/HTMLFile.html new HTMLFile()] sucht die angegebene Datei im '''www'''-Unterordner.

'''Damit ist dieses Tutorial eigentlich fertig:''' Deine Besucher sehen jetzt eine grafische Oberfläche, wenn sie deinen Channel betreten und du kannst wie auf Webseiten Scripts einbinden. Ein paar wichtige Hinweise kommen aber noch! 

 

Der AppContent kann verschiedene '''ViewModes''' annehmen, je nachdem welche Methode du verwendest:

* '''Overlay''' mit [https://developer.knuddels.de/docs/classes/AppContent.html#method_overlayContent AppContent.overlayContent()]
* '''Popup''' mit [https://developer.knuddels.de/docs/classes/AppContent.html#method_popupContent AppContent.popupContent()]
* '''Headerbar''' mit [https://developer.knuddels.de/docs/classes/AppContent.html#method_headerbarContent AppContent.headerbarContent()]

 
'''Tipp:''' Nicht alle Geräte können jeden '''ViewMode''' anzeigen. Daher ist es gute Praxis, wenn du mit [https://developer.knuddels.de/docs/classes/User.html#method_canSendAppContent User.canSendAppContent()] entscheidest, welchen AppContent du sendest.
'''Beispiel:'''


<pre>
var App = (new function() {

    let htmlFile = new HTMLFile("game.html");
    let overlay = AppContent.overlayContent(htmlFile, 640, 480);
    let popup  = AppContent.popupContent(htmlFile, 640, 480);
    let headerbar = AppContent.headerbarContent(htmlFile, 480);

    this.onUserJoined = function(user) {

        if (user.canSendAppContent(overlay)) {
            user.sendAppContent(overlay);

        } else if (user.canSendAppContent(popup)) {
            user.sendAppContent(popup);

        } else if (user.canSendAppContent(headerbar)) {
            user.sendAppContent(headerbar);

        } else {
            user.sendPrivateMessage("Die UserApp kann auf deinem Gerät leider nicht angezeigt werden.");
        }
    }
}());
</pre>

=== Events senden ===

Dein Code auf dem Server und dein Code auf dem Client laufen jetzt praktisch unabhängig voneinander. Meistens ist es aber hilfreich, wenn Server und Client miteinander kommunizieren können.

==== Client → Server ====

''' Beispiel:''' Wenn der Nutzer auf der grafischen Oberfläche einen Knopf drückt, soll der AppBot eine öffentliche Nachricht in den Channel schreiben. 
Du kannst aber nur von der '''main.js''' (also vom Server aus) Chat-Nachrichten schicken. [https://developer.knuddels.de/docs/classes/BotUser.html#method_sendPublicMessage BotUser.sendPublicMessage()] funktioniert im Client nicht. 

Der Client muss also dem Server mitteilen, dass der Nutzer einen Button gedrückt hat. Das ist mit [https://developer.knuddels.de/docs/classes/Client.html#method_sendEvent Client.sendEvent()] möglich:

<pre>
Client.sendEvent("buttonPressed", {});
</pre>

Dabei können noch zusätzliche Daten in Form eines JavaScript-Objekts mitgegeben werden.

Der Server kann dann in der '''main.js''' in [https://developer.knuddels.de/docs/classes/App.html#method_onEventReceived App.onEventReceived()] reagieren:


<pre>
var App = (new function() {
    
    //...
    
    this.onEventReceived = function(user, type, data, appContentSession) {
        
        if (type == "buttonPressed") {
            let bot = KnuddelsServer.getDefaultBotUser();
            bot.sendPublicMessage(user.getProfileLink()+" hat den Knopf gedrückt!");
        }
    }
}());
</pre>

==== Server → alle Clients ====

''' Beispiel:''' In der '''main.js''' wird eine zufällige Zahl generiert. Diese Zahl soll an alle Besucher des Channels geschickt werden, sodass diese dann in der HTML-UI angezeigt werden kann. 

Mit [https://developer.knuddels.de/docs/classes/AppContent.html#method_sendEvent AppContent.sendEvent()] kannst du ein Event an alle Besucher schicken, bei denen dieser AppContent aktiv ist:

<pre>
let randomNumber = Math.floor(10 * Math.random());
appContent.sendEvent("showNumber", {randomNumber: number});
</pre>

Im Client kannst du mit [https://developer.knuddels.de/docs/classes/Client.html#method_addEventListener Client.addEventListener()] auf die Events vom Server reagieren:


<pre>
Client.addEventListener("showNumber", function(event) {
        
        let number = event.data.number;
        
        document.open();
        document.write("Die magische Zahl heißt: "+number);
        document.close()
});
</pre>

==== Server → ein bestimmter Client ====

'''Beispiel:''' Du wählst einen Besucher zufällig aus und möchtest, dass sich bei diesem Besucher die Farbe der HTML-UI ändert. 

Dazu musst du vom Server aus (also in der '''main.js''') diesem Client ein Event senden. 
Du kannst aber nicht einfach ''User.sendEvent()'' aufrufen (diesen Befehl gibt es nicht). Eine UserApp kann nämlich verschiedene '''ViewModes''' auf einmal verwenden (sogenannte '''AppContentSessions'''). Du musst der API also sagen, an welche '''AppContentSession''' du das Event senden möchtest. 

Wenn du weißt, welchen '''ViewMode''' der Besucher verwendet (z.B. weil du sowieso immer nur ein Popup sendest), kannst du einfach mit dem Befehl [https://developer.knuddels.de/docs/classes/User.html#method_getAppContentSession User.getAppContentSession] die AppContentSession erhalten und dann das Event senden. '''Beispiel:'''

<pre>
let appContentSession = user.getAppContentSession(AppViewMode.Popup);
appContentSession.sendEvent("changeColor", {red:255, green:0, blue:255});
</pre>

 

Wenn dein Client allerdings gleichzeitig mehrere aktive '''AppContentSessions''' haben könnte (z.B. eine Headerbar und ein Popup), kannst du eine Liste aller aktiven AppContentSessions eines Besuchers mit [https://developer.knuddels.de/docs/classes/User.html#method_getAppContentSessions User.getAppContentSessions()] erhalten. '''Beispiel:'''


<pre>
let appContentSessions = user.getAppContentSessions();

for (let i = 0; i < appContentSessions.length; i++) {
    let appContentSession = appContentSessions[i];
    appContentSession.sendEvent("changeColor", {red:255, green:0, blue:255});
}
</pre>

Auch hier kannst du im Client wieder mit [https://developer.knuddels.de/docs/classes/Client.html#method_addEventListener Client.addEventListener()] auf die Events reagieren.

==== Limits ====

Für die Daten, die du mit den Events zwischen Client und Server sendest, gibt es gewisse [[Limits]]. Diese Limits werden [[Limits|hier]] beschrieben.

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials/Beginner

2019-07-23T08:27:25Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

== Einleitung ==
In diesem Tutorial lernst du Schritt für Schritt, deine erste UserApp zu programmieren. 
Hier geht es darum, erstmal alles zum Laufen zu bringen und ein paar Basics zu vermitteln, sodass ab dann selbstständig weiterentwickelt werden kann.

== Bevor es losgeht ==

=== Werde Entwickler ===

Stelle sicher, dass du ein Entwickler bist. Gib dazu '''/apps developer''' im Chat ein und erfülle die Kriterien, falls du das noch nicht getan hast.

=== Verwende die Desktop-App ===

Wir empfehlen dir stark, zum Entwickeln die Desktop-App auf deinem Computer zu verwenden. Du kannst die App [https://www.knuddels.de/stapp-win hier herunterladen]. 

== Die erste UserApp ==

=== Entwicklungs-Server ===
Das Entwickeln beginnt auf dem Entwicklungs-Server. Gib '''/apps developer''' ein und wähle den Punkt '''Login auf Entwicklungs-Server''' aus. Jetzt sollte eine Desktop-Verknüpfung für den Login auf dem Entwicklungs-Server angelegt worden sein. 
Wenn du Knuddels über diese Verknüpfung startest, landest du nach dem Login auf dem Entwicklungs-Server. Hier kannst du später in Ruhe an deiner UserApp tüfteln, bevor du deine Änderungen auf dem Live-Server hochlädst. 

Logge dich jetzt mit den Zugangsdaten auf dem Entwicklungsserver ein, die dir James gesendet hat ('''Entwickler-Nick''' und '''Entwickler-Passwort''').

Tipp: Du kannst die Zugangsdaten aus James' Nachricht mit Shift+Rechtsklick in das Chat-Fenster kopieren.

=== MyChannel ===

Nach dem Einloggen sollte sich automatisch das [[MyChannel]]-Edit Fenster öffnen. Ansonsten gib '''/mychannel''' ein. 
Du legst dir jetzt einen eigenen Channel an, in dem du gleich deine erste UserApp installieren wirst. Eine Info zu den Einstellungen erhältst du durch Klicken auf den Titel des jeweiligen Feldes. Außer über deinen Channel-Namen musst du dir aber erstmal keine Gedanken machen (du kannst dieses Fenster jederzeit wieder mit '''/mychannel''' öffnen). Drücke anschließend auf '''Speichern''' und '''Schließen''' und betritt deinen MyChannel mit '''/go <dein eigener Channel-Name>'''.

=== Installation der UserApp ===

Für dieses Tutorial haben wir dir schon Dateien für eine Beispiel-UserApp namens "HeyThere" auf den Server geladen. Installiere diese UserApp in deinem MyChannel mit '''/apps install HeyThere'''. Du kannst die UserApp später wieder aus deinem Channel löschen. 

Es müsste sich nun automatisch das Konfigurationsfenster für die UserApp geöffnet haben. Ansonsten öffne es selbst mit '''/apps''' und klicke auf den Namen der UserApp ("HeyThere").
Hinweis: Durch einen Bug kann es sein, dass das Fenster auf dem Entwicklungs-Server nichts anzeigt. Schließe es einfach und öffne es gleich nochmal mit '''/apps'''. Wir hoffen, diesen Bug bald beheben zu können.

Im Menüpunkt "AppBot" kannst du einen [[UserApp-Entwicklung/Doku/AppBot|AppBot]] erstellen und an deine UserApp binden. Ein AppBot ist ein bisschen wie [[James|Butler James]], nur eben für deine UserApp in deinem Channel. Drücke hierzu auf "hinzufügen" → "Nick anlegen", denk dir einen Nicknamen aus und bestätige.

Starte jetzt deine erste UserApp.
Falls sich kein entsprechendes Fenster öffnet, starte die UserApp selbst, indem du im App-Menü auf '''aktivieren''' klickst.
Verlasse nun deinen Channel (indem du in einen anderen Channel gehst) und betritt ihn dann wieder (z.B. mit '''/go <dein eigener Channel-Name>'''). Dein AppBot sollte dich jetzt begrüßen! 

Um mit dem Entwickeln zu starten, mach mit dem nächsten Schritt weiter (FTP-Setup). Du kannst auch schon mal einen Blick in die [http://developer.knuddels.de/docs/ UserApps-API-Dokumentation] werfen. 

Bestimmt wird es auch mal eine Stelle geben, an der du nicht weiter weißt. Zögere nicht, [http://forum.knuddels.de/ubbthreads.php?ubb=postlist&Board=272&page=1 im Forum] Fragen zu stellen, wenn dir etwas nicht klar ist! Die anderen Entwickler sind freundlich, gehen fair miteinander um und helfen sich gerne gegenseitig.

== FTP-Setup ==

Du benötigst für die UserApp-Entwicklung ein FTP-Programm, um die Dateien für deine UserApp auf die Server von Knuddels hochzuladen.

=== Was ist eigentlich FTP? ===

FTP (File Transfer Protocol) ist ein Protokoll, mit dem Daten zwischen zwei Computern im Internet ausgetauscht werden können. 
Zum Glück gibt es ganz einfache Programme, die hinter den Kulissen dieses Protokoll sprechen, sodass du die Dateien mit wenigen Klicks hochladen kannst.

=== Einrichtung des FTP-Zugangs ===

Du wirst die Dateien deiner UserApp auf zwei verschiedenen Servern hochladen:
# auf dem '''Entwicklungs-Server''', unter der URL '''devappupload.knuddels.de'''
# auf dem '''Live-Server''', unter der URL '''appupload.knuddels.de'''

Für beide Server musst du dir jeweils eine Verbindung einrichten. Dafür brauchst du ein FTP-Programm.
Schau dir dazu [https://bitbucket.org/knuddels/user-apps/wiki/Bootstrap/FTP-Setup diese Erklärung] an. 
'''Diese Erklärung zeigt allerdings nur die Verbindung zum Live-Server''' - verwende für den Entwicklungs-Server stattdessen die URL '''devappupload.knuddels.de'''. 

Als Zugangsdaten verwendest du die Zugangsdaten, die James dir geschickt hat ('''FTP-Nutzer''' und '''FTP-Passwort''').

Tipp: Du kannst die Zugangsdaten aus James' Nachricht mit Shift+Rechtsklick in das Chat-Fenster kopieren.
Unter '''/apps developer''' kannst du sie außerdem erneut anfordern.

Achte außerdem jeweils darauf, eine '''unverschlüsselte Verbindung''' zu wählen.

== Beispiel-Code anschauen ==

Wenn du weißt, wie du Dateien über den FTP-Zugang von dem Server herunter- und hochladen kannst, kannst du dir jetzt anschauen, wie eine UserApp aufgebaut ist. 

Logge dich in deinem FTP-Programm auf dem Entwicklungs-Server ein, navigiere in den Ordner '''ftp → HeyThere''' und lade dort die Datei '''main.js''' herunter. Du kannst diese Datei jetzt anschauen, verändern und dann wieder dort hochladen. So verstehst du, wie alles funktioniert. 

Die '''main.js''' kannst du sogar im normalen Texteditor anschauen und bearbeiten. 
Empfehlenswert ist das aber nicht.
*Auf Windows kannst du dir (zum Beispiel) [http://notepad-plus-plus.org/ Notepad++] herunterladen.
* Auf macOS kannst du dir (zum Beispiel) [https://itunes.apple.com/de/app/textwrangler/id404010395?mt=12 Textwrangler] herunterladen.
Diese Programme können dir das Entwickeln erleichtern. (Natürlich kannst du auch eine IDE verwenden, wenn du dich damit auskennst.) 

Schau dir den Code jetzt an und nimm einige Veränderungen vor.

Idee: Lass deinen AppBot Besucher abhängig von ihrem Geschlecht begrüßen! Zum Beispiel männliche Besucher mit "Hey Prinz <Nickname>" und weibliche Besucher mit "Hey Prinzessin <Nickname>". Findest du heraus, wie das geht?

→ Jetzt ist ein guter Zeitpunkt, die [https://developer.knuddels.de/docs/ API-Dokumentation] anzuschauen.
Der Aufbau der '''main.js''' wird [https://bitbucket.org/knuddels/user-apps/wiki/Bootstrap/App-Erstellen hier] erklärt.

Gehe danach folgendermaßen vor:
# Verändere die Datei und speichere sie.
# Lade die Datei auf den FTP-Server hoch (ersetze die alte '''main.js''').
# Öffne das App-Menü in deinem Channel mit '''/apps''' und drücke auf '''update/restart'''. Deine App fährt herunter und startet nach wenigen Sekunden erneut - mit deinem neuen Code.

Im nächsten Schritt wird gezeigt, wie man Besucher abhängig von ihrem Geschlecht begrüßen kann.

== Begrüße Besucher abhängig von ihrem Geschlecht ==

So kannst du neuen Besuchern eine Begrüßungsnachricht abhängig von ihrem Geschlecht schicken:

'''main.js'''


<pre>
var App = (new function() {

    this.onUserJoined = function(user) {  // diese Funktion wird aufgerufen, wenn ein Nutzer den Channel betritt

        let gender = user.getGender();
        let nick  = user.getNick();
        let title;

        if (gender == Gender.Male) {
            title = "Prinz " + nick;
        } else if (gender == Gender.Female) {
            title = "Prinzessin " + nick;
        } else {  // der Nutzer hat sich nicht als männlich oder weiblich ausgegeben
            title = nick;
        }

        let message = "Hey " + title + ", willkommen im Channel! Du bist " + user.getAge() + " Jahre alt.";
        user.sendPrivateMessage(message);  // der AppBot sendet eine private Nachricht an den Nutzer
    }
}());
</pre>

Schaffst du es außerdem, die Besucher sowohl abhängig von ihrem Alter, als auch von ihrem Geschlecht zu begrüßen?
→ Begrüße Besucher...
* unter 18 Jahren mit: '''"Hallo Junge <Nickname>"''' bzw. '''"Hallo Mädchen <Nickname>"'''
* zwischen 18 und 60 Jahren mit: '''"Hallo Herr <Nickname>"''' bzw. '''"Hallo Frau <Nickname>"'''
* über 60 Jahren mit: '''"Hallo Opa <Nickname>"''' bzw. '''"Hallo Oma <Nickname>"'''

Schau in die [https://developer.knuddels.de/docs/ UserApps-API-Dokumentation], wenn du eine Funktion suchst.
Den fertigen Code kannst du dir hier herunterladen: [https://bitbucket.org/knuddels/user-apps/downloads/Beispielcode%20HeyThere%20-%20Stufe%202%20-%20Erweiterung.zip Begrüßung nach Alter und Geschlecht] 

Im nächsten Schritt lernst du, wie Besucher '''Knuddel''' an deinen AppBot transferieren können!

== Knuddel überweisen ==

Nutzer können Knuddel an deinen AppBot überweisen. Diese Knuddel kannst du dir dann später auf deinen eigenen Nick überweisen lassen. Hier lernst du, wie du das in deiner UserApp machen kannst.

Der AppBot soll jeden neuen Nutzer nach einem Knuddel fragen. Wenn er diesen bekommt, bedankt er sich bei dem Nutzer.

Auf dem Entwicklungs-Server hat dein Nick so viele Knuddel, dass du das einfach testen kannst.

'''main.js'''
<pre>
var App = (new function() {

    this.onUserJoined = function(user) {
        var appBotNick = KnuddelsServer.getDefaultBotUser().getNick();
        var message = "Gibst du mir _°BB°°>_heinen Knuddel|/appknuddel " + appBotNick.escapeKCode() + "<°°°_?";
        user.sendPrivateMessage(message);
    }

    this.onKnuddelReceived = function(sender, receiver, knuddelAmount, transferReason) {
        sender.sendPrivateMessage("Danke, " + sender.getNick() + "!");
    }
}());
</pre>

=== Erklärung: Was ist KCode? ===

In '''App.onUserJoined''' wird dem Nutzer eine Nachricht mit seltsamen Zeichen gesendet:

"Gibst du mir _°BB°°>_heinen Knuddel|/appknuddel " + appBotNick.escapeKCode() + "<°°°_?"

Das ist [[Formatierungen|KCode]]. Dieser Code wird vor dem Anzeigen umgewandelt, sodass die Nutzer einen Link präsentiert bekommen, auf dessen Klick hin ein Befehl ausgeführt wird: Hier ist dieser Befehl '''/appknuddel <Nickname des AppBots>'''. Mit dem Klicken auf den Link überweist der Nutzer also einen Knuddel an den AppBot.

'''appBotNick.escapeKCode()''' dient dazu, dass der Befehl auch bei Sonderzeichen im Nicknamen deines AppBots richtig ausgeführt wird.

[[Formatierungen|→ Hier kannst du dir anschauen, wie KCode funktioniert.]]

Idee für wahre Kapitalisten: Du kannst den Besucher deines Channels vielleicht dazu bringen, dem AppBot einen Knuddel zu schenken, wenn der AppBot dem Besucher nach einiger Zeit eine traurige Nachricht schreibt, falls er bis dahin keinen Knuddel von dem Besucher erhalten hat.

Eine mögliche Lösung dieses Problems kannst du dir hier anschauen: [https://bitbucket.org/knuddels/user-apps/downloads/Beispielcode%20HeyThere%20-%20Stufe%203%20-%20Erweiterung.zip Download Code-Beispiel (Traurige Nachricht vom AppBot)] 

Im nächsten Schritt lernst du, wie du dauerhaft Daten über deine Besucher speichern kannst.

== UserPersistence: Nutzerdaten speichern ==

Wenn du dir beispielsweise dauerhaft merken willst, wie viele Knuddel ein Nutzer jeweils schon deinem AppBot überwiesen hat, brauchst du eine Möglichkeit, zu jedem Nutzer eine Zahl zu speichern. 

Allerdings kannst du nicht einfach eine Variable in deinem Code haben, worüber du alles speicherst - das wäre nämlich mit jedem Neustart der App wieder weg.

In der [https://developer.knuddels.de/docs/ UserApps-API] gibt es genau dafür das Objekt [https://developer.knuddels.de/docs/classes/UserPersistence.html UserPersistence].

'''main.js'''
<pre>
var App = (new function() {

    this.onUserJoined = function(user) {

        let userPersistence = user.getPersistence();
        let userSpending = userPersistence.getNumber("spending", 0);

        if (userSpending > 10) {
            user.sendPrivateMessage("Willkommen, gütiger Spender!");
        }

        var appBotNick = KnuddelsServer.getDefaultBotUser().getNick();
        var message = "Gibst du mir _°BB°°>_heinen Knuddel|/appknuddel " + appBotNick.escapeKCode() + "<°°°_?";
        user.sendPrivateMessage(message);
    }

    this.onKnuddelReceived = function(sender, receiver, knuddelAmount, transferReason) {
        sender.sendPrivateMessage("Danke, " + sender.getNick() + "!");

        let userPersistence = sender.getPersistence();
        userPersistence.addNumber("spending", knuddelAmount.asNumber());
    }
}());
</pre>

Die App merkt sich nun, wie viele Knuddel deine Besucher bereits eingezahlt haben. Besonders gönnerische Besucher begrüßt er ehrerbietig!

== Dein Fortschitt ==

'''Du bist schon weit gekommen!'''

* Du hast gelernt, wie man sich auf dem Entwicklungs-Server anmeldet und eine App installiert.
* Du hast dich mit FTP vertraut gemacht und kannst deine Dateien jetzt einfach an den Knuddels-Server senden.
* Du weißt jetzt, wie man auf verschiedene Events in deinem Channel reagiert.
* Du bist mit der Überweisung von Knuddel an deinen AppBot vertraut.
* Du kannst Daten über deine Besucher dauerhaft speichern.

Jetzt kannst du deine UserApp mal veröffentlichen! Dazu musst du deine UserApp per FTP auf dem Live-Server hochladen - so wie schon vorher auf dem Entwicklungs-Server. Melde dich dann ganz normal bei Knuddels an und installiere deine UserApp mit '''/apps install <UserApp-Name>''' in deinem MyChannel. 

Und wenn du jetzt noch deinen MyChannel unter '''/mychannel''' veröffentlichst, können auch andere Nutzer zufällig auf deinen MyChannel stoßen. 

== Wie geht's weiter? ==

Vielleicht hast du Lust, ein grafisches Spiel zu programmieren? Oder ein textbasiertes RPG? 
Ab jetzt bist du dir selbst überlassen - und kannst dich natürlich jederzeit an die Community wenden. 
Auf dem Entwickler-Portal [https://developer.knuddels.de/ developer.knuddels.de] findest du das meiste im Zusammenhang mit UserApps.

[[UserApp-Entwicklung|→ Übersicht: UserApp-Entwicklung]]

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung/Tutorials

2019-07-23T08:26:23Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

Hier ist eine Sammlung aller Tutorials zur UserApp-Entwicklung.

== Für Anfänger ==
Lerne Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Einstieg]]
* [[UserApp-Entwicklung/Tutorials/HTML-UI|HTML-UI (grafische Oberfläche)]]
* [[UserApp-Entwicklung/Tutorials/UserApps_teilen|UserApps installieren und freigeben]]
* [[UserApp-Entwicklung/Tutorials/Newsletter-Versand|Newsletter-Versand]]
* [[UserApp-Entwicklung/Tutorials/AppBot-Profilbild|AppBot-Profilbild]]

== Für Fortgeschrittene ==

''Es gibt leider noch keine Tutorials für Fortgeschrittene.''

Du kannst dich auf Discord an fortgeschrittene UserApp-Entwickler wenden. Den Link zum Discord-Channel findest du unter '''/apps developer'''.

== Weitere Tutorials ==

* [[User_Apps/Tutorial|Hallo Welt]]

== Meta ==

Tutorial über das Schreiben von UserApp-Tutorials: [[UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta|UserApp-Tutorials-Meta]]

[[Kategorie:UserApp-Entwicklung]]

UserApp-Entwicklung

2019-07-23T08:25:46Z

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

== Allgemeines ==

Hier findest du alles was du wissen musst, um deine eigene UserApp auf Knuddels zu programmieren. 
Wenn du noch nicht weißt, was eine UserApp ist, schau einfach hier: [[User_App|Was ist eine UserApp?]] 
Einen Überblick über alles im Zusammenhang mit UserApps (auch dieses Wiki) findest du auf dem Entwickler-Portal unter [https://developer.knuddels.de/ developer.knuddels.de].

== Tutorials https://knuddels-wiki.de/images/c/c9/Icon_-_Newbie.gif ==

Wenn du noch keine UserApp entwickelt hast, kannst du das [[UserApp-Entwicklung/Tutorials/Beginner|Beginner-Tutorial]] machen. Dort lernst du Schritt für Schritt, deine erste UserApp zu programmieren.
 
→ [[UserApp-Entwicklung/Tutorials|Hier ist die Übersicht über alle Tutorials.]]

== Wichtige Links ==

* [https://developer.knuddels.de/ developer.knuddels.de] - das Entwickler-Portal (Überblick über alles im Zusammenhang mit UserApps)
* [https://developer.knuddels.de/docs/ UserApps-API Docs]
* [https://www.knuddels.de/changelog Changelog]

== Andere UserApps-Entwickler ==

* Wir freuen uns, wenn sich neue Entwickler kurz [https://forum.knuddels.de/ubbthreads.php?ubb=showflat&Number=2704910 im Forum vorstellen]. Aber das ist natürlich kein Muss.
* Die Kommunikation findet über den Discord Server statt. Gib '''/apps developer''' ein und klicke auf den entsprechenden Link. [https://blog.knuddels.de/2018/07/31/kommunikation-zukuenftig-auf-discord/ → Blogeintrag dazu]
* Außerdem gibt es im [https://forum.knuddels.de/ubbthreads.php?ubb=cfrm&c=9 UserApps-Forum] viele Beiträge!

== Die UserApps-API https://knuddels-wiki.de/images/2/29/Quiz-Smiley.gif ==

Willst du mehr über die UserApps-API wissen? Schau mal hier rein:

* [[API|Was ist die UserApps-API?]]
* [https://developer.knuddels.de/docs/ UserApps-API Docs]

== Design & Grafik in UserApps https://knuddels-wiki.de/images/a/a0/Rose.gif ==

UserApps können natürlich auch Grafiken, Animationen und Sounds wiedergeben! Du kannst sogar ein 3D-Spiel als UserApp programmieren!
Mindestens kannst du aber mal '''KCode''' lernen, falls du das noch nicht getan hast.
Schau dir als Einstieg folgende Links an:

* Texte vom AppBot formatieren: [[Formatierungen]]
* Grafische Web-Oberfläche
** [[User_App:HTML-UI/Web|Einführung 1]]
** [https://bitbucket.org/knuddels/user-apps/wiki/HTML-UI/Web Einführung 2]
** [https://bitbucket.org/knuddels/user-apps/wiki/HTML-UI/Environment Besonderheiten der HTML-UI (Environment)]

== Technische Infos ==

* [https://bitbucket.org/knuddels/user-apps/wiki/Development Development] - einige Basics und technische Infos
* [[Limits|Technische Limits]] für UserApps

== Bugs ==

Wenn du einen Bug bemerkt hast, kannst du jemanden im '''/team bugs''' anschreiben.
Deine Ideen und Wünsche kannst du mit uns auf Discord teilen.

[[Kategorie:UserApp-Entwicklung]]

Kategorie:UserApp-Entwicklung

2019-07-23T08:22:56Z

Tom Unterwegs: Die Seite wurde neu angelegt: „Die '''Kategorie "UserApp-Entwicklung''' enthält alle Artikel zu UserApps, die für '''UserApp-Entwickler''' gedacht sind - also UserApp-Entwi…“

Die '''Kategorie "UserApp-Entwicklung''' enthält alle Artikel zu [[User_App|UserApps]], die für '''UserApp-Entwickler''' gedacht sind - also [[UserApp-Entwicklung/Tutorials|Tutorials]], technische Dokumentation usw. 
Im Gegensatz dazu enthält die andere [https://knuddels-wiki.de/index.php?title=Kategorie:User_App Kategorie "User App"] Artikel, die für gewöhnliche Nutzer gedacht sind.

Bots (virtuelle Person)

2019-07-22T17:04:46Z

Tom Unterwegs: verlinkt auf AppBot

==Allgemeines==
Ein '''Bot''' ist ein Programm, welches verschiedene Aufgaben übernehmen kann. So ist z.B. [[James]] auch ein Bot. Bots können jegliche Art von Aufgaben übernehmen. Diese sind zum Beispiel, durchgehend online sein oder auch auf Anfragen zu reagieren, dies aber auch nur, aus einer Liste mit vorgegebenen Antworten.

Bots sind in jeglicher Art, außer die Systembots und die [[UserApp-Entwicklung/Doku/AppBot|AppBots]] von [[User_Apps|UserApps]], in [[Knuddels]] verboten.

==Weiterführende Informationen==
* [[James]] - Informationen zum Chat-Butler
* [[User_Apps|UserApps]] - Informationen zu den UserApps
* [[UserApp-Entwicklung/Doku/AppBot|AppBot]] - Informationen zu den AppBots von UserApps

UserApp-Entwicklung/Tutorials/Beginner

2019-07-22T17:01:27Z

Tom Unterwegs: /* Installation der UserApp */

UserApp-Entwicklung/Doku/AppBot

2019-07-22T16:58:16Z

Tom Unterwegs: Die Seite wurde neu angelegt: „== Allgemeines == Ein AppBot ist ein Account bei Knuddels, der nicht von einer Person, sondern von einer UserApp gesteuert wird. Die UserApp kann…“

== Allgemeines ==

Ein AppBot ist ein Account bei Knuddels, der nicht von einer Person, sondern von einer [[User_App|UserApp]] gesteuert wird. Die UserApp kann bestimmte Aktionen auslösen, beispielsweise das Senden einer Nachricht oder das Überweisen von [[Knuddel]].
Jede UserApp benötigt einen AppBot. In der Regel registriert der Channelbesitzer einen AppBot beim Installieren der entsprechenden UserApp (→ [[UserApp-Entwicklung/Tutorials/Beginner|Beginner-Tutorial]]).

== Nickname ==

Du kannst dem AppBot jeden beliebigen Namen geben (solange er noch nicht vergeben ist), aber es ist für die Nutzer deiner UserApp deutlich angenehmer, wenn du dich dabei am Namen des MyChannels oder der UserApp orientierst.

== Profilbild ==

Als Ersteller eines AppBots ist es möglich, das Profilbild des AppBots zu ändern. 
→ [[UserApp-Entwicklung/Tutorials/AppBot-Profilbild|Tutorial: AppBot-Profilbild]]

== Weiterführende Links ==

* [https://bitbucket.org/knuddels/user-apps/wiki/AppBotBinden Wie binde ich einen AppBot?]

UserApp-Entwicklung/Tutorials

2019-07-22T16:45:21Z

Tom Unterwegs: Tutorial verlinkt

Hier ist eine Sammlung aller Tutorials zur UserApp-Entwicklung.

== Für Anfänger ==
Lerne Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Einstieg]]
* [[UserApp-Entwicklung/Tutorials/HTML-UI|HTML-UI (grafische Oberfläche)]]
* [[UserApp-Entwicklung/Tutorials/UserApps_teilen|UserApps installieren und freigeben]]
* [[UserApp-Entwicklung/Tutorials/Newsletter-Versand|Newsletter-Versand]]
* [[UserApp-Entwicklung/Tutorials/AppBot-Profilbild|AppBot-Profilbild]]

== Für Fortgeschrittene ==

''Es gibt leider noch keine Tutorials für Fortgeschrittene.''

Du kannst dich auf Discord an fortgeschrittene UserApp-Entwickler wenden. Den Link zum Discord-Channel findest du unter '''/apps developer'''.

== Weitere Tutorials ==

* [[User_Apps/Tutorial|Hallo Welt]]

== Meta ==

Tutorial über das Schreiben von UserApp-Tutorials: [[UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta|UserApp-Tutorials-Meta]]

UserApp-Entwicklung/Tutorials/AppBot-Profilbild

2019-07-22T16:36:31Z

Tom Unterwegs: Die Seite wurde neu angelegt: „== Einführung == Das Profilbild deines AppBots sieht standardmäßig ziemlich unoriginell aus. Aber wenn du beispielsweis…“

User Apps

2019-07-22T15:02:19Z

Tom Unterwegs: verständlichere Einleitung, eigener Abschnitt für "Geschichte", kleinere Verbesserungen

{{NN}}

==Allgemeines==

UserApps sind von Nutzern geschriebene Programme, die in [[MyChannel]]n laufen. Das können zum Beispiel Spiele oder hilfreiche Tools für [[Channelmoderator]]en sein. Nicht jede UserApp muss einen grafischen Teil haben, sie kann auch ausschließlich über den Chat laufen. 
Jeder Nutzer kann selbst UserApps entwickeln, sobald er den Status [[Familymitglied]] erreicht. Die [[UserApp-Entwicklung]] ist wiederum ein eigener Teil des Knuddels-Wikis. Dort gibt es zum Beispiel [[UserApp-Entwicklung/Tutorials|Tutorials für Anfänger und Fortgeschrittene]].

== Geschichte ==

Am [[2014|24.12.2014]] stellte [[Ironist]] im Forum die Beta-Phase der UserApps vor. Hierbei handelt es sich um Spiele oder Features, welche von Chattern entwickelt und dann bei Knuddels integriert werden können. Diese Apps lassen sich dann in verschiedenen [[MyChannel]]n verwenden. In der Beta-Phase wurden zwölf Apps vorgestellt.

Seit dem [[2015|17.09.2015]] ist es jedem [[Familymitglied]] im deutschen Knuddels-Chat, möglich, eigene UserApps zu entwickeln.

Seit Dezember [[2015]] gibt es sogenannte Entwickler-Coaches. Diese helfen den UserApp-Entwicklern bei Fragen und/oder Problemen mit den UserApps. Außerdem halten die Coaches regelmäßig [[Entwicklertreffen]] im Channel [[Channel:App Entwickler|App Entwickler]] ab. Neben Neuigkeiten die dort vorgestellt werden, haben alle Anwesenden auch die Möglichkeiten Fragen zu stellen und eigene Ideen wie auch Verbesserungsvorschläge einzubringen.

== Voraussetzungen ==

Es gelten folgende Voraussetzungen, um UserApp-Entwickler zu werden:

* [[Familymitglied]] werden
* [[TAN-System]] aktivieren
* [[E-Mail-Verifikation|E-Mail-Adresse verifizieren]]
* [[Entwickler-AGB]] akzeptieren

Diese Liste kann mit '''/apps developer''' im Chat angezeigt werden. Nachdem dort alle Kriterien erfüllt wurden, muss erneut '''/apps developer''' eingegeben werden. Daraufhin sendet James die notwendigen Informationen, um mit der Entwicklung beginnen zu können.

==Installation einer User App von einem Entwickler==
Sobald ein User eine eigene App entwickelt hat, kann er diese für einzelne, mehrere oder gar für alle User freischalten. Sobald der Entwickler die App selber auf dem Server installiert hat, kann er die benötigten Daten zum Installieren an die Interessenten weitergeben.

Folgende Daten werden vom Entwickler benötigt:
* FTP Benutzername
* AppName / Ordername

Die Funktion, mit der man die App dann installieren kann, sieht wie folgt aus:

* <function>/apps install knuddelsDEV.ftpUserName.appName</function>

==Verwendbare Apps==
{| class="wikitable sortable" border="1"
|-
! Name der App
! MyChannel
! Entwickler
! Kategorie
! MyChannel-Installation freigegeben?
|-
| [[User App:2Ways|2Ways]]
| [[Channel:WürfelWunder|/Würfelwunder]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:App Entwickler|App Entwickler]]
| [[Channel:App Entwickler|/App Entwickler]]
| [[Ironist]]
| Newsletter
| Nein
|-
| [[User App:Alles oder Nichts|Alles oder Nichts]]
| [[Channel:Alles oder Nichts|/Alles oder Nichts]]
| Dave20009
| Spiel
| Nein
|-
| [[User App:Besserwisser|Besserwisser]]
| [[Channel:Besserwisser|/Besserwisser]]
| DerNeuanfang, Maexxchen
| Spiel
| Nein
|-
| [[User App:Bingo Event|Bingo Event]]
| [[Channel:DiceSky|/DiceSky]]
[[Channel:Veranstaltung|/Veranstaltung]]
| Vampiric Desire
| Spiel
| Nein
|-
| [[User App:Blitz!|Blitz!]]
| [[Channel:Blitz|/Blitz]]
| Spectra
| Spiel
| Nein
|-
| [[User App:Braintainment|Braintainment]]
| [[Channel:Braintainment|/Braintainment]]
| IgelchenM
| Spiel
| Nein
|-
| [[User App:Catch the Pandas|Catch the Pandas]]
| [[Channel:777|/777]]
| Kev777
| Spiel
| Nein
|-
| [[User App:ChannelControl|ChannelControl]]
| [[Channel:ChannelControl|/ChannelControl]]
| W a n n a b e - M o d e l
| Tool
| Nein
|-
| [[User App:ChannelHelper|ChannelHelper]]
| [[Channel:ChannelHelper|/ChannelHelper]]
| rmpg
| Tool
| Ja
|-
| [[User App:Chooso|Chooso]]
| [[Channel:Chooso|/Chooso]]
| J
| Spiel
| Nein
|-
| [[User App:ChannelMaster|ChannelMaster]]
| [[Channel:ChannelMaster|/ChannelMaster]]
| Vampiric Desire
| Tool
| Ja
|-
| [[User App:Chuck a Luck|Chuck a Luck]]
| -
| DNA 328
| Spiel
| Nein
|-
| [[User App:CrashFly|CrashFly]]
| [[Channel:CrashFly|/CrashFly]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:D&S Searchbox v2|D&S Searchbox v2]]
| [[Channel:Dom&Sub|/Dom&Sub]]
| SchlechteOnkelz
| Tool
| Nein
|-
| [[User App:Darts|Darts]]
| [[Channel:Würfelwunder|/Würfelwunder]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:Dice-o-mat|Dice-o-mat]]
| [[Channel:777|/777]]
| Kev777
| Spiel
| Nein
|-
| [[User App:DiceSkyV2|DiceSky]]
| [[Channel:DiceSky|/DiceSky]]
| Vampiric Desire
| Spiel
| Nein
|-
| [[User App:Down|Down]]
| [[Channel:WürfelWunder|/WürfelWunder]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:EventSystem|EventSystem]]
| -
| djchrisnet
| Tool
| Ja
|-
| [[User App:Fivel|Fivel]]
| [[Channel:WürfelWunder|/WürfelWunder]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:FlappyKnuddel|FlappyKnuddel]]
| [[Channel:Flappy|/Flappy]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:Fun|Fun]]
| [[Channel:Abenteuer18|/Abenteuer18]]
|
| Spiel
| Nein
|-
| [[User App:Funny 7|Funny 7]]
| -
| djchrisnet
| Spiel
| Nein
|-
| [[User App:Glücksrad (das TV-Quiz)|Glücksrad (das TV-Quiz)]]
| -
| Enrico-nrp
| Spiel
| Keine Information
|-
| [[User App:Glücksspiel|Glücksspiel]]
| -
| xz
| Spiel
| Keine Information
|-
| [[User App:Greedypiglet|Greedypiglet]]
| [[Channel:777|/777]]
| Kev777
| Spiel
| Nein
|-
| [[User App:Hangman 2|Hangman 2]]
| -
| Enrico-nrp
| Spiel
| Keine Information
|-
| [[User App:Hau den Sidoh|Hau den Sidoh]]
| [[Channel:ParaDICE|/ParaDICE]]
| Vampiric Desire
| Spiel
| Nein
|-
| [[HighOrLow]]
| -
| djchrisnet
| Spiel
| Keine Information
|-
| [[User App:Hit|Hit]]
| -
| djchrisnet
| Spiel
| Keine Information
|-
| [[User App:Hundred|Hundred]]
| [[Channel:WürfelWunder|/WürfelWunder]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:HZM-App|HZM-App]]
| -
| Pega16
| Tool
| Ja
|-
| [[User App:Ich hab noch nie|Ich hab noch nie]]
| [[Channel:Ich hab noch nie|/Ich hab noch nie]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:Jukebox|Jukebox]]
| -
|
|
| Keine Information
|-
| [[User App:Jumpo!|Jumpo!]]
| -
| Inuyasha20
| Spiel
| Keine Information
|-
| [[User App:Knuddelonia|Knuddelonia]]
| [[Channel:Knuddelonia|/Knuddelonia]]
| martin070476
| Spiel
| Nein
|-
| [[User App:Knuddels Adventure|Knuddels Adventure]]
| [[Channel:Knuddels Adventure|/Knuddels Adventure]]
| Finomosec
| Spiel
| Nein
|-
| [[User App:Knuddels-Wiki|Knuddels-Wiki]]
| [[Channel:Knuddels-Wiki|/Knuddels-Wiki]]
| Gery123
| Sonstiges
| Nein
|-
| [[User App:Knudon|Knudon]]
| [[Channel:Knudon|/Knudon]]
| J
| Spiel
| Nein
|-
| [[User App:Knuffel|Knuffel]]
| [[Channel:Knuffel|/Knuffel]]
| TobyB
| Spiel
| Nein
|-
| [[User App:KopfTrainer|KopfTrainer]]
| [[Channel:KopfTrainer|/KopfTrainer]]
| MarvinDerPraktikant
| Spiel
| Nein
|-
| [[User App:Landreise|Landreise]]
| [[Channel:Landreise|/Landreise]]
| Vampiric Desire
| Spiel
| Nein
|-
| [[User App:Lucky7|Lucky7]]
| [[Channel:Casino Knuddels|/Casino Knuddels]]
| Vampiric Desire
| Spiel
| Nein
|-
| [[User App:Memory|Memory]]
| [[Channel:Memory|/Memory]]
| IgelchenM
| Spiel
| Nein
|-
| [[User App:MiniSlot|MiniSlot]]
| -
| rmpg
| Spiel
| Ja
|-
| [[User App:Need for Speed|Need for Speed]]
| [[Channel:Need for Speed|/Need for Speed]]
| Weißer drache 007
| Spiel
| Nein
|-
| [[User App:NiJaSin|NiJaSin]]
| [[Channel:NiJaSin|/NiJaSin]]
| DerNeuanfang
| Spiel
| Nein
|-
| [[User App:OR-Radio|OR-Radio]]
| [[Channel:or radio|/or radio]]
| SchlechteOnkelz
| Sonstiges
| Nein
|-
| [[User App:Panzerknacker|Panzerknacker]]
| [[Channel:777|/777]]
| Kev777
| Spiel
| Nein
|-
| [[User App:ProMailer|ProMailer]]
| -
| Dreamboy-1996 <3
| Tool
| Ja
|-
| [[User App:Quatsch+|Quatsch+]]
| [[Channel:eXilant|/eXilant]]
| eXilant
| Tool/Spaß
| Ja
|-
| [[User App:Roulette American|Roulette American]]
| [[Channel:777|/777]]
| Kev777
| Spiel
| Nein
|-
| [[User App:Raum der Wünsche|Raum der Wünsche]]
| [[Channel:Raum der Wünsche|/Raum der Wünsche]]
| DdvOiD
| Spiel
| Nein
|-
| [[User App:SpecialForces|SpecialForces]]
| [[Channel:Summer|/Summer]]
| Dave20009
| Tool
| Nein
|-
| [[User App:SidohCasino V2|SidohCasino V2]]
| [[Channel:SidohCasino|/SidohCasino]]
| rmpg
| Spiel
| Nein
|-
| [[User App:SkyJump|SkyJump]]
| [[Channel:SkyJump|/SkyJump]]
| IgelchenM
| Spiel
| Nein
|-
| [[User App:Snake|Snake]]
| [[Channel:SnakeGame|/SnakeGame]]
| Dreamboy-1996 <3
| Spiel
| Nein
|-
| [[User App:Soccer|Soccer]]
| -
| J
| Spiel
| Nein
|-
| [[User App:SpaceKnuddelz|SpaceKnuddelz]]
| [[Channel:SpaceKnuddelz|/SpaceKnuddelz]]
| Plex
| Spiel
| Nein
|-
| [[User App:SpeedKnuffel|SpeedKnuffel]]
| [[Channel:SpeedKnuffel|/SpeedKnuffel]]
| TobyB
| Spiel
| Nein
|-
| [[User App:Spot It|Spot It]]
| [[Channel:Spot It|/Spot It]]
| Vampiric Desire
| Spiel
| Nein
|-
| [[User App:Spotlight|Spotlight]]
| [[Channel:Matratzensport|/Matratzensport]]
| Vampiric Desire
| sonstiges
| Nein
|-
| [[User App:Stardust|Stardust]]
| [[Channel:777|/777]]
| Kev777
| Spiel
| Nein
|-
| [[User App:Sudoku|Sudoku]]
| [[Channel:Sudoku|/Sudoku]]
| Ironist
| Spiel
| Nein
|-
| [[User App:Sudoku Color|Sudoku Color]]
| [[Channel:Sudoku Color|/Sudoku Color]]
| Vampiric Desire
| Spiel
| Nein
|-
| [[User App:Supercode|Supercode]]
| [[Channel:777|/777]]
| Kev777
| Spiel
| Nein
|-
| [[User App:Tarot|Tarot]]
| [[Channel:Biss des Bösen|/Biss des Bösen]]
| denniscrazy
| Spiel
| Nein
|-
| [[User App:Knutris|Knutris]]
| [[Channel:Knutris|/Knutris]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:Tetris|Tetris]]
| -
| xz
| Spiel
| Nein
|-
| [[User App:Three of a Kind|Three of a Kind]]
| [[Channel:777|/777]]
| Kev777
| Spiel
| Nein
|-
| [[User App:Tic Tac Toe|Tic Tac Toe]]
| -
| xz
| Spiel
| Nein
|-
| [[User App:Triple|Triple]]
| [[Channel:WürfelWunder|/WürfelWunder]]
| djchrisnet
| Spiel
| Nein
|-
| [[User App:Verrückte Worte|Verrückte Worte]]
| [[Channel:Verrückte Worte|/Verrückte Worte]]
| Pralinenfan
| Spiel
| Nein
|-
| [[User App:World of Knuddelonia|World of Knuddelonia]]
| [[Channel:World of Knuddelonia|/World of Knuddelonia]]
| martin070476
| Spiel
| Nein
|}

==Weiterführende Informationen==
* [[/apps]] - Informationen zur Funktion
* [[/h appbot]] - Chathilfe zum App-Bot
* [[Apps-Team]] - Informationen zum Apps-Team
* [[App Manager]] - Informationen zum App Manager

==Weblinks==
* [http://forum.knuddels.de/ubbthreads.php?ubb=showflat&Number=2708654#Post2708654 www.knuddels.de/forum] - Ankündigung der Apps von Ironist im Forum und Links zu den Vorstellungen der einzelnen Apps
* [http://developer.knuddels.de/docs www.developer.knuddels.de] - Aktuelle Version der Knuddels-Apps-API für Entwickler
* [http://www.knuddels.de/#/channels/nutzer-apps www.knuddels.de/#/channels/nutzer-apps] - Channelübersicht der aktuellen Nutzer-App-Channel
* [https://knuddelsapi.wordpress.com/2015/12/06/interview-holgi-2015-12/ knuddelsapi.wordpress.com] - "Holgi – Ein Blick zurück und ein Blick in die Glaskugel" (Interview, veröffentlicht 06.12.2015)

[[Kategorie:Begriffserklärung]]

Entwickler-AGB

2019-07-22T14:46:20Z

Tom Unterwegs: Disclaimer hinzugefügt (Hinweis auf Chatbefehl)

== Allgemeines ==
Die '''Entwickler-AGB''' müssen von jedem App-Entwickler akzeptiert werden, um eigene [[User App]]s erstellen zu können. 
Achtung: Die aktuellste Version der Entwickler-AGB findest du, wenn du im Chat '''/apps AGB''' eingibst.

===Präambel===
Die Knuddels GmbH & Co. KG, Erbprinzenstr. 27, 76133 Karlsruhe (nachfolgend "Knuddels" genannt) betreibt die Internet-Chat-Portale Knuddels.de und Knuddels.at. Auf diesen Plattformen gibt Knuddels seinen Nutzern die Möglichkeit, eigene Programme zu erstellen (sogenannte Apps), die im Chat genutzt werden können. Die Ersteller dieser Apps (im Weiteren „Entwickler“ genannt) haben die Möglichkeit, die Apps selbst zu nutzen und/oder an andere Nutzer weiterzugeben bzw. von diesen nutzen zu lassen. Die nachfolgenden allgemeinen Geschäftsbedingungen regeln die Bedingungen, unter denen die Entwickler von Apps diese bei Knuddels einpflegen können.
===§ 1 Erstellung von Apps===
a) Die für den Chat von Knuddels entwickelte Software darf nur dann Drittsoftware oder Teile eines von Dritten erstellten Quellcodes enthalten, an denen Dritte Urheberrecht haben, wenn die berechtigten Dritten einer solchen Nutzung im Einzelfall oder allgemein zugestimmt haben. Trotz Zustimmung des berechtigten Dritten dürfen von Dritten erstellte Teile eines Quellcodes bzw. Drittsoftware etc. nicht genutzt werden, wenn der Dritte für die Einräumung von Rechten an seinem Werk eine Gegenleistung verlangt, die von Knuddels zu erbringen wäre.
b) In der erstellten App dürfen keinerlei Sounds, Grafiken oder andere Werke von dritten Personen genutzt werden, die nicht ausdrücklich ihr Einverständnis für diese Nutzung gegeben haben.
c) Damit die App bei Knuddels genutzt werden kann, ist diese an Knuddels zu übermitteln. Dabei ist auch der Quellcode sowie sämtlich genutzten Grafiken, Sounds oder Datenbanken an Knuddels zu übermitteln.
d) Der Entwickler hat keinen Anspruch darauf, dass die von ihm erstellte App auch tatsächlich auf einer Knuddels-Plattform veröffentlicht wird. Knuddels behält sich ausdrücklich vor, nach Prüfung eine übermittelte App nicht zu veröffentlichen.
===§ 2 Inhalte von Apps===
Die erstellten Apps dürfen nachfolgende Inhalte nicht enthalten:
a) Pornografie oder explizite sexuelle Inhalte
b) Die Veranstaltung von Glücksspielen gegen Einsatz von Geld oder geldwerten Vorteilen, Leistungen oder Gegenständen.
c) Aufforderungen oder Bitten um Geldzahlungen oder Überlassung von geldwerten Vorteilen, Leistungen oder Gegenständen außerhalb eines Bezahlsystems, das durch Knuddels bereitgestellt wird.
d) Inhalte aus Affiliate-Programmen,
e) Verherrlichende Gewaltdarstellungen
f) Darstellungen, die bestimmte Personengruppen diskriminieren, sei es aufgrund ihrer Rasse, ethnischen Herkunft, Religion, Behinderung, Geschlechts, Alters der sexueller Orientierung bzw. geschlechtlicher Identität oder anderer Gründe
g) Wahrheitswidrige Angaben des Entwicklers zu seiner Identität bzw. der Zugehörigkeit zu einer Firma, Organisation, einem Verein oder andere Personengruppe.
h) Inhalte, die Schutzrechte Dritter, insbesondere Patent-, Marken- oder Urheberrechte verletzen.
i) Private Daten Dritter ohne deren ausdrückliche Zustimmung
j) Inhalte, die gegen geltendes Recht der Bundesrepublik Deutschland verstoßen
k) Schadinhalte, bzw. Inhalte, die Schadsoftware wie Viren oder Trojaner verbreiten und/oder Soft- oder Hardware auf dem Rechner des Nutzers bzw. Server von Knuddels beschädigen, löschen etc. oder Daten des Nutzers oder von Knuddels gegen bzw. ohne dessen Willen ausspähen und/oder verbreiten.
l) Kommerzielle Werbung jeglicher Art
m) Irreführende Inhalte, die den Eindruck beim Nutzer erwecken, dass eine ganz bestimmte Aktion z.B. durch eine Eingabe des Nutzers hervorgerufen wird, wenn aber tatsächlich hierdurch eine andere Aktion ausgelöst wird.
===§ 3 Rechte und Pflichten des Entwicklers===
a) Der Entwickler hat das Recht, mit denjenigen Nutzern, die seine App nutzen wollen, Vereinbarungen über die Nutzung dieser App zu treffen.
b) Der Entwickler hat gegenüber Knuddels das Recht, die von ihm erstellte App jederzeit zu löschen bzw. aus dem Angebot von Knuddels zu entfernen. Dieses Recht gilt vorbehaltlich etwaiger Vereinbarungen, die der Entwickler mit Usern getroffen hat, die seine App nutzen.
c) Der Entwickler hat das Recht gegenüber Knuddels, seine App jederzeit zu bearbeiten und zu ändern. Dieses Recht gilt vorbehaltlich etwaiger Vereinbarungen, die der Entwickler mit Usern getroffen hat, die seine App nutzen.
d) Der Entwickler hat bei der Entwicklung und dem Betrieb der App die geltenden Datenschutzbestimmungen, insbesondere die Regelungen der Datenschutzgrundverordnung (DSGVO) und des Bundesdatenschutzgesetzes (BDSG neu) einzuhalten und die Nutzer der App vor der Nutzung gem. Art. 13 DSGVO zu informieren. Die Rechte der Nutzer nach Art. 15 ff. DSGVO sind diesen zu gewähren. Ohne Zustimmung des betroffenen Nutzers sind keine Daten an Dritte herauszugeben.
e) Sofern in einer App Inhalte enthalten sind, die erst für Personen eines bestimmten Alters objektiv als geeignet anzusehen sind, muss der Entwickler dafür Sorge tragen, dass technisch ausgeschlossen ist, dass die entsprechenden Inhalte durch Nutzer, für die diese Inhalte wegen ihres Alters nicht geeignet sind, wahrgenommen werden können.
f) Werden dem Nutzer in einer App Leistungen nur gegen Gegenleistung angeboten, so muss der Nutzer, bevor er seine Gegenleistung an den Entwickler gibt, darauf hingewiesen werden, wie lange er aufgrund der Gegenleistung von der erworbenen Leistung profitieren kann. Ferner muss der Entwickler sicherstellen, dass der Nutzer die ihm dargebotene Leistung auch über den gesamten vereinbarten Zeitraum nutzen kann. Wird die Leistung nicht über den gesamten Zeitraum zur Verfügung gestellt, ist dem Nutzer die von ihm entrichtete Gegenleistung anteilig unter Berücksichtigung der bisherigen Nutzungszeit zurückgewähren. Kann die Gegenleistung nicht geteilt werden, ist die gesamte Gegenleistung zu erstatten.
g) Apps dürfen keine Funktion aufweisen, mit denen es den Nutzern ermöglicht wird, die von Knuddels angebotenen Smileys zu nutzen oder den Anschein zu erwecken, als würden diese Smileys genutzt, ohne dass der Nutzer diese Smileys selbst für seinen Account freigeschaltet hat.
===§ 4 Vertraulichkeit===
Um dem Entwickler die Möglichkeit zu geben, seine Apps entsprechend anzupassen, wird Knuddels gegebenenfalls in Einzelfällen die Entwickler über neue bzw. neu geplante Funktionalitäten des Chatangebotes von Knuddels informieren, noch bevor diese Informationen gegenüber allen Nutzern von Knuddels öffentlich gemacht werden. Der Entwickler ist verpflichtet, solche Informationen absolut vertraulich zu behandeln und nicht an Dritte weiterzugeben, bis die Information durch Knuddels allgemein für alle Nutzer veröffentlicht worden ist.
===§ 5 Rechte und Pflichten von Knuddels===
a) Knuddels hat das Recht, bei einem Verstoß gegen diese AGB oder aus anderem wichtigem Grund die App des Entwicklers jederzeit zu entfernen und den Entwickler dahingehend zu sperren, dass zukünftig dieser oder eine bzw. mehrere Apps des Entwicklers nicht mehr über eine Knuddels-Plattform angeboten werden können.
===§ 6 Haftungsfreistellung durch den Entwickler===
Der Entwickler stellt Knuddels im Innenverhältnis von sämtlichen Forderungen und Ansprüchen Dritter frei, die sich daraus ergeben, dass der Entwickler gegen diese AGB verstößt, ein Nutzer Ansprüche wegen Mängeln der Software geltend macht oder die vom Entwickler erstellte Software Urheber-, Marken-, Patentrechte, Rechte an Betriebsgeheimnissen oder am Produktdesign oder andere gewerbliche Schutzrechte von Personen verletzt oder Personen verleumdet oder deren Persönlichkeits- oder Verwertungsrechte verletzt.
===§ 7 Haftung von Knuddels===
Knuddels haftet gegenüber dem Entwickler nach den gesetzlichen Vorschriften für Vorsatz und grobe Fahrlässigkeit von Knuddels, seinen gesetzlichen Vertretern, leitenden Angestellten oder sonstigen Erfüllungsgehilfen. Gleiches gilt bei der Übernahme von Garantien oder einer sonstigen verschuldensunabhängigen Haftung sowie bei Ansprüchen nach dem Produkthaftungsgesetz oder bei einer schuldhaften Verletzung des Lebens, des Körpers oder der Gesundheit. Knuddels haftet dem Grunde nach für durch Knuddels, seine Vertreter, leitende Angestellte und einfache Erfüllungsgehilfen verursachte einfach fahrlässige Verletzungen wesentlicher Vertragspflichten, also solcher Pflichten, auf deren Erfüllung der Entwickler zur ordnungsgemäßen Durchführung des Vertrages regelmäßig vertraut und vertrauen darf, in diesem Fall aber der Höhe nach begrenzt auf den typischerweise entstehenden, vorhersehbaren Schaden.
Eine weitere Haftung von Knuddels ist ausgeschlossen.
Soweit die Haftung von Knuddels ausgeschlossen oder beschränkt ist, gilt dies auch zugunsten der persönlichen Haftung ihrer gesetzlichen Vertreter, leitenden Angestellten und einfachen Erfüllungsgehilfen.

== Weiterführende Informationen ==
*[[:/apps AGB]] - Funktion zum Öffnen der Entwickler-AGB im Chat

== Andere Nutzungsbedingungen ==
{{Regeln}}
[[Kategorie:Regelwerk]]

Familymitglied

2019-07-22T14:02:20Z

Tom Unterwegs: Verlinkung von UserApps

== Allgemeines ==
'''Familymitglieder''' (kurz: "Family") sind Chatter, die schon seit längerer Zeit dem Chat treu sind und eine Weile in der Community verbracht haben. Sie kennen sich gut mit dem Chat und den [[Funktionen]] aus, haben in der Regel bereits eine Menge Freundschaften geschlossen und legen ein besonderes Maß an gutem Benehmen und Freundlichkeit an den Tag. Alle Familymitglieder werden im Laufe ihrer Chatlaufbahn durch den [[Butler James]] ernannt. Hat man den [[Status]] des Familymitglieds einmal erreicht, kann man diesen nicht wieder verlieren.

Familymitglieder werden in den meisten Channel als blau gefärbter [[Nickname]] in der [[Nickleiste]] angezeigt und sind somit leicht und eindeutig als solche zu erkennen.

==Aufstieg zum Familymitglied==
Viele [[Onlineminuten]] sind für die Ernennung zum Familymitglied nicht ausschlaggebend. Man sollte dennoch eine hohe Aktivität an den Tag legen. Aber auch der Einsatz für ein gutes Chatklima, freundliche und hilfsbereite Aufnahme von neuen Chattern sollten an den Tag gelegt werden. Für die Ernennung spielt natürlich Glück eine große Rolle. Die genauen Kriterien um Familymitglied zu werden sind nicht bekannt und werden von der Chatleitung geheim gehalten.

==Zusätzliche Funktionen und Möglichkeiten==
* Anlegen eines [[MyChannel]]
* Entwickeln von [[User_Apps|UserApps]]
* Die Vergabe des eigenen [[Herz]]
* Zugang zum [[Forum|Knuddels-Forum]]
* Zugang zum [[Channel]] [[Channel:Family|Family]]
* Vergrößerung der [[/f|Friendlist]]
* Erkennen neue [[Mitglieder]] an einer Biene hinter dem Nick, wenn sie unter 100 Onlineminuten haben
* Verwendung der Funktion [[/team]]

==Weiterführende Informationen==
* [[/h family]] - Chathilfe zum Familymitglied
* [[/h mychannel]] - Chathilfe zum MyChannel
* [[Forum]] - Informationen zum Knuddels-Forum
* [[User_Apps|UserApps]] - Was ist eine UserApp?
* [[UserApp-Entwicklung]] - Tutorials und Wissen zum Entwickeln von UserApps

{{Status}}

UserApp-Entwicklung

2019-07-22T14:00:21Z

Tom Unterwegs: sinnvollere Verlinkungen von Tutorials und UserApp-Erklärung

UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta

2019-07-15T09:10:47Z

Tom Unterwegs:

UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta

2019-07-12T13:51:05Z

Tom Unterwegs: kleine Fehler verbessert

Tipps für das Schreiben von Tutorials zu UserApps.

== Code-Beispiele einfügen ==

=== <pre>-Tag ===

Code ist auf dem Knuddels-Wiki am besten in einem '''<pre>'''-Tag aufgehoben. 
Allerdings gibt es auch hier noch Probleme mit der Formatierung, zum Beispiel werden Whitespaces am Anfang der Zeile entfernt.

=== Whitespaces ===

Die Whitespaces am Anfang der Zeile (oder einfach alle) können durch '''&nbsp;''' (geschütztes Leerzeichen) ersetzt werden, damit sie trotzdem angezeigt werden. 

In Python sähe das so aus:
<pre>
>>> s = """... hier der Quellcode ...
... noch mehr Quellcode ...
..."""
>>> print(s.replace(" ", "&nbsp;")
</pre>

=== HTML-Quellcode ===

Bei Verwendung von XML-Tags sollte der Quellcode außerdem zuerst einmal durch dieses Tool "escaped" werden: https://mothereff.in/html-entities

=== Syntax-Highlighting ===

Das Knuddels-Wiki hat derzeit leider kein Syntax-Highlighting.

=== Quellcode sichern ===

Das Ergebnis ist durch diese Änderungen im Bearbeitungsfeld im Wiki nicht mehr gut lesbar. Um für spätere Änderungen noch die originale Version des Code-Beispiels zu erhalten, kann es in einem XML-Kommentar gesichert werden:

<pre>

<pre>
hier die "escapte" Version
</pre>
</pre>

=== Zusammenfassung ===

# Code in einem Kommentar '''''' sichern
# Falls XML-Tags im Code vorkommen, durch dieses Tool jagen: https://mothereff.in/html-entities
# alle Leerzeichen (eigentlich nur am Anfang jeder Zeile) durch '''&nbsp;''' ersetzen
# das Ergebnis in einem '''<pre></pre>'''-Tag einfügen

UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta

2019-07-12T13:41:08Z

Tom Unterwegs: u.a. eine Hilfe zum Formatieren von Code in Tutorials

Tipps für das Schreiben von Tutorials zu UserApps.

== Code-Beispiele einfügen ==

=== <pre>-Tag ===

Code ist auf dem Knuddels-Wiki am besten in einem <pre>-Tag aufgehoben. 
Allerdings gibt es auch hier noch Probleme mit der Formatierung, zum Beispiel werden Whitespaces am Anfang der Zeile entfernt.

=== Whitespaces ===

Die Whitespaces am Anfang der Zeile (oder einfach alle) können durch '''"&nbsp;"''' (geschütztes Leerzeichen) ersetzt werden, damit sie trotzdem angezeigt werden. 

In Python sähe das so aus:
<pre>
>>> s = """... hier der Quellcode ...
... noch mehr Quellcode ...
..."""
>>> print(s.replace(" ", "&nbsp;")
</pre>

=== HTML-Quellcode ===

Bei Verwendung von XML-Tags sollte der Quellcode außerdem zuerst einmal durch dieses Tool "escaped" werden: https://mothereff.in/html-entities

=== Syntax-Highlighting ===

Das Knuddels-Wiki hat derzeit leider kein Syntax-Highlighting.

=== Quellcode sichern ===

Das Ergebnis ist durch diese Änderungen im Bearbeitungsfeld im Wiki nicht mehr gut lesbar. Um für spätere Änderungen noch die originale Version des Code-Beispiels zu erhalten, kann es in einem XML-Kommentar gesichert werden:

<pre>

<pre>
hier die "escapte" Version
</pre>
</pre>

=== Zusammenfassung ===

# Code in einem Kommentar '''''' sichern
# Falls XML-Tags im Code vorkommen, durch dieses Tool jagen: [https://mothereff.in/html-entities]
# alle Leerzeichen (eigentlich nur am Anfang jeder Zeile) durch "&nbsp" ersetzen → daher am besten keine Tabs im Quellcode verwenden
# das Ergebnis in einem <pre></pre>-Tag einfügen

UserApp-Entwicklung/Tutorials

2019-07-12T13:13:57Z

Tom Unterwegs: Redlinks hinzugefügt

Hier ist eine Sammlung aller Tutorials zur UserApp-Entwicklung.

== Für Anfänger ==
Lerne Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Einstieg]]
* [[UserApp-Entwicklung/Tutorials/HTML-UI|HTML-UI (grafische Oberfläche)]]
* [[UserApp-Entwicklung/Tutorials/UserApps_teilen|UserApps teilen]]
* [[UserApp-Entwicklung/Tutorials/Newsletter-Versand|Newsletter-Versand]]

== Für Fortgeschrittene ==

''Es gibt leider noch keine Tutorials für Fortgeschrittene.''

Du kannst dich auf Discord an fortgeschrittene UserApp-Entwickler wenden. Den Link zum Discord-Channel findest du unter '''/apps developer'''.

== Weitere Tutorials ==

* [[User_Apps/Tutorial|Hallo Welt]]

== Meta ==

Tutorial über das Schreiben von UserApp-Tutorials: [[UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta|UserApp-Tutorials-Meta]]

Limits

2019-07-12T13:06:26Z

Tom Unterwegs: Limits für private Nachrichten und AppInstance.sendAppEvent() hinzugefügt

UserApp-Entwicklung/Tutorials

2019-07-12T13:03:43Z

Tom Unterwegs:

UserApp-Entwicklung/Tutorials/HTML-UI

2019-07-09T17:03:44Z

Tom Unterwegs: Hinweis auf Client.includeJS hinzugefügt

UserApp-Entwicklung/Tutorials

2019-07-09T16:22:02Z

Tom Unterwegs: Link zum HTML-UI Tutorial hinzugefügt und Kategorien eingeführt

UserApp-Entwicklung/Tutorials/HTML-UI

2019-07-09T16:12:18Z

Tom Unterwegs: Basic Tutorial für das senden von AppContent (HTML-UI) und dem senden von Events zwischen Server und Client

== Einleitung ==

In diesem Tutorial lernst du, wie du eine grafische Oberfläche in deinen UserApps verwenden kannst, um z.B. grafische Spiele für Knuddels zu programmieren. Du solltest schon einmal etwas mit HTML und JavaScript gemacht haben, um folgen zu können.

== Der Server ==

Der Server-Code deiner UserApp steht in der '''main.js'''. Wenn du nur in der '''main.js''' programmierst, läuft der ganze Code deiner UserApp ausschließlich auf den Servern von Knuddels. 
Damit kann man zwar schon viel machen, aber für mehr Interaktionsmöglichkeiten brauchst du eine grafische Oberfläche.

== Der Client ==

Der Code für den Client befindet sich im '''www'''-Unterordner deiner UserApp.
Den Einstieg bildet eine HTML-Datei, die du nennen kannst, wie du willst. Dort kannst du dann auch JavaScript-Dateien einbinden, um Code auf dem Gerät deines Besuchers auszuführen.

Die Struktur deiner UserApp könnte dann so aussehen:


<pre>
KnuddelJumper/
    www/
        game.html
        game.js
        player.png
        enemy.png
    main.js
</pre>

Die HTML-Datei kann dann z.B. so eine Struktur haben:


<pre>
<html>
    <head>
        <script src="game.js"/>
    </head>
    <body>
        <button>Hier klicken</button>
    </body>
</html>
</pre>

== Kommunikation zwischen Server und Client ==

=== AppContent senden ===

Die HTML-Datei und der restliche Inhalt des '''www'''-Unterordners wird [https://developer.knuddels.de/docs/classes/AppContent.html AppContent] genannt. Das ist die grafische Oberfäche deiner UserApp. 
Der AppContent erscheint aber nicht automatisch bei dem Besucher deines Channels! Du musst den AppContent erst an den Besucher (den Client) senden.
In der Regel macht man das direkt wenn der Besucher den Channel betritt, also in '''App.onUserJoined''':


<pre>
var App = (new function() {

    let htmlFile = new HTMLFile("game.html");
    let appContent = AppContent.overlayContent(htmlFile, 640, 480);

    this.onUserJoined = function(user) {
        user.sendAppContent(appContent);
    }
}());
</pre>

Der [https://developer.knuddels.de/docs/classes/AppContent.html AppContent] wird so nur einmal von der App geladen und dann einfach an jeden Besucher mit [https://developer.knuddels.de/docs/classes/User.html#method_sendAppContent User.sendAppContent()] gesendet. 

Hinweis: [https://developer.knuddels.de/docs/classes/HTMLFile.html new HTMLFile()] sucht die angegebene Datei im '''www'''-Unterordner.

'''Damit ist dieses Tutorial eigentlich fertig:''' Deine Besucher sehen jetzt eine grafische Oberfläche, wenn sie deinen Channel betreten und du kannst wie auf Webseiten Scripts einbinden. Ein paar wichtige Hinweise kommen aber noch! 

 

Der AppContent kann verschiedene '''ViewModes''' annehmen, je nachdem welche Methode du verwendest:

* '''Overlay''' mit [https://developer.knuddels.de/docs/classes/AppContent.html#method_overlayContent AppContent.overlayContent()]
* '''Popup''' mit [https://developer.knuddels.de/docs/classes/AppContent.html#method_popupContent AppContent.popupContent()]
* '''Headerbar''' mit [https://developer.knuddels.de/docs/classes/AppContent.html#method_headerbarContent AppContent.headerbarContent()]

 
'''Tipp:''' Nicht alle Geräte können jeden '''ViewMode''' anzeigen. Daher ist es gute Praxis, wenn du mit [https://developer.knuddels.de/docs/classes/User.html#method_canSendAppContent User.canSendAppContent()] entscheidest, welchen AppContent du sendest.
'''Beispiel:'''


<pre>
var App = (new function() {

    let htmlFile = new HTMLFile("game.html");
    let overlay = AppContent.overlayContent(htmlFile, 640, 480);
    let popup  = AppContent.popupContent(htmlFile, 640, 480);
    let headerbar = AppContent.headerbarContent(htmlFile, 480);

    this.onUserJoined = function(user) {

        if (user.canSendAppContent(overlay)) {
            user.sendAppContent(overlay);

        } else if (user.canSendAppContent(popup)) {
            user.sendAppContent(popup);

        } else if (user.canSendAppContent(headerbar)) {
            user.sendAppContent(headerbar);

        } else {
            user.sendPrivateMessage("Die UserApp kann auf deinem Gerät leider nicht angezeigt werden.");
        }
    }
}());
</pre>

=== Events senden ===

Dein Code auf dem Server und dein Code auf dem Client laufen jetzt praktisch unabhängig voneinander. Meistens ist es aber hilfreich, wenn Server und Client miteinander kommunizieren können.

==== Client → Server ====

''' Beispiel:''' Wenn der Nutzer auf der grafischen Oberfläche einen Knopf drückt, soll der AppBot eine öffentliche Nachricht in den Channel schreiben. 
Du kannst aber nur von der '''main.js''' (also vom Server aus) Chat-Nachrichten schicken. [https://developer.knuddels.de/docs/classes/BotUser.html#method_sendPublicMessage BotUser.sendPublicMessage()] funktioniert im Client nicht. 

Der Client muss also dem Server mitteilen, dass der Nutzer einen Button gedrückt hat. Das ist mit [https://developer.knuddels.de/docs/classes/Client.html#method_sendEvent Client.sendEvent()] möglich:

<pre>
Client.sendEvent("buttonPressed", {});
</pre>

Dabei können noch zusätzliche Daten in Form eines JavaScript-Objekts mitgegeben werden.

Der Server kann dann in der '''main.js''' in [https://developer.knuddels.de/docs/classes/App.html#method_onEventReceived App.onEventReceived()] reagieren:


<pre>
var App = (new function() {
    
    //...
    
    this.onEventReceived = function(user, type, data, appContentSession) {
        
        if (type == "buttonPressed") {
            let bot = KnuddelsServer.getDefaultBotUser();
            bot.sendPublicMessage(user.getProfileLink()+" hat den Knopf gedrückt!");
        }
    }
}());
</pre>

==== Server → alle Clients ====

''' Beispiel:''' In der '''main.js''' wird eine zufällige Zahl generiert. Diese Zahl soll an alle Besucher des Channels geschickt werden, sodass diese dann in der HTML-UI angezeigt werden kann. 

Mit [https://developer.knuddels.de/docs/classes/AppContent.html#method_sendEvent AppContent.sendEvent()] kannst du ein Event an alle Besucher schicken, bei denen dieser AppContent aktiv ist:

<pre>
let randomNumber = Math.floor(10 * Math.random());
appContent.sendEvent("showNumber", {randomNumber: number});
</pre>

Im Client kannst du mit [https://developer.knuddels.de/docs/classes/Client.html#method_addEventListener Client.addEventListener()] auf die Events vom Server reagieren:


<pre>
Client.addEventListener("showNumber", function(event) {
        
        let number = event.data.number;
        
        document.open();
        document.write("Die magische Zahl heißt: "+number);
        document.close()
});
</pre>

==== Server → ein bestimmter Client ====

'''Beispiel:''' Du wählst einen Besucher zufällig aus und möchtest, dass sich bei diesem Besucher die Farbe der HTML-UI ändert. 

Dazu musst du vom Server aus (also in der '''main.js''') diesem Client ein Event senden. 
Du kannst aber nicht einfach ''User.sendEvent()'' aufrufen (diesen Befehl gibt es nicht). Eine UserApp kann nämlich verschiedene '''ViewModes''' auf einmal verwenden (sogenannte '''AppContentSessions'''). Du musst der API also sagen, an welche '''AppContentSession''' du das Event senden möchtest. 

Wenn du weißt, welchen '''ViewMode''' der Besucher verwendet (z.B. weil du sowieso immer nur ein Popup sendest), kannst du einfach mit dem Befehl [https://developer.knuddels.de/docs/classes/User.html#method_getAppContentSession User.getAppContentSession] die AppContentSession erhalten und dann das Event senden. '''Beispiel:'''

<pre>
let appContentSession = user.getAppContentSession(AppViewMode.Popup);
appContentSession.sendEvent("changeColor", {red:255, green:0, blue:255});
</pre>

 

Wenn dein Client allerdings gleichzeitig mehrere aktive '''AppContentSessions''' haben könnte (z.B. eine Headerbar und ein Popup), kannst du eine Liste aller aktiven AppContentSessions eines Besuchers mit [https://developer.knuddels.de/docs/classes/User.html#method_getAppContentSessions User.getAppContentSessions()] erhalten. '''Beispiel:'''


<pre>
let appContentSessions = user.getAppContentSessions();

for (let i = 0; i < appContentSessions.length; i++) {
    let appContentSession = appContentSessions[i];
    appContentSession.sendEvent("changeColor", {red:255, green:0, blue:255});
}
</pre>

Auch hier kannst du im Client wieder mit [https://developer.knuddels.de/docs/classes/Client.html#method_addEventListener Client.addEventListener()] auf die Events reagieren.

==== Limits ====

Für die Daten, die du mit den Events zwischen Client und Server sendest, gibt es gewisse [[Limits]]. Diese Limits werden [[Limits|hier]] beschrieben.

UserApp-Entwicklung/Tutorials/Beginner

2019-06-26T19:28:36Z

Tom Unterwegs: Tutorial von bitbucket hierher umgezogen, Formatierung angepasst, verbesserte Erklärung, mehr Wiki-interne Links

== Einleitung ==
In diesem Tutorial lernst du Schritt für Schritt, deine erste UserApp zu programmieren. 
Hier geht es darum, erstmal alles zum Laufen zu bringen und ein paar Basics zu vermitteln, sodass ab dann selbstständig weiterentwickelt werden kann.

== Bevor es losgeht ==

=== Werde Entwickler ===

Stelle sicher, dass du ein Entwickler bist. Gib dazu '''/apps developer''' im Chat ein und erfülle die Kriterien, falls du das noch nicht getan hast.

=== Verwende die Desktop-App ===

Wir empfehlen dir stark, zum Entwickeln die Desktop-App auf deinem Computer zu verwenden. Du kannst die App [https://www.knuddels.de/stapp-win hier herunterladen]. 

== Die erste UserApp ==

=== Entwicklungs-Server ===
Das Entwickeln beginnt auf dem Entwicklungs-Server. Gib '''/apps developer''' ein und wähle den Punkt '''Login auf Entwicklungs-Server''' aus. Jetzt sollte eine Desktop-Verknüpfung für den Login auf dem Entwicklungs-Server angelegt worden sein. 
Wenn du Knuddels über diese Verknüpfung startest, landest du nach dem Login auf dem Entwicklungs-Server. Hier kannst du später in Ruhe an deiner UserApp tüfteln, bevor du deine Änderungen auf dem Live-Server hochlädst. 

Logge dich jetzt mit den Zugangsdaten auf dem Entwicklungsserver ein, die dir James gesendet hat ('''Entwickler-Nick''' und '''Entwickler-Passwort''').

Tipp: Du kannst die Zugangsdaten aus James' Nachricht mit Shift+Rechtsklick in das Chat-Fenster kopieren.

=== MyChannel ===

Nach dem Einloggen sollte sich automatisch das [[MyChannel]]-Edit Fenster öffnen. Ansonsten gib '''/mychannel''' ein. 
Du legst dir jetzt einen eigenen Channel an, in dem du gleich deine erste UserApp installieren wirst. Eine Info zu den Einstellungen erhältst du durch Klicken auf den Titel des jeweiligen Feldes. Außer über deinen Channel-Namen musst du dir aber erstmal keine Gedanken machen (du kannst dieses Fenster jederzeit wieder mit '''/mychannel''' öffnen). Drücke anschließend auf '''Speichern''' und '''Schließen''' und betritt deinen MyChannel mit '''/go <dein eigener Channel-Name>'''.

=== Installation der UserApp ===

Für dieses Tutorial haben wir dir schon Dateien für eine Beispiel-UserApp namens "HeyThere" auf den Server geladen. Installiere diese UserApp in deinem MyChannel mit '''/apps install HeyThere'''. Du kannst die UserApp später wieder aus deinem Channel löschen. 

Es müsste sich nun automatisch das Konfigurationsfenster für die UserApp geöffnet haben. Ansonsten öffne es selbst mit '''/apps''' und klicke auf den Namen der UserApp ("HeyThere").
Hinweis: Durch einen Bug kann es sein, dass das Fenster auf dem Entwicklungs-Server nichts anzeigt. Schließe es einfach und öffne es gleich nochmal mit '''/apps'''. Wir hoffen, diesen Bug bald beheben zu können.

Im Menüpunkt "AppBot" kannst du einen AppBot erstellen und an deine UserApp binden. Ein AppBot ist ein bisschen wie Butler James, nur eben für deine UserApp in deinem Channel. Drücke hierzu auf "hinzufügen" → "Nick anlegen", denk dir einen Nicknamen aus und bestätige. Mehr dazu findest du hier: [https://bitbucket.org/knuddels/user-apps/wiki/AppBotBinden Wie binde ich einen AppBot?] 

Starte jetzt deine erste UserApp.
Falls sich kein entsprechendes Fenster öffnet, starte die UserApp selbst, indem du im App-Menü auf '''aktivieren''' klickst.
Verlasse nun deinen Channel (indem du in einen anderen Channel gehst) und betritt ihn dann wieder (z.B. mit '''/go <dein eigener Channel-Name>'''). Dein AppBot sollte dich jetzt begrüßen! 

Um mit dem Entwickeln zu starten, mach mit dem nächsten Schritt weiter (FTP-Setup). Du kannst auch schon mal einen Blick in die [http://developer.knuddels.de/docs/ UserApps-API-Dokumentation] werfen. 

Bestimmt wird es auch mal eine Stelle geben, an der du nicht weiter weißt. Zögere nicht, [http://forum.knuddels.de/ubbthreads.php?ubb=postlist&Board=272&page=1 im Forum] Fragen zu stellen, wenn dir etwas nicht klar ist! Die anderen Entwickler sind freundlich, gehen fair miteinander um und helfen sich gerne gegenseitig.

== FTP-Setup ==

Du benötigst für die UserApp-Entwicklung ein FTP-Programm, um die Dateien für deine UserApp auf die Server von Knuddels hochzuladen.

=== Was ist eigentlich FTP? ===

FTP (File Transfer Protocol) ist ein Protokoll, mit dem Daten zwischen zwei Computern im Internet ausgetauscht werden können. 
Zum Glück gibt es ganz einfache Programme, die hinter den Kulissen dieses Protokoll sprechen, sodass du die Dateien mit wenigen Klicks hochladen kannst.

=== Einrichtung des FTP-Zugangs ===

Du wirst die Dateien deiner UserApp auf zwei verschiedenen Servern hochladen:
# auf dem '''Entwicklungs-Server''', unter der URL '''devappupload.knuddels.de'''
# auf dem '''Live-Server''', unter der URL '''appupload.knuddels.de'''

Für beide Server musst du dir jeweils eine Verbindung einrichten. Dafür brauchst du ein FTP-Programm.
Schau dir dazu [https://bitbucket.org/knuddels/user-apps/wiki/Bootstrap/FTP-Setup diese Erklärung] an. 
'''Diese Erklärung zeigt allerdings nur die Verbindung zum Live-Server''' - verwende für den Entwicklungs-Server stattdessen die URL '''devappupload.knuddels.de'''. 

Als Zugangsdaten verwendest du die Zugangsdaten, die James dir geschickt hat ('''FTP-Nutzer''' und '''FTP-Passwort''').

Tipp: Du kannst die Zugangsdaten aus James' Nachricht mit Shift+Rechtsklick in das Chat-Fenster kopieren.
Unter '''/apps developer''' kannst du sie außerdem erneut anfordern.

Achte außerdem jeweils darauf, eine '''unverschlüsselte Verbindung''' zu wählen.

== Beispiel-Code anschauen ==

Wenn du weißt, wie du Dateien über den FTP-Zugang von dem Server herunter- und hochladen kannst, kannst du dir jetzt anschauen, wie eine UserApp aufgebaut ist. 

Logge dich in deinem FTP-Programm auf dem Entwicklungs-Server ein, navigiere in den Ordner '''ftp → HeyThere''' und lade dort die Datei '''main.js''' herunter. Du kannst diese Datei jetzt anschauen, verändern und dann wieder dort hochladen. So verstehst du, wie alles funktioniert. 

Die '''main.js''' kannst du sogar im normalen Texteditor anschauen und bearbeiten. 
Empfehlenswert ist das aber nicht.
*Auf Windows kannst du dir (zum Beispiel) [http://notepad-plus-plus.org/ Notepad++] herunterladen.
* Auf macOS kannst du dir (zum Beispiel) [https://itunes.apple.com/de/app/textwrangler/id404010395?mt=12 Textwrangler] herunterladen.
Diese Programme können dir das Entwickeln erleichtern. (Natürlich kannst du auch eine IDE verwenden, wenn du dich damit auskennst.) 

Schau dir den Code jetzt an und nimm einige Veränderungen vor.

Idee: Lass deinen AppBot Besucher abhängig von ihrem Geschlecht begrüßen! Zum Beispiel männliche Besucher mit "Hey Prinz <Nickname>" und weibliche Besucher mit "Hey Prinzessin <Nickname>". Findest du heraus, wie das geht?

→ Jetzt ist ein guter Zeitpunkt, die [https://developer.knuddels.de/docs/ API-Dokumentation] anzuschauen.
Der Aufbau der '''main.js''' wird [https://bitbucket.org/knuddels/user-apps/wiki/Bootstrap/App-Erstellen hier] erklärt.

Gehe danach folgendermaßen vor:
# Verändere die Datei und speichere sie.
# Lade die Datei auf den FTP-Server hoch (ersetze die alte '''main.js''').
# Öffne das App-Menü in deinem Channel mit '''/apps''' und drücke auf '''update/restart'''. Deine App fährt herunter und startet nach wenigen Sekunden erneut - mit deinem neuen Code.

Im nächsten Schritt wird gezeigt, wie man Besucher abhängig von ihrem Geschlecht begrüßen kann.

== Begrüße Besucher abhängig von ihrem Geschlecht ==

So kannst du neuen Besuchern eine Begrüßungsnachricht abhängig von ihrem Geschlecht schicken:

'''main.js'''


<pre>
var App = (new function() {

    this.onUserJoined = function(user) {  // diese Funktion wird aufgerufen, wenn ein Nutzer den Channel betritt

        let gender = user.getGender();
        let nick  = user.getNick();
        let title;

        if (gender == Gender.Male) {
            title = "Prinz " + nick;
        } else if (gender == Gender.Female) {
            title = "Prinzessin " + nick;
        } else {  // der Nutzer hat sich nicht als männlich oder weiblich ausgegeben
            title = nick;
        }

        let message = "Hey " + title + ", willkommen im Channel! Du bist " + user.getAge() + " Jahre alt.";
        user.sendPrivateMessage(message);  // der AppBot sendet eine private Nachricht an den Nutzer
    }
}());
</pre>

Schaffst du es außerdem, die Besucher sowohl abhängig von ihrem Alter, als auch von ihrem Geschlecht zu begrüßen?
→ Begrüße Besucher...
* unter 18 Jahren mit: '''"Hallo Junge <Nickname>"''' bzw. '''"Hallo Mädchen <Nickname>"'''
* zwischen 18 und 60 Jahren mit: '''"Hallo Herr <Nickname>"''' bzw. '''"Hallo Frau <Nickname>"'''
* über 60 Jahren mit: '''"Hallo Opa <Nickname>"''' bzw. '''"Hallo Oma <Nickname>"'''

Schau in die [https://developer.knuddels.de/docs/ UserApps-API-Dokumentation], wenn du eine Funktion suchst.
Den fertigen Code kannst du dir hier herunterladen: [https://bitbucket.org/knuddels/user-apps/downloads/Beispielcode%20HeyThere%20-%20Stufe%202%20-%20Erweiterung.zip Begrüßung nach Alter und Geschlecht] 

Im nächsten Schritt lernst du, wie Besucher '''Knuddel''' an deinen AppBot transferieren können!

== Knuddel überweisen ==

Nutzer können Knuddel an deinen AppBot überweisen. Diese Knuddel kannst du dir dann später auf deinen eigenen Nick überweisen lassen. Hier lernst du, wie du das in deiner UserApp machen kannst.

Der AppBot soll jeden neuen Nutzer nach einem Knuddel fragen. Wenn er diesen bekommt, bedankt er sich bei dem Nutzer.

Auf dem Entwicklungs-Server hat dein Nick so viele Knuddel, dass du das einfach testen kannst.

'''main.js'''
<pre>
var App = (new function() {

    this.onUserJoined = function(user) {
        var appBotNick = KnuddelsServer.getDefaultBotUser().getNick();
        var message = "Gibst du mir _°BB°°>_heinen Knuddel|/appknuddel " + appBotNick.escapeKCode() + "<°°°_?";
        user.sendPrivateMessage(message);
    }

    this.onKnuddelReceived = function(sender, receiver, knuddelAmount, transferReason) {
        sender.sendPrivateMessage("Danke, " + sender.getNick() + "!");
    }
}());
</pre>

=== Erklärung: Was ist KCode? ===

In '''App.onUserJoined''' wird dem Nutzer eine Nachricht mit seltsamen Zeichen gesendet:

"Gibst du mir _°BB°°>_heinen Knuddel|/appknuddel " + appBotNick.escapeKCode() + "<°°°_?"

Das ist [[Formatierungen|KCode]]. Dieser Code wird vor dem Anzeigen umgewandelt, sodass die Nutzer einen Link präsentiert bekommen, auf dessen Klick hin ein Befehl ausgeführt wird: Hier ist dieser Befehl '''/appknuddel <Nickname des AppBots>'''. Mit dem Klicken auf den Link überweist der Nutzer also einen Knuddel an den AppBot.

'''appBotNick.escapeKCode()''' dient dazu, dass der Befehl auch bei Sonderzeichen im Nicknamen deines AppBots richtig ausgeführt wird.

[[Formatierungen|→ Hier kannst du dir anschauen, wie KCode funktioniert.]]

Idee für wahre Kapitalisten: Du kannst den Besucher deines Channels vielleicht dazu bringen, dem AppBot einen Knuddel zu schenken, wenn der AppBot dem Besucher nach einiger Zeit eine traurige Nachricht schreibt, falls er bis dahin keinen Knuddel von dem Besucher erhalten hat.

Eine mögliche Lösung dieses Problems kannst du dir hier anschauen: [https://bitbucket.org/knuddels/user-apps/downloads/Beispielcode%20HeyThere%20-%20Stufe%203%20-%20Erweiterung.zip Download Code-Beispiel (Traurige Nachricht vom AppBot)] 

Im nächsten Schritt lernst du, wie du dauerhaft Daten über deine Besucher speichern kannst.

== UserPersistence: Nutzerdaten speichern ==

Wenn du dir beispielsweise dauerhaft merken willst, wie viele Knuddel ein Nutzer jeweils schon deinem AppBot überwiesen hat, brauchst du eine Möglichkeit, zu jedem Nutzer eine Zahl zu speichern. 

Allerdings kannst du nicht einfach eine Variable in deinem Code haben, worüber du alles speicherst - das wäre nämlich mit jedem Neustart der App wieder weg.

In der [https://developer.knuddels.de/docs/ UserApps-API] gibt es genau dafür das Objekt [https://developer.knuddels.de/docs/classes/UserPersistence.html UserPersistence].

'''main.js'''
<pre>
var App = (new function() {

    this.onUserJoined = function(user) {

        let userPersistence = user.getPersistence();
        let userSpending = userPersistence.getNumber("spending", 0);

        if (userSpending > 10) {
            user.sendPrivateMessage("Willkommen, gütiger Spender!");
        }

        var appBotNick = KnuddelsServer.getDefaultBotUser().getNick();
        var message = "Gibst du mir _°BB°°>_heinen Knuddel|/appknuddel " + appBotNick.escapeKCode() + "<°°°_?";
        user.sendPrivateMessage(message);
    }

    this.onKnuddelReceived = function(sender, receiver, knuddelAmount, transferReason) {
        sender.sendPrivateMessage("Danke, " + sender.getNick() + "!");

        let userPersistence = sender.getPersistence();
        userPersistence.addNumber("spending", knuddelAmount.asNumber());
    }
}());
</pre>

Die App merkt sich nun, wie viele Knuddel deine Besucher bereits eingezahlt haben. Besonders gönnerische Besucher begrüßt er ehrerbietig!

== Dein Fortschitt ==

'''Du bist schon weit gekommen!'''

* Du hast gelernt, wie man sich auf dem Entwicklungs-Server anmeldet und eine App installiert.
* Du hast dich mit FTP vertraut gemacht und kannst deine Dateien jetzt einfach an den Knuddels-Server senden.
* Du weißt jetzt, wie man auf verschiedene Events in deinem Channel reagiert.
* Du bist mit der Überweisung von Knuddel an deinen AppBot vertraut.
* Du kannst Daten über deine Besucher dauerhaft speichern.

Jetzt kannst du deine UserApp mal veröffentlichen! Dazu musst du deine UserApp per FTP auf dem Live-Server hochladen - so wie schon vorher auf dem Entwicklungs-Server. Melde dich dann ganz normal bei Knuddels an und installiere deine UserApp mit '''/apps install <UserApp-Name>''' in deinem MyChannel. 

Und wenn du jetzt noch deinen MyChannel unter '''/mychannel''' veröffentlichst, können auch andere Nutzer zufällig auf deinen MyChannel stoßen. 

== Wie geht's weiter? ==

Vielleicht hast du Lust, ein grafisches Spiel zu programmieren? Oder ein textbasiertes RPG? 
Ab jetzt bist du dir selbst überlassen - und kannst dich natürlich jederzeit an die Community wenden. 
Auf dem Entwickler-Portal [https://developer.knuddels.de/ developer.knuddels.de] findest du das meiste im Zusammenhang mit UserApps.

[[UserApp-Entwicklung|→ Übersicht: UserApp-Entwicklung]]

UserApp-Entwicklung

2019-06-26T16:55:03Z

Tom Unterwegs: Link auf Tutorial-Übersicht und Beginner-Tutorial hinzugefügt.

== Allgemeines ==

Hier findest du alles was du wissen musst, um deine eigene UserApp auf Knuddels zu programmieren. 
Wenn du noch nicht weißt, was eine [[User_App|UserApp]] ist, schau einfach [[User_App|hier]]. 
Einen Überblick über alles im Zusammenhang mit UserApps (auch dieses Wiki) findest du auf dem Entwickler-Portal unter [https://developer.knuddels.de/ developer.knuddels.de].

== Tutorials https://knuddels-wiki.de/images/c/c9/Icon_-_Newbie.gif ==

Wenn du noch keine UserApp entwickelt hast, kannst du das Beginner-Tutorial machen. Dort lernst du Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Beginner-Tutorial]]
 
Hier findest du eine Übersicht über alle Tutorials:
* [[UserApp-Entwicklung/Tutorials]]

== Wichtige Links ==

* [https://developer.knuddels.de/ developer.knuddels.de] - das Entwickler-Portal (Überblick über alles im Zusammenhang mit UserApps)
* [https://developer.knuddels.de/docs/ UserApps-API Docs]
* [https://www.knuddels.de/changelog Changelog]

== Andere UserApps-Entwickler ==

* Wir freuen uns, wenn sich neue Entwickler kurz [https://forum.knuddels.de/ubbthreads.php?ubb=showflat&Number=2704910 im Forum vorstellen]. Aber das ist natürlich kein Muss.
* Die Kommunikation findet über den Discord Server statt. Gib '''/apps developer''' ein und klicke auf den entsprechenden Link. [https://blog.knuddels.de/2018/07/31/kommunikation-zukuenftig-auf-discord/ → Blogeintrag dazu]
* Außerdem gibt es im [https://forum.knuddels.de/ubbthreads.php?ubb=cfrm&c=9 UserApps-Forum] viele Beiträge!

== Die UserApps-API https://knuddels-wiki.de/images/2/29/Quiz-Smiley.gif ==

Willst du mehr über die UserApps-API wissen? Schau mal hier rein:

* [[API|Was ist die UserApps-API?]]
* [https://developer.knuddels.de/docs/ UserApps-API Docs]

== Design & Grafik in UserApps https://knuddels-wiki.de/images/a/a0/Rose.gif ==

UserApps können natürlich auch Grafiken, Animationen und Sounds wiedergeben! Du kannst sogar ein 3D-Spiel als UserApp programmieren!
Mindestens kannst du aber mal '''KCode''' lernen, falls du das noch nicht getan hast.
Schau dir als Einstieg folgende Links an:

* Texte vom AppBot formatieren: [[Formatierungen]]
* Grafische Web-Oberfläche
** [[User_App:HTML-UI/Web|Einführung 1]]
** [https://bitbucket.org/knuddels/user-apps/wiki/HTML-UI/Web Einführung 2]
** [https://bitbucket.org/knuddels/user-apps/wiki/HTML-UI/Environment Besonderheiten der HTML-UI (Environment)]

== Technische Infos ==

* [https://bitbucket.org/knuddels/user-apps/wiki/Development Development] - einige Basics und technische Infos
* [[Limits|Technische Limits]] für UserApps

== Bugs ==

Wenn du einen Bug bemerkt hast, kannst du jemanden im '''/team bugs''' anschreiben.
Deine Ideen und Wünsche kannst du mit uns auf Discord teilen.

UserApp-Entwicklung

2019-06-26T16:46:52Z

Tom Unterwegs: Technische Limits verweist jetzt auf den Artikel im Wiki (ehem. bitbucket)

== Allgemeines ==

Hier findest du alles was du wissen musst, um deine eigene UserApp auf Knuddels zu programmieren. 
Wenn du noch nicht weißt, was eine [[User_App|UserApp]] ist, schau einfach [[User_App|hier]]. 
Einen Überblick über alles im Zusammenhang mit UserApps (auch dieses Wiki) findest du auf dem Entwickler-Portal unter [https://developer.knuddels.de/ developer.knuddels.de].

== Tutorial für Anfänger https://knuddels-wiki.de/images/c/c9/Icon_-_Newbie.gif ==

In [https://bitbucket.org/knuddels/user-apps/wiki/Tutorial diesem Tutorial] lernst du Schritt für Schritt, deine erste UserApp zu programmieren: → [https://bitbucket.org/knuddels/user-apps/wiki/Tutorial Tutorial] 
Alternativ gibt es noch [[User_Apps/Tutorial|dieses Tutorial]].

== Wichtige Links ==

* [https://developer.knuddels.de/ developer.knuddels.de] - das Entwickler-Portal (Überblick über alles im Zusammenhang mit UserApps)
* [https://www.knuddels.de/changelog Changelog]
* [https://developer.knuddels.de/docs/ UserApps-API Docs]

== Andere UserApps-Entwickler ==

* Wir freuen uns, wenn sich neue Entwickler kurz [https://forum.knuddels.de/ubbthreads.php?ubb=showflat&Number=2704910 im Forum vorstellen]. Aber das ist natürlich kein Muss.
* Die Kommunikation findet über den Discord Server statt. Gib '''/apps developer''' ein und klicke auf den entsprechenden Link. [https://blog.knuddels.de/2018/07/31/kommunikation-zukuenftig-auf-discord/ → Blogeintrag dazu]
* Außerdem gibt es im [https://forum.knuddels.de/ubbthreads.php?ubb=cfrm&c=9 UserApps-Forum] viele Beiträge!

== Die UserApps-API https://knuddels-wiki.de/images/2/29/Quiz-Smiley.gif ==

Willst du mehr über die UserApps-API wissen? Schau mal hier rein:

* [[API|Was ist die UserApps-API?]]
* [https://developer.knuddels.de/docs/ UserApps-API Docs]

== Design & Grafik in UserApps https://knuddels-wiki.de/images/a/a0/Rose.gif ==

UserApps können natürlich auch Grafiken, Animationen und Sounds wiedergeben! Du kannst sogar ein 3D-Spiel als UserApp programmieren!
Mindestens kannst du aber mal '''KCode''' lernen, falls du das noch nicht getan hast.
Schau dir als Einstieg folgende Links an:

* Texte vom AppBot formatieren: [[Formatierungen]]
* Grafische Web-Oberfläche
** [[User_App:HTML-UI/Web|Einführung 1]]
** [https://bitbucket.org/knuddels/user-apps/wiki/HTML-UI/Web Einführung 2]
** [https://bitbucket.org/knuddels/user-apps/wiki/HTML-UI/Environment Besonderheiten der HTML-UI (Environment)]

== Technische Infos ==

* [https://bitbucket.org/knuddels/user-apps/wiki/Development Development] - einige Basics und technische Infos
* [[Limits|Technische Limits]] für UserApps

== Bugs ==

Wenn du einen Bug bemerkt hast, kannst du jemanden im '''/team bugs''' anschreiben.
Deine Ideen und Wünsche kannst du mit uns auf Discord teilen.

UserApp-Entwicklung/Tutorials

2019-06-26T16:03:06Z

Tom Unterwegs: Hier werden alle Tutorials gesammelt, nach Themen und Schwierigkeitsgrad gegliedert. Kann gerne ergänzt werden.

Hier ist eine Sammlung aller Tutorials zur UserApp-Entwicklung.

== Beginner ==
Hier lernst du Schritt für Schritt, deine erste UserApp zu programmieren.
* [[UserApp-Entwicklung/Tutorials/Beginner|Tutorial für Beginner]]

== Weitere Tutorials ==

* [[User_Apps/Tutorial]]

UserApp-Entwicklung

2019-06-26T14:46:24Z

Tom Unterwegs: Seite neu angelegt um das UserApps-Wiki zwecks Zentralisierung von bitbucket hierher umzuziehen.

== Allgemeines ==

Hier findest du alles was du wissen musst, um deine eigene UserApp auf Knuddels zu programmieren. 
Wenn du noch nicht weißt, was eine [[User_App|UserApp]] ist, schau einfach [[User_App|hier]]. 
Einen Überblick über alles im Zusammenhang mit UserApps (auch dieses Wiki) findest du auf dem Entwickler-Portal unter [https://developer.knuddels.de/ developer.knuddels.de].

== Tutorial für Anfänger https://knuddels-wiki.de/images/c/c9/Icon_-_Newbie.gif ==

In [https://bitbucket.org/knuddels/user-apps/wiki/Tutorial diesem Tutorial] lernst du Schritt für Schritt, deine erste UserApp zu programmieren: → [https://bitbucket.org/knuddels/user-apps/wiki/Tutorial Tutorial] 
Alternativ gibt es noch [[User_Apps/Tutorial|dieses Tutorial]].

== Wichtige Links ==

* [https://developer.knuddels.de/ developer.knuddels.de] - das Entwickler-Portal (Überblick über alles im Zusammenhang mit UserApps)
* [https://www.knuddels.de/changelog Changelog]
* [https://developer.knuddels.de/docs/ UserApps-API Docs]

== Andere UserApps-Entwickler ==

* Wir freuen uns, wenn sich neue Entwickler kurz [https://forum.knuddels.de/ubbthreads.php?ubb=showflat&Number=2704910 im Forum vorstellen]. Aber das ist natürlich kein Muss.
* Die Kommunikation findet über den Discord Server statt. Gib '''/apps developer''' ein und klicke auf den entsprechenden Link. [https://blog.knuddels.de/2018/07/31/kommunikation-zukuenftig-auf-discord/ → Blogeintrag dazu]
* Außerdem gibt es im [https://forum.knuddels.de/ubbthreads.php?ubb=cfrm&c=9 UserApps-Forum] viele Beiträge!

== Die UserApps-API https://knuddels-wiki.de/images/2/29/Quiz-Smiley.gif ==

Willst du mehr über die UserApps-API wissen? Schau mal hier rein:

* [[API|Was ist die UserApps-API?]]
* [https://developer.knuddels.de/docs/ UserApps-API Docs]

== Design & Grafik in UserApps https://knuddels-wiki.de/images/a/a0/Rose.gif ==

UserApps können natürlich auch Grafiken, Animationen und Sounds wiedergeben! Du kannst sogar ein 3D-Spiel als UserApp programmieren!
Mindestens kannst du aber mal '''KCode''' lernen, falls du das noch nicht getan hast.
Schau dir als Einstieg folgende Links an:

* Texte vom AppBot formatieren: [[Formatierungen]]
* Grafische Web-Oberfläche
** [[User_App:HTML-UI/Web|Einführung 1]]
** [https://bitbucket.org/knuddels/user-apps/wiki/HTML-UI/Web Einführung 2]
** [https://bitbucket.org/knuddels/user-apps/wiki/HTML-UI/Environment Besonderheiten der HTML-UI (Environment)]

== Technische Infos ==

* [https://bitbucket.org/knuddels/user-apps/wiki/Development Development] - einige Basics und technische Infos
* [https://bitbucket.org/knuddels/user-apps/wiki/Limits/ Limits] - Daten-Limits für UserApps

== Bugs ==

Wenn du einen Bug bemerkt hast, kannst du jemanden im '''/team bugs''' anschreiben.
Deine Ideen und Wünsche kannst du mit uns auf Discord teilen.