HoloPlayCore.Message
Last updated
Was this helpful?
Last updated
Was this helpful?
A class to represent messages being sent over to HoloPlay Service. This is the base class, and users should aim to use the child classes that we provide below if possible unless you need a very specific custom Message. If you use the base class, you will have to construct the objects yourself.
All Message classes have cmd
, and only quilt related ones have bin
for binary data of the quilt.
See here for a list of .
cmd
object of the corresponsding settings for each command type.
bin
binary data of the quilt, if it is a quilt-related message.
Examples
.toCbor()
Convert the class instance into CBOR format.
Extends Message
Extends the base Message class. If you provide following parameters in the constructor of HoloPlayCore.Client
, this command will be called automatically, and you don't need to call it yourself.
Parameters
appId
string optional; an identifier to specify what application it is in HoloPlay Service. If the same appId is provided, different connections will be treat as the same application and have access to cached quilts. If not provided, HoloPlay Service will generate a random string.
isGreedy
boolean optional; this feature is currently not implemented.
oncloseBehavior
string optional, determines behavior when all instances of a given app ID disconnect. Can be wipe
, hide
, or none
, default is hide
.
wipe
: clear the screen, display the default background.
hide
: hide the window on the Looking Glass.
none
: do nothing.
debug
boolean optional; default is false
. If true, there will be logging messages in console.
Examples
Extends Message
Extends the base Message class. Gets info from HoloPlay Service.
Examples
Extends Message
Extends the base Message class. Show a quilt directly without caching it.
Parameters
bindata
Uint8Array, optional, default ''
, but you will have to set it later.
targetDisplay
int, optional, default 0
.
Examples
Extends Message
Extends the base Message class. This message sends a quilt image to the cache, and you can send a ShowCachedMessage
later to show it.
Parameters
name
string, the name of the quilt being cached, for later retrieval.
bindata
(optional, default ''
).
show
(optional, default false
).
Extends Message
Extends the base Message class. Retrieve and show a previously cached quilt by name. If you're not sure if a quilt is cached, use the CheckMessage
command to check. If you try to show an uncached image, HoloPlay Service will respond with error code 3.
Parameters
name
string, the name of the quilt in the cache.
targetDisplay
int, optional, default 0
.
Extends Message
Check if a quilt exist in the cache. Extends the base Message class.
Parameters
name
string name of the quilt (optional, default ''
).
Example
Extends Message
Extends the base Message class. Deletes a previously cached quilt from HoloPlay Service.
Parameters
name
string; name of the quilt.
Extends Message
Extends the base Message class. Wipes the image in Looking Glass and displays the background image.
Parameters
targetDisplay
(optional, default 0
).
Returns information of the connected Looking Glass devices, in the format of .
Returns information of the connected Looking Glass devices, in the format of .
settings
object optional, default {vx: 1,vy: 1,aspect:1.6}
, for detailed format see .
settings
object optional, default {vx:1,vy:1,aspect:1.6}
, for detailed format see .
settings
object optional, default {vx:5,vy:9,aspect:1.6}
, for detailed format see . (THERE'S STILL INCONSISTENCY IN WHAT THE DEFAULT SETTINGS ARE, NEEDS TO BE RESOLVED)