Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.advahini.com/llms.txt

Use this file to discover all available pages before exploring further.

The Advahini player is a browser-based application that runs on your screen device and displays the content assigned to that screen in your workspace. You navigate to the player URL in a browser on the device, and the player generates an activation code you use to pair it with your workspace. This page covers how to set up the player, what it plays, and what options are available.

How the player works

When the player starts, it registers itself as an unconnected device and displays an activation code. Once you claim the device from your Advahini workspace using that code, the player begins polling for its assigned content and starts playback. After the initial pairing, the player remembers its identity across page reloads so you do not need to re-enter the activation code. The player polls for content updates every few seconds. When your workspace assignment changes — for example, you assign a new playlist — the player picks up the change automatically at the next poll.

Supported scene types

The player can render the following scene types inside a playlist:
  • Image — Displays a single image for a configured duration.
  • Video — Plays a video file.
  • Image slideshow — Cycles through a set of images.
  • YouTube — Embeds and autoplays a YouTube video.
  • Embed — Embeds any URL in an iframe.
  • Canva — Embeds a published Canva design.

Set up the player

1

Open a browser on the screen device

On the device connected to your display (a PC, smart TV browser, tablet, or any device with a modern browser), open the browser and navigate to your Advahini player URL.
You can also launch the player from the Advahini dashboard. On the Screens page, click Launch the player in the banner at the top, or click Preview from the menu on any screen card. The player opens in a new tab.
2

Note the activation code

The player displays a short activation code on screen (for example, XD8A). This code is unique to this player session and is used to pair the device with your workspace.
3

Claim the screen in Advahini

In Advahini, go to Screens and click New Screen. Enter the activation code in the Activation code field, give the screen a name, and optionally assign a playlist or schedule. Click Connect Screen.See Connect a screen for the full pairing steps.
4

Playback begins

After the screen is claimed, the player polls your workspace and starts playing the assigned content. Zone layouts, orientation, and rotation settings configured in the screen settings are applied automatically.

Offline playback

The player saves a local snapshot of the current playlist and caches media files using the browser’s Cache API. If the device loses its internet connection, the player continues playing from the cached content. Polling switches to a slower interval while offline, and resumes normal polling when connectivity is restored.
Offline playback covers image, video, and slideshow scenes cached before the connection dropped. Scenes that require a live connection (such as YouTube embeds or Canva designs) may not play while offline.

Player options

Click the settings icon (gear icon) in the player to open the options menu. The following actions are available:
OptionWhat it does
Refresh playlistForces the player to poll your workspace immediately and apply any updates.
Clear offline cacheRemoves the locally cached playlist snapshot and media files. Use this if you want to force the player to fetch everything fresh.
Disconnect / Re-pairDisconnects the player from the current screen record and resets it to show a new activation code. The screen record in your workspace is marked offline but not deleted. Use this to re-pair the device to a different screen.

Playback controls

When you move the mouse or tap the screen, playback controls appear briefly. These controls let you:
  • Pause or resume playback.
  • Skip to the previous or next scene.
  • Enter or exit fullscreen mode.
Controls hide automatically after 3 seconds of inactivity so the display runs uninterrupted.
Clearing the offline cache means the player has no fallback content until it successfully syncs with your workspace. Only do this when you have a stable internet connection on the device.
  • Connect a screen — How to pair the player’s activation code with your workspace.
  • Zones — Configure zones and overlay widgets that the player renders.
  • Screens overview — Screen lifecycle, assignment types, and available actions.