A state is a value Space CE publishes as the room runs. Macro triggers match on states, and so do visibility conditions. This page lists every state available for configuration, what type it carries, and which CE version introduced it.
A trigger names the publishing object and the state, adds a key for keyed states, and gives the value to match:
| Field | What to put in it |
|---|---|
| Guid | The publishing object. For a manager this is the identifier shown beside its name below. For a device it is that device’s own ID. |
| Property | The state name, exactly as listed. |
| Key | Only for keyed states. The Key column says what the key is, for example an AV Source ID. |
| Value | The value to match. Matching is exact and case sensitive. |
- A guid is the name an event trigger uses to reference a manager or device:
audio.manager. - A binding is the name a macro script uses to call the same manager or device,
audioinaudio.SetAudioMute(...), and the name a visibility condition reads it by. - This page lists each state’s guid and Available Actions lists each action’s binding. Use each exactly as listed.
Manager States
Published by the room and its managers. Each manager’s guid, the value a trigger must
match, is shown beside its title.
Room Controller guid: "room"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
RoomMode | string | The room's current mode: "Off" or one of the Room Modes defined in the configuration, such as "Presentation".
| 2.0.0 | |
PowerIsOn | boolean | Whether the room is powered on, meaning the current Room Mode is anything other than "Off".
| 2.0.0 | |
SourceSelect | string | Destination Type (e.g. Main, Preview); plus "All" | The AV Source ID currently routed to each Destination Type: "Off" when powered off, "None" when deselected.
| 2.0.0 |
SourceIsSelected | boolean | AV Source ID (e.g. source.pc) | Whether the source is currently routed to at least one destination in the room. | 2.0.0 |
SourceHasSync | boolean | AV Source ID (e.g. source.pc) | Whether the source's configured Video Sync Devices report a live video signal. | 2.8.0 |
DestinationGroupSourceSelect | string | Destination group label | The AV Source ID currently routed to the Destination Group: "Off" or "None" when its destinations are all powered off or deselected.
| 2.7.4 |
ToggleStates | boolean | Toggle ID | True/false flags flipped with the room Toggle action, typically from a macro behind a UI or keypad button.
| 2.7.4 |
ImageMuted | boolean | Whether room-wide image mute is active, hiding video on every AV Destination through its Source Deselection Behaviour.
| 2.0.0 | |
AnyAudioSourceDuplicated | boolean | Whether the same audio origin, resolved through each source's Audio Encoder ID, is feeding more than one Destination Type at once.
| 2.11.0 | |
HasUndockedMicrophones | boolean | Whether the number of wireless microphones docked at the room's Microphone Stations is below the configured Total Dockable Microphone Quantity. | 2.4.0 | |
RoomOccupied | boolean | Whether any of the room's occupancy sensors currently reports occupied. | 2.0.0 | |
AutoShutdownCountdown | integer | Seconds remaining until the room automatically powers off, armed by the Time Based Shutdown time or a meeting-end shutdown.
| 2.0.0 | |
PanelIsLocked | boolean | Whether the touch panel lock is engaged. CE locks the panel on a lock request or after the inactivity timeout. | 2.0.0 | |
Ready | boolean | Whether the room has finished initialising, with configuration loaded and devices created.
| 2.0.0 |
Audio Manager guid: "audio.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
ChannelAudioMute | boolean | Audio channel ID | Whether the audio channel is muted, updated from the touch panel, macros, or mute feedback from the DSP. | 2.0.0 |
ChannelAudioLevel | integer | Audio channel ID | The audio channel's current level (0-100).
| 2.0.0 |
ChannelSignal | boolean | Audio channel ID | Whether the DSP reports signal present on the audio channel.
| 2.18.0 |
ChannelPower | boolean | Audio channel ID | Whether phantom or line power is on for the audio channel, as reported by the DSP.
| 2.12.0 |
CeilingMicsMuted | boolean | Whether the room's Ceiling Microphones are muted as one set.
| 2.0.0 | |
MicPowerState | boolean | Microphone ID | Whether the wireless microphone's transmitter is switched on, as reported by its Microphone Receiver. | 2.15.1 |
MicBatteryLevels | integer | Microphone ID | The wireless microphone's battery charge percentage (0-100), reported by its Microphone Receiver. | 2.15.1 |
MicBatteryHealthLevels | integer | Microphone ID | The wireless microphone battery's health as a percentage of its original capacity, reported by its Microphone Receiver. | 2.23.0 |
SourceLevel | integer | AV Source ID | The Program Audio level remembered for each AV source, reapplied when that source is selected again.
| 2.0.0 |
SourceMute | boolean | AV Source ID | The Program Audio mute state remembered for each AV source, reapplied when that source is selected again.
| 2.0.0 |
Video Manager guid: "video.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
DisplayPower | boolean | Display ID | Whether the display is powered on, tracking the commands CE sends rather than power feedback from the display.
| 2.15.1 |
SecondaryInputActive | boolean | Display ID | Whether the display has been switched to its configured "Secondary Input" instead of its "Default Input".
| 2.15.2 |
ContentScenesPreset | string | Content Layout ID | The ID of the scene currently active on the Content Layout (video wall), as defined under that layout's Scenes.
| 2.18.0 |
ScreenPositions | string | Screen motor ID ("<display ID>$<motor ID>") | The last position CE drove the projection screen motor to: "down" after an extend and "up" after a retract.
| 2.15.1 |
Camera Manager guid: "camera.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
CameraSelected | boolean | Camera ID | Whether this is the room's currently selected camera.
| 2.0.0 |
CameraPower | boolean | Camera Device ID | Whether the camera is powered on, updated from the camera driver's power feedback.
| 2.0.0 |
Document Camera Manager guid: "document.camera.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
CurrentlySelectedDocCam | string | The ID of the document camera source currently selected on the touch panel, or empty when none has been selected yet. | 2.12.0 |
Media Player Manager guid: "media.player.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
MediaPlayerStatuses | string | Media player ID | The media player's transport state as reported by its device driver.
| 2.18.0 |
Room Link Manager guid: "room.link.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
CurrentLinkStatus | string | This room's role in a room link: "primary", "secondary", or "unlinked". | 2.12.0 | |
AvailableForLinking | boolean | Whether this room can currently join another room's link as a secondary, as broadcast to its configured partner rooms.
| 2.10.4 | |
SecondaryRoomsStatus | string | Partner room ID (as configured under Room Link) | The link relationship with each configured partner room: "primary", "secondary", or "unlinked".
| 2.0.0 |
Sensor Manager guid: "sensor.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
SensorOccupancy | boolean | Sensor ID | Whether an occupancy sensor currently detects presence.
| 2.0.0 |
EwisTriggered | boolean | Whether any configured EWIS (Early Warning and Intercommunication System) sensor is currently triggered.
| 2.18.0 | |
SensorShutdownCountdownSeconds | integer | Seconds remaining before the sensor-based automatic shutdown sets the Room Mode to "Off". | 2.0.0 |
Pod Manager guid: "pod.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
ActivePodId | string | The ID of the pod currently sharing its local source to the other pods, or empty when no pod is sharing.
| 2.15.1 | |
PodRoomModes | string | Pod ID | Each pod's own mode: "On", "Group Mode", or "Off".
| 2.15.1 |
PodSourceSelect | string | Pod ID | The pod local source each pod has routed to its pod displays, or "None" or "Off" after a deselection or pod shutdown.
| 2.15.1 |
PodAudioLevel | integer | Pod ID | The level of each pod's Pod Audio fader (0-100), following the DSP feedback for the channel named by the pod's Audio Source ID. | 2.15.1 |
PodAudioMute | boolean | Pod ID | Whether each pod's Pod Audio fader is muted, following the DSP feedback for the channel named by the pod's Audio Source ID.
| 2.15.1 |
AutoShareToPods | boolean | Whether the source on the Lecturer Destination is shared to every pod that is not "Off".
| 2.15.1 |
HVAC Manager guid: "hvac.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
HvacZonesActive | boolean | HVAC zone ID | Whether an HVAC zone is currently active.
| 2.15.1 |
Recording Manager guid: "record.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
RecorderTransportState | string | The current transport state reported by the recorder, typically "Record", "Pause", or "Stop".
| 2.0.0 | |
CurrentRecordingTimeRemaining | integer | Minutes remaining in the current recording, as reported by the recorder. | 2.0.0 | |
RecorderAudioMute | boolean | Whether the recorder's audio feed is muted, following mute feedback for the DSP channels configured under Recorder Audio Mute. | 2.15.1 | |
HasAudioSync | boolean | Whether the recorder detects audio on its configured audio input. | 2.4.0 | |
VideoInputSync | boolean | "video 1" or "video 2" | Whether a recorder video input has video sync.
| 2.15.1 |
Conferencing Manager guid: "conferencing.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
CallStatus | string | The codec's collapsed call state: "Idle", "Dialling", "Ringing", or "InCall".
| 2.24.0 |
Timer Manager guid: "timer.manager"
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
TimerStatuses | string | Timer ID | The run state each timer's device reports: "Idle", "Running", "Paused", "Elapsed", or "Unknown".
| 2.19.0 |
TimerModes | string | Timer ID | The ID of the mode entry each timer is currently in, as configured under its Modes list (for example "mode.2", not the mode type "timer").
| 2.19.0 |
TimerColours | string | Timer ID | The ID of the colour entry each timer is currently showing, as configured under its Colours list, or empty when the reported colour has no matching entry. | 2.19.0 |
TimerDisplayValue | integer | Timer ID | Each timer's count in whole seconds, captured when the timer last started, paused, reset or had its duration changed.
| 2.20.0 |
Device States
Published by individual devices. The trigger Guid is that device’s own ID, taken from the Devices section of the room configuration.
Any Device
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
IsConnected | boolean | Whether CE's connection to the device is open.
| 2.0.0 | |
IsCommunicating | boolean | Whether the device is responding to CE's polls and commands. Goes false when responses stop or the connection drops.
| 2.0.0 |
Display
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
PowerIsOn | boolean | Whether the display's power is on.
| 2.0.0 | |
Warming | boolean | Whether the display is in its warm-up interval after a power on.
| 2.0.0 | |
Cooling | boolean | Whether the display is in its cool-down interval after a power off.
| 2.0.0 | |
HasVideoSync | boolean | Whether the display detects an active video signal on its currently selected input. | 2.0.0 | |
VideoInput | string | The display's currently selected video input, published as a standard CE input name such as "Hdmi1" or "DisplayPort1".
| 2.0.0 | |
VideoMuteIsOn | boolean | Whether the display's video mute is on, blanking the picture at the device while it stays powered.
| 2.0.0 | |
VideoFreezeIsOn | boolean | Whether the display's video freeze is on, holding the last frame on screen. | 2.0.0 | |
MuteIsOn | boolean | Whether the display's own audio output is muted.
| 2.0.0 | |
Volume | integer | The display's own volume level as a percentage, where 0 is the display's minimum volume and 100 is its maximum.
| 2.0.0 |
Camera
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
PowerIsOn | boolean | Whether the camera's power is on.
| 2.0.0 | |
Tracking | boolean | Whether the camera's automatic tracking (for example presenter tracking) is on.
| 2.0.0 | |
CurrentPreset | string | The preset value most recently recalled or stored on the camera.
| 2.0.0 |
Document Camera
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
PowerIsOn | boolean | Whether the document camera's power is on.
| 2.0.0 | |
LampState | boolean | Whether the document camera's lamp is on. | 2.0.0 | |
AutoFocus | boolean | Whether the document camera's auto focus is enabled. Manual focus near and focus far commands turn it off. | 2.4.0 | |
VideoFreeze | boolean | Whether the document camera's video freeze is on, holding the current image on its video output. | 2.4.0 | |
ZoomLevel | integer | The document camera's current zoom level. The value scale is driver-dependent. | 2.0.0 | |
CurrentPreset | string | The preset value most recently recalled or stored on the document camera.
| 2.0.0 |
IPTV
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
PowerIsOn | boolean | Whether the set-top box's power is on.
| 2.0.0 | |
CurrentChannel | string | The channel most recently recalled on the set-top box.
| 2.0.0 |
Timer
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
CurrentStatus | string | The timer's current run state: "Idle", "Running", "Paused", or "Elapsed".
| 2.19.0 | |
CurrentMode | string | The timer's operating mode: "Clock" shows the time of day, "Timer" counts down, and "Stopwatch" counts up. | 2.19.0 | |
TimeRemaining | integer | The number of seconds remaining on the countdown, only meaningful in "Timer" mode.
| 2.19.0 | |
CurrentColour | string | The colour string most recently set on the timer display, for example "#FF0000".
| 2.19.0 |
Motor
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
Position | string | The motor's reported position or movement state, such as "Extended", "Extending", "Retracted", or "Retracting".
| 2.0.0 |
Bluetooth
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
SinkStatus | string | The state of the Bluetooth audio sink: "Idle", "Discoverable", "Paired", or "Connected".
| 2.19.0 |
Lighting Controller
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
CurrentPresets | boolean | Preset GUID | Whether the Lighting Preset is active.
| 2.22.0 |
ToggleStatus | boolean | Toggle GUID | Whether a Lighting Toggle is on: true when its Area's current preset is the toggle's on preset, false when it is the off preset.
| 2.0.0 |
CurrentChannelLevels | integer | Fader GUID | The level of a Lighting Fader as a percentage (0-100), reported from the first channel in its Channels list.
| 2.0.0 |
DSP
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
FaderVolume | integer | Fader GUID | The volume of a DSP fader as a percentage (0-100).
| 2.0.0 |
FaderMute | boolean | Fader GUID | Whether a DSP fader is muted.
| 2.0.0 |
FaderSignalPresent | boolean | Fader GUID | Whether the DSP detects an audio signal on a fader's metering block.
| 2.0.0 |
PhantomLinePower | boolean | Fader GUID | Whether phantom or line power is on for a fader's "Power" block.
| 2.12.0 |
CurrentPreset | string | The most recently recalled preset value, as sent by the recall command. | 2.0.0 |
Encoder / Decoder
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
VideoStream | string | The video stream currently set on the device: the stream an encoder transmits, or the stream a decoder receives.
| 2.0.0 | |
AudioStream | string | The audio stream currently set on the device: the stream an encoder transmits, or the stream a decoder receives.
| 2.0.0 | |
HasVideoSync | boolean | Whether the device detects video sync (one flag for the whole device; HasVideoInputSync reports per input).
| 2.0.0 | |
HasVideoInputSync | boolean | Input name | Whether video sync is detected on each of the device's inputs.
| 2.18.0 |
VideoMuteIsOn | boolean | Whether the device's video output is muted.
| 2.0.0 | |
MuteIsOn | boolean | Whether the device's audio output is muted. | 2.0.0 |
Switcher
| Property | Type | Key | Description | Since |
|---|---|---|---|---|
VideoInput | string | The input currently selected on the switcher.
| 2.0.0 | |
HasVideoSync | boolean | Whether the device detects video sync (one flag for the whole device; HasVideoInputSync reports per input).
| 2.0.0 | |
HasVideoInputSync | boolean | Input name | Whether video sync is detected on each of the device's inputs.
| 2.15.1 |
MuteIsOn | boolean | Whether the switcher's audio output is muted.
| 2.0.0 | |
Volume | integer | The switcher's output volume as a percentage (0-100).
| 2.0.0 |