• << 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

Controller Input with Unity (Fire TV)

You can use the Unity development tools to create apps and games for Amazon Fire TV devices as you would any Android device.

Although we do not provide a Unity plugin for Fire TV development, there are packages in the Unity Asset Store to enable game controller support. In particular, InControl by Gallant Games is one with which our developers have had great success. InControl is a cross-platform input manager for Unity3D that standardizes control mappings for a variety of common controllers.

You can also use the Unity input manager to configure controller input for your game. Use the following tables to map the buttons on the Amazon Fire TV remotes and game controllers with the Unity input manager buttons and axes.

• Remote Control Input
• Game Controller Input
• Controller Names

Remote Control Input

Use these values in Unity to map the buttons on both the Amazon Fire TV Remote and Voice Remote. See KeyCode for more details about Unity KeyCode values.

Some remote controllers have additional buttons — such as volume up/down, power, Netflix, Amazon Prime, and other apps. However, these buttons can't be mapped to events in third-party apps.

Button	Unity Input Manager Value	Unity KeyCode Value
Home	none (system event)	none (system event)
Back	none (not supported)	KeyCode.Escape
Menu	none (not supported)	KeyCode.Menu
Microphone (Search)	none (system event)	none (system event)
Select (D-pad Center)	joystick button 0	KeyCode.JoystickButton0
Left (D-pad)	5th Axis	KeyCode.LeftArrow
Right (D-pad)	5th Axis	KeyCode.RightArrow
Up (D-pad)	6th Axis	KeyCode.UpArrow
Down (D-pad)	6th Axis	KeyCode.DownArrow
Play/Pause	none (not supported)	none (not supported)
Rewind	none (not supported)	none (not supported)
Fast Forward	none (not supported)	none (not supported)

Game Controller Input

Use these values in Unity to map the buttons on the Amazon Fire Game Controller. See KeyCode for more details about Unity KeyCode values.

The current version of the Fire TV Game Controller has these buttons:

The previous version of the Game Controller has these buttons:

Game Controller Button	Unity Input Manager Value	Unity KeyCode Value
Home	none (system event)	none (system event)
Back	none (system event)	KeyCode.Escape
Menu	none (system event)	KeyCode.Menu
A	joystick button 0	KeyCode.JoystickButton0
B	joystick button 1	KeyCode.JoystickButton1
X	joystick button 2	KeyCode.JoystickButton2
Y	joystick button 3	KeyCode.JoystickButton3
Left (D-pad)	5th Axis	none
Right (D-pad)	5th Axis	none
Up (D-pad)	6th Axis	none
Down (D-pad)	6th Axis	none
Left Stick (Left/Right)	X Axis 1st Axis	none
Left Stick (Up/Down)	Y Axis 2nd Axis	none
Left Stick Press	joystick button 8	KeyCode.JoystickButton8
Right Stick (Left/Right)	3rd Axis	none
Right Stick (Up/Down)	4th Axis	none
Right Stick Press	joystick button 9	KeyCode.JoystickButton9
Play/Pause (1st version only)	none (not supported)	none (not supported)
Rewind (1st version only)	none (not supported)	none (not supported)
Fast Forward (1st version only)	none (not supported)	none (not supported)
Left Trigger (L2)	13th Axis	none
Left Shoulder (L1)	joystick button 4	KeyCode.LeftShift KeyCode.JoystickButton4
Right Trigger (R2)	12th Axis	none
Right Shoulder (R1)	joystick button 5	KeyCode.RightShift KeyCode.JoystickButton5

Controller Names

Controller names are available in Unity with the Input.GetJoystickNames() method. Use these values for each controller:

• Remote: "Amazon Fire TV Remote"
• Voice Remote: "Amazon Fire TV Remote"
• Game controller: "Amazon Fire Game Controller"

---

Last updated: Oct 29, 2020