DizmoLive

The standard dizmoSpace software includes sharing one or more dizmos, through a Pad dizmo, with other devices and/or users on a local network. With the dizmoLive service, you can share live the same Pad dizmo with one or more users at the same time, on any device and any location. Multiple sessions can be run in parallel, allowing any combination of Pad, dizmos and device/users connections.

All dizmos can be shared through a Pad.

Only persisted data of a dizmo is replicated over dizmoLive. This means, the state or any other information of a dizmo is only shared across dizmoLive, when it was stored in the dizmo data tree.

Assume your dizmo has an inputfield where users can enter data. By default, the content of the inputfield will not be shared across dizmoLive, since only persistent data in the dizmo data tree is replicated over dizmoLive.

There are three ways to accept incoming dizmoLive connection requests:

  1. Ask user: This is the default way to accept incoming dizmoLive connection requests with a Popup.
  2. Silent Live: DizmoSpace will accept any incoming dizmoLive connection immediately.
  3. Do Not Disturb: This will block all incoming Live requests (no Popup will appear).

You can set these properties with:

viewer.setAttribute("settings/linkacceptmode","askuser");
viewer.setAttribute("settings/linkacceptmode","silentlive");
viewer.setAttribute("settings/linkacceptmode","donotdisturb");

you can also get the current mode with:

var status=viewer.getAttribute("settings/linkacceptmode");

To get a list of open dizmoLive connections, use this function:

var connections = viewer.getLiveConnections();

This will return an array of connected hostnames/ip-adresses. Use one of those hostnames/ip-adresses to get more details about that dizmoLive connection:

var connection=viewer.getLiveConnectionInfo(hostname);

This will return the username of the connected dizmo space, the timestamp when the connected started and an array of dizmo instances currently shared.

There are also two functions that you can subscribe a callback to so that you are notified about new or closed dizmoLive connections.

var subscrId=viewer.onLiveConnectionAdded(callback);
var subscrId=viewer.onLiveConnectionRemoved(callback);

Unsubscribe from both subscriptions with

viewer.unsubscribeLiveConnection(subscrId);