DiscoveredTransportConnectedHelloExchangedAuthenticatedRegisteredSceneSyncedActiveClosed
- Client discovers
_motionstage._udp.localservice. - Client opens QUIC transport.
- Server sends
ServerHello. - Client sends
ClientHello. - Client sends
RegisterRequest. - Server returns
RegisterAcceptedwith a newsession_idorRegisterRejected. - Session syncs scene state and enters
Active.
Control and motion payloads are sent in versioned wire envelopes (protocol_major, protocol_minor) so minor-version gates are enforced at transport decode time.
VideoSignal(SignalMessage)routes SDP/ICE between active devices or to the server-owned WebRTC peer.DrainSignalsrequests queued signaling messages for the active device.SignalsBatch(Vec<SignalMessage>)returns the drained queue payload.CreateVideoOffer { stream_id, track_id }asks the server to create an SDP offer for the requesting device.VideoOffer(SdpMessage)returns an SDP offer/answer generated by server-side WebRTC state.ResetSceneToBaseline { scene_id }resets scene attributecurrent_valuefields todefault_value.CommitSceneBaseline { scene_id }copies scene attributecurrent_valueintodefault_value.CommitObjectBaseline { scene_id, object_id }copies one object's attributecurrent_valueintodefault_value.BaselineActionApplied { action, changed_attributes }acknowledges baseline actions with deterministic change counts.Error { code, reason }provides explicit protocol-level errors instead of silently ignoring unsupported messages.
- Motion-source clients advertise output attributes during
ClientHello. - Motion samples are only accepted for explicitly registered mappings.
- Mapping modifications are denied in
Recordingmode. - Lease and heartbeat policy govern reclaim behavior when a device disconnects.
- Relative composition is server-authoritative for transform-capable targets:
- scalar/vec:
output = baseline + delta quatf:output = normalize(baseline * delta)mat4f:output = baseline * delta
- scalar/vec:
- Non-composable types retain absolute assignment behavior.
- Reset/commit baseline actions are explicit control operations and are never coupled to mode transitions.
component_masktransforms are applied before filter chains:- scalar -> vector component(s)
- vector component -> scalar
- vector subset copy -> vector target
- DCC/camera is authoritative for stream descriptor (
width,height,fps). - HDR profile in v1:
HDR10(BT.2020,PQ, 10-bit). - Non-HDR subscribers receive on-demand SDR tone-mapped stream.
- WebRTC media sessions are server-owned peers; SDP/ICE signaling is exchanged over QUIC control integration paths.
CMTRK2is the canonical format and includes marker events (ModeTransition, mapping graph markers) plus frame data.CMTRK1remains readable for backward compatibility.