Join one- or more rooms in a collection. A successful join request will respond with an array of equal length of the number of rooms to join.
Syntax
[scope, ...IDs]
The IDs parameter accepts either room-IDs or room-names to designate the desired rooms for joining.
Room names require ThingsDB version 1.7.0 or higher.
The socket needs to be authorized before sending a join request.
See the auth example for how to authorize a socket connection.
As an example we assume that we want to listen to a room with Id 17 for events. Instead of a single ID, we could add as much IDs as we wanted. As an example we also add room Id 456 which does not exist in our collection.
This is the data we want to pack (join room Ids 17 (exists in out collection) and 456 (does not exist)):
["//stuff", 17, 456]
Serializing the above using MessagePack results in the following 13 bytes:
\x93\xa7//stuff\x11\xcd\x01\xc8
Now we create the header. For this example we just use Id 0:
\x0d\x00\x00\x00\x00\x00\x260xd9Sending the Join package
\x0d\x00\x00\x00\x00\x00\x26\xd9\x93\xa7//stuff\x11\xcd\x01\xc8
Responding [17, nil] package (room Id 17 is found, the second (456) was not)
\x03\x00\x00\x00\x00\x00\x12\xed\x92\x11\xc0
A few seconds (or less) later, you will receive a on-join event on the socket connection for every joined room.
See the listening documentation for more information.
Responding {id: 17} package for room 17 which was joined in our example:
\x05\x00\x00\x00\xff\xff\x06\xf9\x81\xa2id\x11