Developer Console

User Agent Strings (Fire TV)

The HAQM Fire TV platform includes the Android WebView (android.webkit.WebView), the HAQM WebView (com.amazon.android.webkit.HAQMWebView), and the HAQM web app platform. Each has an associated user agent string.

An app or web page can read the user agent string to detect Fire TV and then provide a specific user experience. User agent strings can include the version of the host operating system, the version of the browser, and other information.

User Agent Strings

When reading the user agent string, do not rely on specific version numbers within the string that are subject to change when the software is updated. To provide a HAQM Fire TV-specific experience, test for the string "HAQMWebAppPlatform" in combination with a device model that starts with "AFT".

The following table shows the user agent strings for HAQM Fire TV:

User Agent String Example
Android WebView
(android.webkit.WebView)
Mozilla/5.0 (Linux; U; Android <android>; <locale>; <device> Build/<build>) AppleWebKit/<webkit> (KHTML, like Gecko) Version/4.0 Mobile Safari/<safari> Mozilla/5.0 (Linux; U; Android 4.2.2; en-us; AFTB Build/JDQ39) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30
HAQM WebView
(com.amazon.android.webkit.HAQMWebView)
Mozilla/5.0 (Linux; Android <android>; <device> Build/<build>) AppleWebKit/<webkit> (KHTML, like Gecko) Chrome/<chrome> Mobile Safari/<safari> Mozilla/5.0 (Linux; Android 4.2.2; AFTB Build/JDQ39) AppleWebKit/537.22 (KHTML, like Gecko) Chrome/25.0.1364.173 Mobile Safari/537.22
HAQM Web App Platform Mozilla/5.0 (Linux; Android <android>; <device> Build/<build>) AppleWebKit/<webkit> (KHTML, like Gecko) Chrome/<chrome> Mobile Safari/<safari> cordova-amazon-fireos/<amazon> HAQMWebAppPlatform/<amazon> Mozilla/5.0 (Linux; Android 4.2.2; AFTB Build/JDQ39) AppleWebKit/537.22 (KHTML, like Gecko) Chrome/25.0.1364.173 Mobile Safari/537.22 cordova-amazon-fireos/3.4.0 HAQMWebAppPlatform/3.4.0;2.0

Placeholders in User Agent Strings

The following placeholders in the user agent string are for version numbers that vary by device, for values that can be altered by the user, or for values that can change when HAQM updates the software on the device:

  • <android> indicates the Android version number, for example, 4.2.2.
  • <locale> indicates the chosen language and country or region for the phone. The value consists of the lowercase hyphenated concatenation of the two-letter ISO 639-1 language code and the two-letter ISO 3166-1 alpha-2 country code, for example, en-us.
  • <device> is the value of android.os.Build.MODEL, for example, AFTB. Test for a device that starts with "AFT" to cover all devices on the HAQM Fire TV platform.
  • <build> is the value of android.os.Build.ID, for example, JDQ39.
  • <webkit>, <chrome>, and <safari> indicate the version numbers for WebKit, Chrome, and Safari, for example, 534.30.
  • <amazon> indicates the version number of the HAQM web app platform, for example, 3.4.0.

Last updated: Oct 29, 2020