Pixotope API - Message Scheme

Command used to fetch the current value of a state or non-state value on a Service. Try to avoid continuous polling, instead subscribe to Update-messages and just listen to changes.

Template

Example

When Receiving

When you are receiving this someone is asking about the state or a non-state value.

• Return the value via an Update-command targeted to them

• If you don’t have this value, return "Value":"null" in the message

  • optionally send a log message of type Warning (more on the Log command below).

Command used by a Service that attempts to change the state or a non-state value of another service. It is not guaranteed to have any effect and does not include information about the sender. You can set things inside the state struct or on specific exposed values.

Template

Example 1

Example 2

When Receiving

When someone sends this message they probably expect you to change your singleton state, part of it, or something else to the new value. If you do that (you are also free to refuse it), remember to send an Update command afterwards (more on Update below).

Command used to reset the state of a Service to default.

Template

Example

When Receiving

When you are receiving this, there is likely some disconnection of the current context happening.

• Reset or return to a "baseline" and/or a generic start state

  • When setting this default state, remember to send an Update-message to notify listeners

Used when the state of a Service changes. This command should be sent every time there is a change. Services decide whether they want to listen to these updates or not.

It is also sent as a response to a Get request. In this case the "RespondTo"-field of the Get request is used as the "Target" of the Update message.

Template

Example 1

Example 2

{
  "Value": {
    "Owner":"'PostProcessHandler_0",
    "ObjectSearchTag": "post_process_handler",
    "Path": "Settings.",
    "Name": "bOverride_SceneFringeIntensity",
    "PrettyName": "Override Scene Fringe Intensity",
    "Type": "bool",
    "AdjustmentStatus": "MODIFIED",
    "Value": "True"
  }
}

Example 3

When Receiving

When receiving this message, it means a value you had subscribed to has been updated or a value you have asked for has been retrieved.

It’s up to you if you want to do something with this or not, but if you don’t you probably want to unsubscribe in order to not waste network resources.

Used by the central server to get information about connected Services, if you don’t respond you won't be considered connected (and won’t appear in Store’s ConnectedClients).

Template

Example 1

Example 2

When Receiving

When receiving this message you should respond with a Self command to the one asking, or other services won’t be able to find you (more on the Self command below).

Sent as an answer to the Identify-request OR directly when coming online to avoid having to wait for the next heartbeat before coming online.

Note: If you have a state, use the Startup command instead.

In this case "Role" is referring to the name of the service, for example "Engine".

Template

Example

When Receiving

Only Store is expected to receive this message, if you should receive it (as a normal Service) you probably want to unsubscribe.

Sent by any service that maintains a State when connecting to a network. This will make "Store" go through its memory, find the proper settings for the current Show that you should use and send that to you as a Set message.

Template

Example

When Receiving

Only "Store" is expected to receive this message, if you should receive it (as a normal Service) you probably want to unsubscribe.

Logging over the network. "Message" and "Code" are always strings. The Code field is optional and does not have to be included.

Template

Example 1

Example 2

When Receiving

You’d only get this if you subscribed to logs from somewhere, and if you did you should have some idea of what you want to do with it.

Every service can define custom endpoints for executing actions (not only getting data). These RPC-style function calls can then be triggered.

A "Method" is supposed to have named parameters and follow the PascalCase naming convention.

The "ID" is a unique identifier of this specific call.

Template

Example

When Receiving

If the service doesn’t have any remote function calls implemented, this message can be ignored.

Otherwise, when receiving this message the service should parse the method and arguments and execute the corresponding code. Then the CallResult message should be sent as a response, targeted at the service defined in the "RespondTo" field of the original Call message, passing through the received "ID".

Communicates a result of an RPC executed with a Call command. Depending on whether the original call succeeded or failed the message should contain the "Result" or "Failure" field. The "Result" field is always an object. The "Failure" field can be either a string or an object.

Template

Example 1

Example 2

Example 3

Example 4

When Receiving

When receiving, it should be parsed by services interested in receiving back the results of an RPC they called.