Skip to main content
Allowlisting devices is a strategy used to segment, whitelist or block an app for specific devices, allowing the application to adjust its behavior based on the brand or model that the app is running on. This serves several purposes:
  • Enabling Titan OS devices access to the application.
  • Creating a restricted allowlist of devices permitted to run the app while blocking unauthorized brands or specific models.
  • Manually defining playback rules to serve content based on hardware capabilities (e.g., restricting UHD playback on 2K-only devices).
  • Blocking the app in specific regions (e.g., when the contract is limited to LATAM devices).
  • Displaying a “Not Available on this device” message for specific device segments.

Identifying Titan OS Devices

To whitelist devices, we recommend using the Titan SDK. The library exposes properties to validate the operating system and the specific platform (model) on which the app is running on. If your architecture requires the SDK to be imported dynamically, you can verify if a device is running Titan OS by checking the User Agent. This approach is common for cross-platform apps deployed across multiple TV brands. For more details, please refer to Detecting Titan OS and Saphi. Note: Checking the User Agent is sufficient if your whitelist allows any Titan OS-powered device to access the application.

Segmenting Device Groups

Once the SDK is imported, use the Product.platform property (Reference: Titan SDK Dictionary) to identify the specific hardware platform. Here’s an example on how you can use it:
The following table is a reference of platforms for you to use in your list. If you need more details about these devies, please refer to the Device Specifications page.

Whitelisting via User Agent

As mentioned at the first topic, whitelisting via User Agent is recommended when you want to allow any Titan OS-powered device to open your app. If that’s the case, please refer to the Detecting Titan OS and Saphi topic from the User Agents page.