Home Tutorials Players & Screens How to Set Up Players Using a Two-Way Pairing Code

How to Set Up Players Using a Two-Way Pairing Code

Sometimes the person installing a screen on site does not have an OnSign account, and sharing your login with installers is not an option. A two-way pairing code lets anyone attach a detached Player to a device without signing in to OnSign. You create the Player and its settings in advance, then hand the installer a code.

How It Works

A detached Player exists in your organization with its own name, subscription, Player Groups, and Tags, but it is not linked to any hardware device. It does not play content until a device is attached to it.

When you generate a two-way pairing code for a detached Player, OnSign creates a nine-digit code (for example, 123-456-789). The installer can enter this code in either of two places:

On the device itself, in the OnSign Player setup screen.
On the https://onsign.tv/setup page in any browser, together with the Player code shown on the device screen.

Once the code is accepted, the device is attached to the detached Player and starts running with that Player’s configuration.

Two-way pairing codes only apply to detached Players. Players that are already attached to a device are not affected.

Note: Anyone who knows the code can attach the Player to a device without logging in. Share it only with the person doing the installation, and revoke it when it is no longer needed.

First you will need a Detached Player:

Go to Players and click the Setup Player button.
Select the Create Detached Player option.

Fill in the Player Name and Subscription fields and click Add Player in the bottom-right corner.

Generate a Two-Way Pairing Code

For a single Player

Go to Players and open the detached Player.
Click Settings in the left menu.
Click the arrow next to Change Device and select Generate Two-Way Pairing Code.

A confirmation message shows the generated code, and a Pairing Code badge appears under the Player name, next to the Detached badge.

For one or more Players at once

Go to Players.
To list only detached Players, click Add filter and select Is Detached.
Select the checkbox of each Player you want to generate a code for.
Click Actions and select Manage Two-Way Pairing.

Select Generate a two-way pairing code for the selected players and click Confirm.

The codes appear in the Pairing Code column of the Players list.

View or Revoke a Code

To view the code of a single Player, open the Player, go to Settings, and click the Pairing Code badge under the Player name. The Two-Way Pairing Code window displays the code.

To revoke it, click Revoke Code in the same window.

To revoke codes for several Players at once, select them in the Players list, click Actions > Manage Two-Way Pairing, select Revoke the two-way pairing code of the selected players, and click Confirm.

Pair the Device

Option 1: On the device

Install and open OnSign Player on the device. The setup screen displays a Player code and a QR code.
Open the Enter a pairing code prompt.
Type the nine-digit two-way pairing code.

Pairing starts automatically after the last digit. The device leaves the setup screen and starts running as the Player.

Option 2: From the setup page in a browser

On the device, note the Player code shown on the setup screen (for example, 2MA XBJ).
On any computer or phone, go to https://onsign.tv/setup without signing in to OnSign. The Setup a Player page opens.
Click Use a Two-Way Pairing Code.
In Player Code, enter the code shown on the device. Spaces don’t matter.
In Two-Way Pairing Code, enter the nine-digit code.
Complete the reCAPTCHA and click Pair Player.

Note: If you are signed in to OnSign in that browser, the setup page opens the standard Setup Player with Code form instead. Sign out or use a private browser window.

Confirm the Pairing

Open Players and locate the Player. After a successful pairing, the Detached badge no longer appears and Last Seen shows Online.

Troubleshooting

Manage Two-Way Pairing does not generate a code for a Player: Two-way pairing codes only apply to detached Players. If the Player is already attached to a device, it does not receive a code.
The setup page does not show the Use a Two-Way Pairing Code option: You are signed in to OnSign in that browser, so the page shows the signed-in setup form. Sign out or open the page in a private window.
The pairing code is not accepted: The code was mistyped or has been revoked. Check the current code in the Pairing Code badge or column, and generate a new one if needed.
Pair Player fails on the setup page: Both fields are required. Player Code is the code shown on the device setup screen, not the two-way pairing code. Also confirm that the reCAPTCHA is completed.
The Player is paired but does not play content: A Player without an active subscription does not play content. Open Settings and select an active subscription in Subscription.