Android SDK (Core)

Android TV Support

14min
getting started with android tv support in our sdk (v4 11 0+) we’re excited to announce that starting with sdk version 4 11 0 , our sdk now fully supports android tv ! you can now provide seamless video experiences on the big screen using our sdk without any extra tweaks, as it takes care of everything automatically below is all the information you need regarding android tv compatibility, best practices, and guidance on integrating our sdk for tv applications android tv support overview since v4 11 0, our sdk automatically detects and optimizes for android tv you don’t need any special flags or additional setup, just integrate the sdk as usual, and it will work on tv devices key points automatic tv detection – no extra configuration needed during initilize our sdk leanback ui friendly – works smoothly with android tv’s leanback library remote control support – navigable via d pad (direction pad) and remote tv optimized playback – adaptive bitrate streaming (abr) works out of the box how to integrate our sdk for android tv since no extra steps are required, integrating our sdk for android tv is the same as for mobile users of our sdk may skip these steps step 1 implement our sdk in your project link step 2 implement our external player link (for details about our player visit here ) step 3 regarding our custom player interfaces details, please, visit here to enable android tv support in your project, ensure you are using version 4 11 0 or later getting started with android tv integrating your app with android tv involves a few key steps ​ declare tv support in manifest ensure your app's manifest includes the necessary intent filters and features xml \<uses feature android\ name="android software leanback" android\ required="false" /> \<uses feature android\ name="android hardware touchscreen" android\ required="false" /> specify tv launcher activity define an activity with the leanback launcher category to make your app discoverable on android tv xml \<activity android\ name=" maintvactivity" android\ label="@string/app name" android\ banner="@drawable/banner"> \<intent filter> \<action android\ name="android intent action main" /> \<category android\ name="android intent category leanback launcher" /> \</intent filter> \</activity> for more information, please visit the official documentation of android developers here best practices for android tv development while our sdk works seamlessly on tv, here are some general best practices to ensure a great tv experience optimize for remote control navigation ensure ui elements are focusable and navigable via d pad use large, visible focus states (tvs are viewed from a distance) avoid touch dependent gestures (swipes, long presses) you can visit and watch android engineer's recommendated videos what's new with tv and intro to compose compose for tv | jetpack compose tips leanback library (recommended for tv uis) android’s leanback library provides ready made tv friendly components visit there official leanback docs, here tv specific manifest declarations add these to your androidmanifest xml xml \<uses feature android\ name="android hardware touchscreen" android\ required="false" /> \<uses feature android\ name="android software leanback" android\ required="false" /> test on real tv hardware emulators can miss tv specific issues (e g , overscan, performance) always test on a physical android tv device common pitfalls & troubleshooting issue solution app ui is not navigable via remote ensure all buttons have android\ focusable="true" playback controls are not navigable via remote please contact with our support team app rejected from play store declare leanback support in manifest sample code please visit our sample code repository to check we have created an android tv module and implemented our sdk github repo open the project using android studio after building the project please select samplenwandroidtv module from the module list and rebuild your project run the your samplenwandroidtv module final thoughts with sdk v4 11 0+, android tv support is automatic —just update and go! if you run into any issues, check our android troubleshooting and faqs or reach out to our support team