Editing SimTX API v24/Packets/StartMonitor

{{SimTX API v24 navigation}}
{{SimTX packet v24
| name = StartMonitor
| id = 6
| hex = 0x06
| direction = c2s
| session = [[SimTX API v24/Control session|Control]]
| size = 2 + UUID length (38 bytes)
| permission = Authenticated; own transmitters only (moderators: <code>monitor.any</code>)
| reply = [[SimTX API v24/Packets/MonitorBlock|MonitorBlock]] stream, ended by [[SimTX API v24/Packets/MonitorEnd|MonitorEnd]]
| group = control
}}
'''StartMonitor''' asks the server to stream the signal of one of the account's own transmitters back to the client, so that an operator can hear what they are sending. The stream is the transmitter's complex baseband after the modulator and amplifier model, before the antenna and propagation.

== Layout ==
{| class="wikitable"
! Field !! Type !! Description
|-
| <code>packetId</code> || <code>u8</code> || Always <code>6</code>.
|-
| <code>stationUuid</code> || <code>UTF</code> || UUID of the transmitter, as listed in [[SimTX API v24/Packets/StationList|StationList]].
|}

== Rules ==
* On a control session, the transmitter must belong to the same account as the control session, on any connection. An anonymous control session cannot monitor anything.
* Authenticated control sessions require a <code>control</code> [[SimTX API v24/Game tickets|ticket]], which the account service issues only to credentials with <code>catalog.publish</code>.
* On a [[SimTX API v24/Moderation session|moderation session]], any transmitter may be monitored with <code>monitor.any</code>.
* If monitoring is not possible, the server answers with [[SimTX API v24/Packets/MonitorEnd|MonitorEnd]] and a reason.
* Not a heavy request. The stream starts with the newest samples; there is no backlog.

{{SimTX API v24 navbox}}
[[Category:SimTX API v24]]