Sent with QoS 1, retained.
Will be sent every 10 seconds if we are online, and immediately whenever the reported
camera issue changes. Because it is retained, subscribing at any time tells you the
current state of the system without waiting for the next round.
Also, on this topic we will publish the will message with status offline.
camera_status tells you whether the system can currently see the table, see
CameraStatus. Ignore it when status is offline: the will message is prepared when we
start up, so it does not carry a meaningful camera status.
issue
null while the camera is fine. Only the most severe issue is reported.
seconds_since_last_frame
Seconds since the last frame arrived from the camera. Around 0 in normal operation.
table_coverage
Which fraction of the camera image the table takes up, between 0 and 1.
table_scale
Camera pixels per pixel of the image we run the detection on. Below 1 means the camera is
too far away from the table to resolve it fully and we have to upscale.
table_coverage and table_scale are 0 when there is no frame or no calibrated camera
position.
kind
The machine readable issue, see CameraIssueKind.
message
The same issue as a sentence, meant to be shown to an operator. Unstable, don't parse it.
since
When the issue first appeared. Issues are reported as soon as they appear, including short
lived ones such as a stream that stalls for a second. Use since to alert only on issues
that persist.
The camera issues we report, most severe first.
NO_FRAMES
The camera delivers no frames at all. Usually it is not connected.
NOT_YET_CALIBRATED
The system has no table calibration (or no configured player positions) yet, so there is
nothing to judge the camera against. This is also reported while an operator is running the
calibration procedure.
CAMERA_MOVED
Configured table positions (the initial card and the main bet spot of a player) are outside
of the camera image. The camera has to be moved back, or the table has to be recalibrated.
LAYOUT_NOT_VISIBLE
We cannot recognize the table layout in the camera image and fall back to the calibrated
camera position. Usually the layout is covered, unlit, or the camera points somewhere else.
Only reported when the automatic homography is enabled: with it turned off, the calibrated
camera position is what the system is meant to run on.