Digital Signage — User Guide

This is the digital-signage system for your venue. You upload media, group it into a playlist that loops, and assign that playlist to a screen (a TV). The TV plays it through the VionOS TV Player app. Cameras/audio can also interrupt a screen with live, context-aware content (the part a normal CMS can't do).

The three things you work with: Media (files) → Playlists (ordered loops) → Screens (TVs).

On the Media tab: pick a Category, click + Upload media, and choose images, videos, or HTML files. They're stored permanently in the cloud (S3).

• View — preview the file in a new tab.
• Delete — removes the file from the library and storage (hard delete).

Media never expires — the player fetches a fresh link each time it loads.

On the Playlists tab, build a loop: click media tiles to add them, drag the arrows to reorder, set how many seconds each shows, name it, and Create playlist.

To change an existing playlist, click Edit (or its name). Items play top-to-bottom and then loop. The "▶ On:" line shows which screens currently use it.

Each playlist has an Assign to screen dropdown — pick a screen and it starts playing there. A screen plays one playlist at a time; assigning a new one replaces it. The "▶ On:" line confirms the assignment.

A screen is a display you added (in the Digital Twin with + Display, or here). Each has a player route behind the scenes: /display/<screen>. Customers should not type that on a TV. Open the VionOS TV Player app and pair the code it shows. Visit /display for support controls and browser fallback links.

1. Install and open the VionOS TV Player on the TV or Android TV stick.
2. The app automatically opens the player and shows a 6-character code.
3. Here on Content → Playlists → "Pair a screen", enter the code → it binds.
4. Assign a playlist — it starts playing within seconds.

No hardware? Test it with the browser fallback link from Screens.

Android TV / Google TV: install the VionOS TV Player app and pair the code. Older TV: plug in an Android TV stick / Chromecast / mini-PC and run the app there. In the Digital Twin you can model the stick as a + Player linked to the + Display ("Drives display"). Browser URLs are support fallbacks.

Beyond a fixed loop, a screen can react to what's happening: a camera or microphone event (occupancy, a queue, an audio intent) can interrupt the playlist with relevant content, then resume. This is configured with the cameras/zones and is what makes our signage context-aware.

The player auto-refreshes: edit a playlist or reassign it and screens pick it up within ~30s, no reload. It also caches content, so a brief network drop won't black out the screen — it keeps playing the last loop and recovers automatically.

If a TV is slow to update, open Screensand click Refresh TV. If the venue uses an owner code, the browser asks once and remembers it.

The Default Content Library (our native web player) needs no external CMS. If you already run Rise Vision, Samsung VXT, or Amazon Signage, those appear as providers to connect (coming soon) — you can mix them with our AI-triggered screens.

Each open player heartbeats every ~30s, so the Digital Twin and Edge Fleet show it as online when it's actually playing, or offlinewhen it isn't. Use this to tell, at a glance, which screens are live:

• online — heartbeat within the last ~90s (it's playing now).
• degraded — heartbeat went stale (recently dropped — check it).
• offline — no heartbeat for minutes (TV off, tab closed, or no network).
• unknown — never reported (newly added; open its URL once).

Select a device in the twin to see why (e.g. "last seen 8s ago" / "no heartbeat for 6m").

• Shows "offline" in the twin but it's playing → the player tab must stay open on the TV; if it's open and online elsewhere, the TV lost network — reconnect it. Status updates within ~90s.
• Stuck on "Connecting…" → the screen handle is wrong or the service is down. Relaunch the TV app; if it still fails, use Screens to open the browser fallback and check the display service.
• "Cannot reach the display service" → network/API issue; it auto-retries. Cached content keeps playing meanwhile.
• "No playlist assigned" → assign one (step 3) — from /display or here.
• Screen shows a code → it's unpaired; pair it (step 5).
• "Screen not found" → wrong handle or service unreachable; pick it from /display.
• Content didn't update → edits auto-apply within ~30s; if not, open Screens and click Refresh TV.
• "TV controls are not live on this server yet" → the console is newer than the API; deploy the backend update, then retry.
• Screen went black after a network blip → it caches and recovers; if it persists, reconnect the network and reload.
• Wrong content showing → check the assigned playlist (and any schedule, once enabled).
• Pairing code rejected → codes expire after 15 min; reload the player for a fresh one.
• Media not visible → check you're on the right Category in the Media tab.
• Edit shows blank items → older playlists are auto-upgraded; re-save to refresh.