Explain the state of one screen.
When to use:
- Why a screen shows what it shows, why it is blank or wrong, when it was down, or what its TV did.
When NOT to use:
- A screen's settings, tags or assigned content: use get_items kind screens.
- Many screens: use get_fleet_report. A picture: use capture_screenshot. A fix: use control_screens.
What to know:
- Reads what the screen already reported and never contacts it, so it answers for offline screens. Needs screen.view.
Parameters:
- screenId: one scr_… id from list_items kind screens.
- view: why (the source on screen: deactivated, emergency, takeover, schedule or default); diagnose (likely cause plus a checklist; guided:true marks a TV/input/cable guess, not a reading); outages (each outage with length and cause); tv (TV off, other input, cable lost; Signage Sticks only).
- days: outages default 30; tv default and max 14. limit: default 50; max 200 for outages, 500 for tv. Both are ignored for why and diagnose.
- Example: {screenId:"scr_lobby7", view:"outages", days:7}.
ConnectorOAuth