Skip to main content
Skip table of contents

Device limits

Overview

OpenTV Platform allows you to define limits for:

  • Number of devices per account:

    • The total number of devices per account

    • The number of devices in each defined device group (for example, one limit for mobile devices and another for large-screen devices such as smart TVs)

  • Number of concurrent streaming sessions:

    • The total number of concurrent streaming sessions for the account

    • The number of streaming sessions for each defined device group

  • Number of approved devices per account:

    • The number of approved devices per account
      (A device that is registered to an account can either be approved or not approved.)

    • How often a change can be made to an account's approved devices list (that is, to add or remove a device from the list)

These limits are defined in the following places:

  • Total devices, total concurrent sessions, and approved device limits are defined in an account profile, which means you can have different limits for different groups of users.
    See Account profiles for details of setting these limits in OpCon and Accounts for details of applying account profiles to accounts.

  • Device group limits and device group session limits are defined globally and apply to all accounts.
    See Device Management for details of setting these limits in OpCon.

Approved device limits are disabled by default. To enable them, contact your NAGRAVISION representative.

Use cases

Device and device group limits

When a device signs on for the first time, if adding it to the account would exceed one of the device limits (total devices of devices in a device group), sign-on will fail. See Authentication.

Concurrent session limits

When a device attempts to set up an OTT session prior to attempting playback, if the new session would exceed the concurrent session limit, the session setup request will fail. See Secure Session Management and Secure Session Manager (API documentation) in the SSP documentation.

Approved device limits

The client application is responsible for the following use cases related to approved device limits:

The Scenarios section, below, explains how the different limits interact.

Both approved and unapproved devices count towards an account’s device limit (except for devices that belong to a device group whose device group limit has Ignore Device Limit enabled – see Setting device group limits for a device profile).

Note that if the client uses the /ias/v3/token/actions/signOnByUserNamePassword endpoint to sign on, this will automatically add the device to the account's approved devices list on first signon only if:

  • The list is not already full, 

  • The device is not already on the list, and

  • The limit on the number of changes allowed to the approved devices list would not be exceeded by adding the device.

In other signon scenarios, the client should check its approved status after signing in.

Scenarios

There are other devices statuses that, combined with a device's approval status, determine what the device can and cannot do. These are summarised in the following table:

Status (set by operator)

Activation status

Approved status

Client can sign in?
(required to browse content)

Client can request content authorisation?
(required to play out content)

Contributes to device limits

ENABLED

ACTIVE

TRUE

FALSE

Approval not enabled

ALLOWED

ALLOWED

ALLOWED

ALLOWED

BLOCKED

ALLOWED

YES (excludes MANAGED devices)

DISABLED

TRUE

FALSE

Approval not enabled

BLOCKED

BLOCKED

BLOCKED

N/A

N/A

N/A

NO

ENABLED

INACTIVE

TRUE

FALSE

Approval not enabled

BLOCKED

BLOCKED

BLOCKED

N/A

N/A

N/A

NO

DISABLED

TRUE

FALSE

Feature Off

BLOCKED

BLOCKED

BLOCKED

N/A

N/A

N/A

NO

See also

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.