• << Fire OS Developer Docs
• Overview
  • Get Started with Fire TV
  • Fire TV Development Versus Android TV Development
  • TV App Design UX Guidelines
  • Submitting Your Fire TV App to the Appstore
  • Promote Your App On Fire TV
  • Glossary
  • Amazon Fire TV FAQs
  • Smart TV FAQ
  • What's New in Fire TV Development
• Fire OS for Fire TV
  • Fire OS Overview
  • Developing for Amazon Fire TV Devices Running Fire OS 16
  • Developing for Amazon Fire TV Devices Running Fire OS 14
  • Developing for Amazon Fire TV Devices Running Fire OS 8
  • Developing for Amazon Fire TV Devices Running Fire OS 7
  • Developing for Amazon Fire TV Devices Running Fire OS 6
• Set Up Your Development Environment
  • Set Up Your Development Environment
  • Connect to Fire TV through ADB
  • Install and Run Your App
• Controllers in Android Apps
  • Remote Control Input
  • Game Controller Input
  • Controller Input with Unity
  • Identify Controllers
  • Controller Behavior Guidelines
  • Controller Image Assets
• Voice
  • Overview for Voice-enabling Your App and Content
  • Voice-enabling Transport Controls with Media Session API
  • In-App Voice Scrolling and Selection
• Multimedia
  • Managing Audio Focus
  • Testing Audio Focus
  • Dolby Integration
  • Requirements for Multimedia Apps
  • AV Synchronization in Android Applications
  • APIs for HDMI Mode Switch
  • Tunnel Mode Playback
• Automotive
  • Automotive UX Guidelines
  • Add touch to Fire TV
  • Automotive Developer Reference
• Fire TV Integration SDK
  • Get Started with the Fire TV Integration SDK
  • Developer Tools
    • Setup the Sample Fire TV App
  • Content Personalization
    • Introduction to Content Personalization
    • Data Types
      • Watch Activity
      • Watchlist
    • Data Type Reference
    • Summary Reference Table
  • Fire TV Integration SDK General Troubleshooting
  • Test Cases for Validating Integration
  • Release Notes
• Live TV Integrations
  • Linear Integration
    • Introduction to Linear Television Integration
    • TV Input Framework on Fire TV
    • Step-by-step Integration Guide
      • Linear TV Integration Guide Overview
      • Step 1: Set Up Project Dependencies
      • Step 2: Set Up TvInputService
      • Step 3: Insert Your First Channel
      • Step 4: Playback in Fire TV UI
      • Test Cases for Linear Apps
    • Live TV Resources
  • Events Integration
    • Events Integration on Fire TV
    • Test Cases for Events Apps
• How to Build an Android App for Fire TV
  • Step 1: Create a Media Streaming App
  • Step 2: Understand the Anatomy of a Leanback-Enabled Android App for Amazon Fire TV
  • Step 3: Browse the Content of a Leanback-Enabled Android App
  • Step 4: Edit the User Interface Through Presenters
  • Step 5: Provide the Details of the App Content Through the DetailsFragment
  • Step 6: Play Video Content with the PlaybackOverlayFragment
• Developer Tools and System X-ray
  • Developer Tools Menu
  • System X-Ray
  • Customizing System X-Ray
  • Network Proxy
• Development Best Practices
  • Mouse Pointers
  • Display and Layout
  • Media Players
  • HDMI Events
  • Android Menu and ActionBar widgets
  • DIAL Integration
  • Matter Casting
    • Overview of Matter Casting
    • Matter Casting Integration
    • App Attestation
  • Search
  • Notifications
  • App Installation Location
  • Advertising ID
  • Deep Linking to Featured Content from the Fire TV UI
  • Resources for International Locales
• Web Apps for Fire TV
  • Get Started with Web Apps
  • Web App Controllers
  • Customize Your App
  • User Agent Strings
  • Migrate Your Existing Web App
  • Cordova plugin for Amazon Catalog Integration
  • Web App FAQ
  • HTTP Caching
  • Protect Your Web App
  • Install and Use the Amazon Web App Tester
  • Use the Debug APK to Test Your App
  • Install and Run the Debug APK to Test Your App
  • HTML5 Hybrid Apps
  • Build and Test Your HTML5 Hybrid App
  • HTML5 Hybrid App FAQs
• React Native for Fire TV
  • Get Started with React Native (Fire TV)
  • Add TV Support to an Existing React Native Project (Fire TV)
  • Supported React Native Libraries (Fire TV)
• Accessibility
  • Assistive Technologies for Fire OS
  • Implement Accessibility in Fire OS
  • Accessibility Features
    • Implement Reading and Subscribing to AD/CC Settings
    • Implement VoiceView Accessibility Features

User Agent Strings (Fire TV)

The Amazon Fire TV platform includes the Android WebView (android.webkit.WebView), the Amazon WebView (com.amazon.android.webkit.AmazonWebView), and the Amazon 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
• Placeholders in User Agent Strings

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 an Amazon Fire TV-specific experience, test for the string "AmazonWebAppPlatform" in combination with a device model that starts with "AFT".

The following table shows the user agent strings for Amazon 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
Amazon WebView (com.amazon.android.webkit.AmazonWebView)	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
Amazon 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> AmazonWebAppPlatform/<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 AmazonWebAppPlatform/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 Amazon 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 Amazon 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 Amazon web app platform, for example, 3.4.0.

---

Last updated: Oct 29, 2020