Annikka/evennia
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update docstring for webclient server component.

Browse source
This commit is contained in:
Griatch 2016-09-14 19:33:50 +02:00
parent 67411d006d
commit 14e9dafda2
1 changed files with 5 additions and 18 deletions
Download patch file Download diff file Expand all files Collapse all files

23
evennia/server/portal/webclient.py
View file

@ -5,26 +5,13 @@ This implements a webclient with WebSockets (http://en.wikipedia.org/wiki/WebSoc
by use of the txws implementation (https://github.com/MostAwesomeDude/txWS). It is by use of the txws implementation (https://github.com/MostAwesomeDude/txWS). It is
used together with evennia/web/media/javascript/evennia_websocket_webclient.js. used together with evennia/web/media/javascript/evennia_websocket_webclient.js.
Thanks to Ricard Pillosu whose Evennia plugin inspired this module. All data coming into the webclient is in the form of valid JSON on the form
Communication over the websocket interface is done with normal text `["inputfunc_name", [args], {kwarg}]`
communication. A special case is OOB-style communication; to do this
the client must send data on the following form:
OOB{"func1":[args], "func2":[args], ...} which represents an "inputfunc" to be called on the Evennia side with *args, **kwargs.
The most common inputfunc is "text", which takes just the text input
where the dict is JSON encoded. The initial OOB-prefix is used to from the command line and interprets it as an Evennia Command: `["text", ["look"], {}]`
identify this type of communication, all other data is considered
plain text (command input).
Example of call from a javascript client:
var websocket = new WebSocket("ws://localhost:8021");
var msg1 = "WebSocket Test";
websocket.send(msg1);
var msg2 = JSON.stringify({ testfunc: [[1, 2, 3], { kwarg: "val" }] });
websocket.send("OOB" + msg2);
websocket.close();
""" """
import re import re