Brainstorm: Proactively suggest video troubleshooting steps to the user when uStreamer fails to receive a signal

[mtlynch]

We're soon going to have an FAQ explaining to users how to troubleshoot and diagnose "No signal" screen.

It would be good if we could proactively suggest remediation steps to the user when we notice this condition, combining information from the uStreamer logs with the state of the uStreamer /state endpoint:

curl -s http://localhost:8001/state | python -m json.tool

{
    "ok": true,
    "result": {
        "encoder": {
            "quality": 80,
            "type": "OMX"
        },
        "source": {
            "captured_fps": 24,
            "desired_fps": 0,
            "online": true,
            "resolution": {
                "height": 1080,
                "width": 1920
            }
        },
        "stream": {
            "clients": 1,
            "clients_stat": {
                "1b9bd4e621b4deea": {
                    "advance_headers": true,
                    "dual_final_frames": false,
                    "extra_headers": false,
                    "fps": 1,
                    "key": "0",
                    "zero_data": false
                }
            },
            "queued_fps": 1
        }
    }
}

Open questions

• How do we notify the user?
• Do we give the user an option to silence notifications?
• How frequently do we poll?