You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

4.9 KiB

categories date description pad git slug title css script
Web
JS
WS
17/02/2023 Websocket workshop for multiplayer drawing https://pad.xpub.nl/p/wsjsws https://git.xpub.nl/kamo/drw ws-js-ws Multi surface multi player multi drawings drw.css drw.js

Contents

A one-day workshop about real-time interactions with websockets!

Starting from a simple drawing app, we are going to explore how to create multiplayer online applications that deal with inputs coming from multiple users connected at the same time.

No previous knowledge nedeed, but some HTML & CSS & JS will come handy. Bring your own laptop and lunch! Snacks and coffee will be offered!

When and where

Friday 24th, from 11:00 to 17:00
XPUB Studio, 4th floor etc

Program

  • 11:00 - Intro & demo of drw

  • 11:30 - How does it work

  • 12:00 - Step by step installation

  • 12:30 - Examples & brainstorm for projects

  • 13:00 - Lunch break

  • 14:00 - Prototyping

  • 16:00 - Upload online

  • 16:30 - Try out and presentation

Intro

DRW is a small app for multiplayer drawing in real time.
To draw connect to → hub.xpub.nl/soupboat/drw/

It works with multiple sources, but also multiple destinations.

The same drawings can be displayed on different places! (such as this page)

Open hub.xpub.nl/soupboat/drw/destination and send some drawings.
Try to navigate to hub.xpub.nl/soupboat/drw/wander to see a different mode.

How does it work

ping pong is my passion

Websockets

DRW is like ping pong!

Sources and destinations send each other small messages using a protocol called websockets.

Once a websocket connection is open, they can communicate in both directions. From the source to the destination and the other way around!

Websockets are great for applications that require continous data exchange, such as chat and games.

DRW Architecture

Two types of entities:

  • Clients
  • Server

Every client is connected to the server, either as a source or as a destination.

Depending on their role, clients send different kinds of messages to the server.

The server manages the flow of websocket messages, taking care to deliver the right message to the right client.

Message

In this app, a message is a simple text string.
It looks like

{"type": "test", "data": "this is my test message"}

Here the message has two properties: type with value test, and data with value this is my test message.

Using the JSON format, the message contents can be accessed easily.


// The websocket message arrives as text string
let text = '{"type": "test", "data": "this is my test message"}'

// Transform the string message into an object
let message = JSON.parse(text)

// Access the contents of the message
console.log(message.type)
// test

console.log(message.data)
// this is my test message

(console.log() in Javascript is like print() in Python)

Installation

What do you need:

Find the step to step process to install DRW here --> Documentation

Examples & Brainstorm

The DRW app is just the beginning! From here it can be extended with diverse sources and destinations.

Depending on participants' interest the workshop can continue in different directions:

  1. Same server, different destinations.
    To keep working with drawings and prototyping different ways of displaying them.
    For example to work with other web pages or programming environment such as p5js, vvvv, etc.
    But also physical hardware such as receipt printer or pen plotter.
    Here we tinker with the client side.

  2. Same architecture, different server. To play with the same multiplayer setup, but with different kind of contents. To work with sound or text, 3d environments and such.
    Here we mess with both the server and the client sides